Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Converts the specified local time to the corresponding time in Coordinated Universal Time (UTC).
Syntax
BOOL TzSpecificLocalTimeToSystemTime(
[in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
[in] const SYSTEMTIME *lpLocalTime,
[out] LPSYSTEMTIME lpUniversalTime
);
Parameters
[in, optional] lpTimeZoneInformation
A pointer to a TIME_ZONE_INFORMATION structure that specifies the time zone for the time specified in lpLocalTime.
If lpTimeZoneInformation is NULL, the function uses the currently active time zone.
[in] lpLocalTime
A pointer to a SYSTEMTIME structure that specifies the local time to be converted. The function converts this time to the corresponding UTC time.
[out] lpUniversalTime
A pointer to a SYSTEMTIME structure that receives the UTC time.
Return value
If the function succeeds, the return value is nonzero, and the function sets the members of the SYSTEMTIME structure pointed to by lpUniversalTime to the appropriate values.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
Remarks
TzSpecificLocalTimeToSystemTime takes into account whether daylight saving time (DST) is in effect for the local time to be converted.
Important
The following local times, near DST transitions, can be ambiguous or invalid and might result in unexpected behavior (as there is no guaranteed "correct" result).
- During the transition from daylight saving time to standard time, the local clock repeats. A local time within the repeated window is ambiguous because it occurs twice, once in daylight saving time and once in standard time.
- During the transition from standard time to daylight saving time, the local clock jumps forward. A local time within the skipped window is invalid because it does not have a valid UTC conversion.
If the specified local time is either ambiguous or invalid, the function treats it as daylight saving time and applies the daylight saving time bias. Applications requiring continuity or precision should avoid this function and use UTC time instead.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2003 [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | timezoneapi.h (include Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |