TimeZone.ToLocalTime(DateTime) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert de lokale tijd die overeenkomt met een opgegeven datum- en tijdwaarde.
public:
virtual DateTime ToLocalTime(DateTime time);public virtual DateTime ToLocalTime(DateTime time);abstract member ToLocalTime : DateTime -> DateTime
override this.ToLocalTime : DateTime -> DateTimePublic Overridable Function ToLocalTime (time As DateTime) As DateTimeParameters
- time
- DateTime
Een UTC-tijd (Coordinated Universal Time).
Retouren
Een DateTime object waarvan de waarde de lokale tijd is die overeenkomt met time.
Opmerkingen
In de volgende tabel ziet u de relatie tussen de time parameter en de DateTime waarde die door deze methode wordt geretourneerd.
time-parameter |
Gedrag | Retourwaarde |
|---|---|---|
| Een UTC-tijdDateTimeKind.Utc (Coordinated Universal Time). | Converteert de tijd van UTC naar de lokale tijd. | Een DateTime object waarvan de waarde de lokale tijd is die overeenkomt met time. |
| Een lokale tijd (DateTimeKind.Local). | Geen conversie nodig. | Dezelfde DateTime waarde die wordt vertegenwoordigd door de time parameter. |
| Een niet-opgegeven tijd (DateTimeKind.Unspecified). | Hiermee wordt ervan uitgegaan dat de tijd UTC is en converteert van UTC naar de lokale tijd. | Een DateTime object waarvan de waarde de lokale tijd is die overeenkomt met time. |
Als de lokale tijdzone zomertijd observeert, ToLocalTime past u de huidige aanpassingsregel time toe op bij het uitvoeren van de conversie.
Note
De ToLocalTime methode herkent alleen de huidige regel voor zomertijdaanpassing voor de lokale tijdzone. Hierdoor wordt gegarandeerd dat de lokale tijd die overeenkomt met een bepaalde UTC-tijd alleen wordt geretourneerd tijdens de periode waarin de laatste aanpassingsregel van kracht is. Het kan onnauwkeurige resultaten retourneren als time dit een historische datum- en tijdwaarde is die is onderworpen aan een eerdere aanpassingsregel.
De ToLocalTime methode komt overeen met de methode met TimeZoneInfo.ConvertTimeFromUtc de destinationTimeZone parameter die is ingesteld op TimeZoneInfo.Local. Gebruik waar mogelijk de TimeZoneInfo.ConvertTimeFromUtc methode.
Notities voor overnemers
Hoewel dit niet vereist is, moeten afgeleide klassen in de meeste gevallen de standaard implementatie van deze methode overschrijven. Het gedrag van de standaard implementatie is afhankelijk van de Kind eigenschap van de time parameter. Als de waarde is Local, retourneert time deze methode ongewijzigd. Als de waarde een van Utc beide is of Unspecified, wordt ervan uitgegaan dat time deze UTC is en converteert deze naar de lokale systeemtijd zonder de methode aan te GetUtcOffset(DateTime) roepen.
