TimeZoneInfo Klasa

Definicja

Przestrzeń nazw:

System

Zestawy:

netstandard.dll, System.Runtime.dll

Źródło:

TimeZoneInfo.cs

Reprezentuje dowolną strefę czasową na świecie.

public ref class TimeZoneInfo sealed : IEquatable<TimeZoneInfo ^>, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

type TimeZoneInfo = class
    interface IEquatable<TimeZoneInfo>
    interface IDeserializationCallback
    interface ISerializable

Public NotInheritable Class TimeZoneInfo
Implements IDeserializationCallback, IEquatable(Of TimeZoneInfo), ISerializable

Dziedziczenie

Object

TimeZoneInfo

Implementuje

IEquatable<TimeZoneInfo> IDeserializationCallback ISerializable

Uwagi

Strefa czasowa to region geograficzny, w którym jest używany ten sam czas.

Klasa TimeZoneInfo oferuje znaczące ulepszenia TimeZone w klasie, co zapewnia tylko ograniczoną funkcjonalność.

Klasa TimeZone rozpoznaje tylko lokalną strefę czasową i może konwertować czasy między uniwersalnym czasem koordynowanym (UTC) i czasem lokalnym. TimeZoneInfo Obiekt może reprezentować dowolną strefę czasową, a metody TimeZoneInfo klasy mogą służyć do konwertowania czasu w jednej strefie czasowej na odpowiedni czas w dowolnej innej strefie czasowej. Elementy członkowskie TimeZoneInfo klasy obsługują następujące operacje:

• Pobieranie strefy czasowej, która jest już zdefiniowana przez system operacyjny.

• Wyliczanie stref czasowych dostępnych w systemie.

• Konwertowanie czasów między różnymi strefami czasowymi.

• Tworzenie nowej strefy czasowej, która nie jest jeszcze zdefiniowana przez system operacyjny.

• Serializowanie strefy czasowej na potrzeby późniejszego pobierania.

Uwaga / Notatka

Wystąpienie TimeZoneInfo klasy jest niezmienne. Po utworzeniu wystąpienia obiektu nie można modyfikować jego wartości.

Nie można utworzyć wystąpienia TimeZoneInfo obiektu przy użyciu słowa kluczowego new . Zamiast tego należy wywołać jedną ze statycznych składowych TimeZoneInfo klasy pokazanej w poniższej tabeli.

Nazwa statycznego elementu członkowskiego	Opis
Metoda CreateCustomTimeZone	Tworzy niestandardową strefę czasową na podstawie danych dostarczonych przez aplikację.
Metoda FindSystemTimeZoneById	Tworzy wystąpienie strefy czasowej na podstawie jego identyfikatora.
Metoda FromSerializedString	Deserializuje wartość ciągu, aby ponownie utworzyć wcześniej serializowany TimeZoneInfo obiekt.
Metoda GetSystemTimeZones	Zwraca wyliczenie ReadOnlyCollection<T>TimeZoneInfo obiektów reprezentujących wszystkie strefy czasowe, które są dostępne w systemie lokalnym.
Local własność	Tworzy wystąpienie obiektu reprezentującego lokalną strefę TimeZoneInfo czasową.
Utc własność	Tworzy wystąpienie obiektu reprezentującego strefę TimeZoneInfo UTC.

Można użyć CreateCustomTimeZone metody , aby utworzyć strefę czasową, która nie jest zdefiniowana w rejestrze systemu lokalnego w systemach Windows lub przez dane strefy czasowej biblioteki ICU w systemie Linux lub macOS. Następnie można użyć ToSerializedString() właściwości , aby zapisać informacje obiektu strefy czasowej jako ciąg, który może być przechowywany w jakiejś formie, która jest dostępna dla aplikacji. Za pomocą FromSerializedString metody można przekonwertować serializowany ciąg z powrotem na TimeZoneInfo obiekt.

Właściwości

Nazwa	Opis
BaseUtcOffset	Pobiera różnicę czasu między czasem standardowym bieżącej strefy czasowej a uniwersalnym czasem koordynowanym (UTC).
DaylightName	Pobiera nazwę wyświetlaną bieżącej strefy czasowej (czas letni).
DisplayName	Pobiera ogólną nazwę wyświetlaną reprezentującą strefę czasową.
HasIanaId	Zwraca wartość true , jeśli ten obiekt TimeZoneInfo ma identyfikator IANA.
Id	Pobiera identyfikator strefy czasowej.
Local	Pobiera obiekt reprezentujący lokalną strefę TimeZoneInfo czasową.
StandardName	Pobiera nazwę wyświetlaną dla czasu standardowego strefy czasowej.
SupportsDaylightSavingTime	Pobiera wartość wskazującą, czy strefa czasowa ma jakiekolwiek reguły czasu letniego.
Utc	Pobiera obiekt reprezentujący strefę TimeZoneInfo uniwersalnego czasu koordynowanego (UTC).

Metody

