TimeZone.ToUniversalTime(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 Coordinated Universal Time (UTC) die overeenkomt met een opgegeven tijd.
public:
virtual DateTime ToUniversalTime(DateTime time);public virtual DateTime ToUniversalTime(DateTime time);abstract member ToUniversalTime : DateTime -> DateTime
override this.ToUniversalTime : DateTime -> DateTimePublic Overridable Function ToUniversalTime (time As DateTime) As DateTimeParameters
- time
- DateTime
Een datum en tijd.
Retouren
Een DateTime object waarvan de waarde de Coordinated Universal Time (UTC) is die overeenkomt met time.
Opmerkingen
Als in de lokale tijdzone zomertijd wordt waargenomen, ToUniversalTime past u de huidige aanpassingsregel toe op de time parameter bij het uitvoeren van de conversie.
Note
De ToUniversalTime methode herkent alleen de huidige regel voor zomertijdaanpassing voor de lokale tijdzone. Als gevolg hiervan wordt gegarandeerd dat de Coordinated Universal Time (UTC) die overeenkomt met een bepaalde lokale 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.
Als de time parameter een dubbelzinnige tijd is, wordt ervan uitgegaan dat deze een standaardtijd is. (Een dubbelzinnige tijd is een tijd die kan worden toegewezen aan een standaardtijd of aan een zomertijd in de lokale tijdzone.) Als time dit een ongeldige tijd is, trekt de methode de lokale tijd af van de UTC-offset van de lokale tijdzone om UTC te retourneren. (Een ongeldige tijd is een tijd die niet bestaat vanwege de toepassing van zomertijdaanpassingsregels.)
Omdat time deze wordt geïnterpreteerd in relatie tot de huidige tijdzone op het huidige systeem, kan de datum en tijd die door deze methode worden geretourneerd, verschillen als een toepassing wordt uitgevoerd op verschillende computers of op dezelfde computer met verschillende tijdzones. Voor gevallen waarin een datum- en tijdwaarde één eenduidig tijdstip moet vertegenwoordigen, gebruikt u een DateTimeOffset waarde om de lokale tijd weer te geven.
De ToUniversalTime methode komt overeen met de overbelasting van de TimeZoneInfo.ConvertTimeToUtc(DateTime) methode met een DateTime parameter waarvan Kind de eigenschap niet gelijk is DateTimeKind.Utcaan . Gebruik waar mogelijk de overbelasting van de TimeZoneInfo.ConvertTimeToUtc(DateTime) methode.
