Czas lokalny

Mimo że system używa czasu utc wewnętrznie, aplikacje będą zwykle wyświetlać czasu lokalnego, czyli datę i godzinę dnia dla strefy czasowej. W związku z tym, aby zapewnić poprawne wyniki, należy pamiętać, czy funkcja oczekuje otrzymania czasu UTC, czy czasu lokalnego oraz czy funkcja zwraca czas utc, czy czas lokalny.

Bieżące ustawienia strefy czasowej kontrolują sposób konwertowania systemu między czasem UTC a czasem lokalnym. Bieżące ustawienia strefy czasowej można pobrać przy użyciu funkcji GetTimeZoneInformation. Funkcja kopiuje wynik do struktury TIME_ZONE_INFORMATION i zwraca wartość wskazującą, czy czas lokalny jest obecnie w czasie standardowym, czy czas letni (DST). Ustawienia strefy czasowej można ustawić przy użyciu funkcji SetTimeZoneInformation. Aby obsłużyć granice czasu letniego zmieniającego się od roku do roku, użyj funkcji GetTimeZoneInformationForYear, GetDynamicTimeZoneInformation i SetDynamicTimeZoneInformation.

Aby pobrać czas lokalny, użyj funkcji GetLocalTime. GetLocalTime konwertuje czas systemowy na czas lokalny na podstawie bieżących ustawień strefy czasowej i kopiuje wynik do struktury SYSTEMTIME. Czas systemowy można ustawić za pomocą funkcji SetLocalTime. SetLocalTime zakłada, że określono czas lokalny i konwertuje na UTC przed ustawieniem czasu systemowego.

Podczas wywoływania SetLocalTimesystem używa bieżących informacji o strefie czasowej, w tym ustawienia czasu letniego, w celu przeprowadzenia konwersji. Należy pamiętać, że system używa ustawienia czasu letniego bieżącego czasu, a nie nowego ustawienia. W związku z tym, aby zapewnić prawidłowy wynik, wywołaj SetLocalTime po raz drugi, teraz, gdy pierwsze wywołanie zaktualizowało ustawienie czasu letniego.

Aby przekonwertować czas utc na czas lokalny, użyj funkcji SystemTimeToTzSpecificLocalTime. Aby przekonwertować czas lokalny na czas utc, użyj funkcji TzSpecificLocalTimeToSystemTime.