Nazwa	Opis
ClearCachedData()	Czyści buforowane dane strefy czasowej.
ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)	Konwertuje czas z jednej strefy czasowej na inną.
ConvertTime(DateTime, TimeZoneInfo)	Konwertuje czas na godzinę w określonej strefie czasowej.
ConvertTime(DateTimeOffset, TimeZoneInfo)	Konwertuje czas na godzinę w określonej strefie czasowej.
ConvertTimeBySystemTimeZoneId(DateTime, String, String)	Konwertuje czas z jednej strefy czasowej na inną na podstawie identyfikatorów stref czasowych.
ConvertTimeBySystemTimeZoneId(DateTime, String)	Konwertuje czas na godzinę w innej strefie czasowej na podstawie identyfikatora strefy czasowej.
ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)	Konwertuje czas na godzinę w innej strefie czasowej na podstawie identyfikatora strefy czasowej.
ConvertTimeFromUtc(DateTime, TimeZoneInfo)	Konwertuje uniwersalny czas koordynowany (UTC) na godzinę w określonej strefie czasowej.
ConvertTimeToUtc(DateTime, TimeZoneInfo)	Konwertuje czas w określonej strefie czasowej na uniwersalny czas koordynowany (UTC).
ConvertTimeToUtc(DateTime)	Konwertuje określoną datę i godzinę na uniwersalny czas koordynowany (UTC).
CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean)	Tworzy niestandardową strefę czasową z określonym identyfikatorem, przesunięciem z uniwersalnego czasu koordynowanego (UTC), nazwą wyświetlaną, nazwą czasową standardową, nazwą czasu letniego, regułami czasu letniego i wartością wskazującą, czy zwracany obiekt odzwierciedla informacje o czasie letnim.
CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[])	Tworzy niestandardową strefę czasową z określonym identyfikatorem, przesunięciem z uniwersalnego czasu koordynowanego (UTC), nazwą wyświetlaną, nazwą czasową standardową, nazwą czasu letniego i regułami czasu letniego.
CreateCustomTimeZone(String, TimeSpan, String, String)	Tworzy niestandardową strefę czasową z określonym identyfikatorem, przesunięciem z uniwersalnego czasu koordynowanego (UTC), nazwą wyświetlaną i nazwą wyświetlaną w czasie standardowym.
Equals(Object)	Określa, czy bieżący TimeZoneInfo obiekt i inny obiekt są równe.
Equals(TimeZoneInfo)	Określa, czy bieżący TimeZoneInfo obiekt i inny TimeZoneInfo obiekt są równe.
FindSystemTimeZoneById(String)	TimeZoneInfo Zwraca obiekt na podstawie jego identyfikatora.
FromSerializedString(String)	Deserializuje ciąg, aby ponownie utworzyć oryginalny serializowany TimeZoneInfo obiekt.
GetAdjustmentRules()	Pobiera tablicę TimeZoneInfo.AdjustmentRule obiektów, które mają zastosowanie do bieżącego TimeZoneInfo obiektu.
GetAmbiguousTimeOffsets(DateTime)	Zwraca informacje o możliwych datach i godzinach, do których można mapować niejednoznaczną datę i godzinę.
GetAmbiguousTimeOffsets(DateTimeOffset)	Zwraca informacje o możliwych datach i godzinach, do których można mapować niejednoznaczną datę i godzinę.
GetHashCode()	Służy jako funkcja skrótu dla algorytmów tworzenia skrótów i struktur danych, takich jak tabele skrótów.
GetSystemTimeZones()	Zwraca posortowaną kolekcję wszystkich stref czasowych, o których informacje są dostępne w systemie lokalnym.
GetSystemTimeZones(Boolean)	Zwraca wartość zawierającą ReadOnlyCollection<T> wszystkie prawidłowe strefy czasowe z komputera lokalnego. Ta metoda nie zgłasza wyjątku TimeZoneNotFoundException lub InvalidTimeZoneException.
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
GetUtcOffset(DateTime)	Oblicza przesunięcie lub różnicę między czasem w tej strefie czasowej a uniwersalnym czasem koordynowanym (UTC) dla określonej daty i godziny.
GetUtcOffset(DateTimeOffset)	Oblicza przesunięcie lub różnicę między czasem w tej strefie czasowej a uniwersalnym czasem koordynowanym (UTC) dla określonej daty i godziny.
HasSameRules(TimeZoneInfo)	Wskazuje, czy bieżący obiekt i inny TimeZoneInfo obiekt mają te same reguły korekty.
IsAmbiguousTime(DateTime)	Określa, czy określona data i godzina w określonej strefie czasowej jest niejednoznaczna i może być mapowana na co najmniej dwie godziny uniwersalnego czasu koordynowanego (UTC).
IsAmbiguousTime(DateTimeOffset)	Określa, czy określona data i godzina w określonej strefie czasowej jest niejednoznaczna i może być mapowana na co najmniej dwie godziny uniwersalnego czasu koordynowanego (UTC).
IsDaylightSavingTime(DateTime)	Wskazuje, czy określona data i godzina przypada w zakresie czasu letniego dla strefy czasowej bieżącego TimeZoneInfo obiektu.
IsDaylightSavingTime(DateTimeOffset)	Wskazuje, czy określona data i godzina przypada w zakresie czasu letniego dla strefy czasowej bieżącego TimeZoneInfo obiektu.
IsInvalidTime(DateTime)	Wskazuje, czy określona data i godzina są nieprawidłowe.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToSerializedString()	Konwertuje bieżący TimeZoneInfo obiekt na serializowany ciąg.
ToString()	Zwraca nazwę wyświetlaną bieżącego TimeZoneInfo obiektu.
TryConvertIanaIdToWindowsId(String, String)	Próbuje przekonwertować identyfikator strefy czasowej IANA na identyfikator systemu Windows.
TryConvertWindowsIdToIanaId(String, String, String)	Próbuje przekonwertować identyfikator strefy czasowej systemu Windows na identyfikator IANA.
TryConvertWindowsIdToIanaId(String, String)	Próbuje przekonwertować identyfikator strefy czasowej systemu Windows na identyfikator IANA.
TryFindSystemTimeZoneById(String, TimeZoneInfo)	Pobiera TimeZoneInfo obiekt według nazwy strefy czasowej.

Jawne implementacje interfejsu

Nazwa	Opis
IDeserializationCallback.OnDeserialization(Object)	Uruchamia się po zakończeniu deserializacji obiektu.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	SerializationInfo Wypełnia obiekt danymi potrzebnymi do serializacji bieżącego TimeZoneInfo obiektu.