TimeZone.GetUtcOffset(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-förskjutningen (Coordinated Universal Time) för den angivna lokala tiden.
public:
abstract TimeSpan GetUtcOffset(DateTime time);public abstract TimeSpan GetUtcOffset(DateTime time);abstract member GetUtcOffset : DateTime -> TimeSpanPublic MustOverride Function GetUtcOffset (time As DateTime) As TimeSpanParametrar
- time
- DateTime
Ett datum- och tidsvärde.
Returer
UtC-förskjutningen (Coordinated Universal Time) från time.
Kommentarer
Den här metoden returnerar förskjutningen, eller skillnaden, mellan parametern time och Coordinated Universal Time (UTC). Det är:
time = UTC + offset
Metoden tolkar tidszonen time baserat på dess Kind egenskap. Om värdet för Kind egenskapen är DateTimeKind.Local eller DateTimeKind.Unspecifiedreturnerar metoden förskjutningen för den lokala tidszonen. Om värdet för Kind egenskapen är DateTimeKind.Utcreturnerar metoden en förskjutning som är TimeSpan.Zerolika med .
Om den lokala tidszonen observerar sommartid GetUtcOffset tillämpar den aktuella justeringsregeln på time när du fastställer förskjutningen för den lokala tidszonen. Det innebär att förskjutningen som returneras av GetUtcOffset återspeglar om time den infaller i tidszonens standardtid eller dess sommartid.
Note
Metoden GetUtcOffset identifierar endast den aktuella justeringsregeln för sommartid för den lokala tidszonen. Därför är det garanterat att utc-förskjutningen av en lokal tid returneras korrekt 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.
Metoden GetUtcOffset motsvarar TimeZoneInfo.GetUtcOffset metoden. Använd metoden när det TimeZoneInfo.GetUtcOffset är möjligt.
Eftersom datum- och tidsvärdet som representeras av time och det här värdets förskjutning från UTC inte är nära kopplat, kan ett lokalt eller ospecificerat datum- och tidsvärde returnera ett annat förskjutningsvärde när det körs på olika datorer eller när det körs på samma dator under olika tidszoner. Om det här beteendet inte är önskvärt använder du ett DateTimeOffset värde i stället. Datatypen DateTimeOffset kopplar samman ett datum- och tidsvärde med förskjutningen från UTC.