TimeZone.ToUniversalTime(DateTime) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Returnerar UTC (Coordinated Universal Time) som motsvarar en angiven tid.
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 DateTimeParametrar
- time
- DateTime
Ett datum och en tid.
Returer
Ett DateTime objekt vars värde är den koordinerade universella tiden (UTC) som motsvarar time.
Kommentarer
Om den lokala tidszonen observerar sommartid ToUniversalTime tillämpar den aktuella justeringsregeln på parametern time när konverteringen utförs.
Note
Metoden ToUniversalTime identifierar endast den aktuella justeringsregeln för sommartid för den lokala tidszonen. Därför är det garanterat att korrekt returnera den koordinerade universella tiden (UTC) som motsvarar en viss lokal tid endast under den period då den senaste justeringsregeln gäller. Det kan returnera felaktiga resultat om time är ett historiskt datum- och tidsvärde som var föremål för en tidigare justeringsregel.
Om parametern time är en tvetydig tid förutsätter metoden att det är en standardtid. (En tvetydig tid är en tid som kan mappas antingen till en standardtid eller till en sommartid i den lokala tidszonen.) Om time är en ogiltig tid subtraherar metoden helt enkelt den lokala tiden från den lokala tidszonens UTC-förskjutning för att returnera UTC. (En ogiltig tid är en tid som inte finns på grund av tillämpningen av regler för sommartidsjustering.)
Eftersom time tolkas i förhållande till den aktuella tidszonen i det aktuella systemet kan datum och tid som returneras av den här metoden skilja sig åt om ett program körs på olika datorer eller på samma dator med olika tidszoner. För fall där ett datum- och tidsvärde måste representera en enda, entydig tidpunkt använder du ett DateTimeOffset värde för att representera den lokala tiden.
Metoden ToUniversalTime motsvarar metodens TimeZoneInfo.ConvertTimeToUtc(DateTime) överlagring med en DateTime parameter vars Kind egenskap inte är lika DateTimeKind.Utcmed . Använd metodens överlagring när det TimeZoneInfo.ConvertTimeToUtc(DateTime) är möjligt.
