Lokale tijd

Hoewel het systeem intern op UTC gebaseerde tijd gebruikt, worden in uw toepassingen meestal de lokale tijd weergegeven, de datum en tijd van de dag voor uw tijdzone. Om ervoor te zorgen dat de resultaten juist zijn, moet u er daarom rekening mee houden of een functie een utc-tijd of een lokale tijd verwacht te ontvangen en of de functie een utc-tijd of een lokale tijd retourneert.

De huidige tijdzone-instellingen bepalen hoe het systeem wordt geconverteerd tussen UTC en lokale tijd. U kunt de huidige tijdzone-instellingen ophalen met behulp van de functie GetTimeZoneInformation. De functie kopieert het resultaat naar een TIME_ZONE_INFORMATION structuur en retourneert een waarde die aangeeft of lokale tijd zich momenteel in de standaardtijd of zomertijd (DST) bevindt. U kunt de tijdzone-instellingen instellen met behulp van de functie SetTimeZoneInformation. Gebruik de functies GetTimeZoneInformationForYear, GetDynamicTimeZoneInformation en SetDynamicTimeZoneInformation om grenzen te ondersteunen voor zomertijd die van jaar tot jaar verandert.

Gebruik de functie GetLocalTime om de lokale tijd op te halen. GetLocalTime- converteert de systeemtijd naar een lokale tijd op basis van de huidige tijdzone-instellingen en kopieert het resultaat naar een SYSTEMTIME structuur. U kunt de systeemtijd instellen met behulp van de functie SetLocalTime. SetLocalTime ervan uit dat u een lokale tijd hebt opgegeven en converteert naar UTC voordat u de systeemtijd instelt.

Wanneer u SetLocalTimeaanroept, gebruikt het systeem de huidige tijdzonegegevens, inclusief de zomertijdinstelling, om de conversie uit te voeren. Houd er rekening mee dat het systeem de instelling zomertijd van de huidige tijd gebruikt, niet de nieuwe tijd die u instelt. Om ervoor te zorgen dat het juiste resultaat, roept u SetLocalTime een tweede keer aan, nu de eerste oproep de instelling zomertijd heeft bijgewerkt.

Als u een op UTC gebaseerde tijd wilt converteren naar een lokale tijd, gebruikt u de functie SystemTimeToTzSpecificLocalTime. Als u een lokale tijd wilt converteren naar een op UTC gebaseerde tijd, gebruikt u de functie TzSpecificLocalTimeToSystemTimeTime.