diff --git a/sdk-api-src/content/timezoneapi/nf-timezoneapi-tzspecificlocaltimetosystemtime.md b/sdk-api-src/content/timezoneapi/nf-timezoneapi-tzspecificlocaltimetosystemtime.md index 0d4997f35154..664e0782310c 100644 --- a/sdk-api-src/content/timezoneapi/nf-timezoneapi-tzspecificlocaltimetosystemtime.md +++ b/sdk-api-src/content/timezoneapi/nf-timezoneapi-tzspecificlocaltimetosystemtime.md @@ -88,6 +88,13 @@ If the function fails, the return value is zero. To get extended error informati TzSpecificLocalTimeToSystemTime takes into account whether daylight saving time (DST) is in effect for the local time to be converted. +> [!IMPORTANT] +> Certain local times near DST transitions may be ambiguous or invalid. Specifying such a time can result in unexpected behavior as there is no guaranteed "correct" result. +> - During the transition from daylight time to standard time, the local clock repeats. A local time within the repeated window is ambiguous because it occurs twice, once in daylight time and once in standard time. +> - During the transition from standard time to daylight time, the local clock jumps forward. A local time within the skipped window does not have a valid UTC conversion. +> +> Applications requiring continuity or precision should avoid relying on this function and look to use UTC time directly instead. + ## -see-also GetSystemTime @@ -114,4 +121,4 @@ If the function fails, the return value is zero. To get extended error informati -Time Functions \ No newline at end of file +Time Functions diff --git a/sdk-api-src/content/timezoneapi/nf-timezoneapi-tzspecificlocaltimetosystemtimeex.md b/sdk-api-src/content/timezoneapi/nf-timezoneapi-tzspecificlocaltimetosystemtimeex.md index 7f4a7120b2ad..3c6750ee9a03 100644 --- a/sdk-api-src/content/timezoneapi/nf-timezoneapi-tzspecificlocaltimetosystemtimeex.md +++ b/sdk-api-src/content/timezoneapi/nf-timezoneapi-tzspecificlocaltimetosystemtimeex.md @@ -74,4 +74,15 @@ A pointer to a ## -returns If the function fails, the return value is zero. To get extended error information, call -GetLastError. \ No newline at end of file +GetLastError. + +## -remarks + +TzSpecificLocalTimeToSystemTimeEx takes into account whether daylight saving time (DST) is in effect for the local time to be converted. + +> [!IMPORTANT] +> Certain local times near DST transitions may be ambiguous or invalid. Specifying such a time can result in unexpected behavior as there is no guaranteed "correct" result. +> - During the transition from daylight time to standard time, the local clock repeats. A local time within the repeated window is ambiguous because it occurs twice, once in daylight time and once in standard time. +> - During the transition from standard time to daylight time, the local clock jumps forward. A local time within the skipped window does not have a valid UTC conversion. +> +> Applications requiring continuity or precision should avoid relying on this function and look to use UTC time directly instead.