TimeZoneInfo Klasa

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

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 znaczne ulepszenia w TimeZone klasie, które zapewniają 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, które są dostępne 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

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

Nie można utworzyć TimeZoneInfo wystąpienia obiektu przy użyciu słowa kluczowego new . Zamiast tego należy wywołać jeden ze statycznych elementów członkowskich 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 jej identyfikatora.
Metoda FromSerializedString	Deserializuje wartość ciągu w celu ponownego utworzenia wcześniej serializowanego TimeZoneInfo obiektu.
Metoda GetSystemTimeZones	Zwraca wyliczenie ReadOnlyCollection<T>TimeZoneInfo obiektów reprezentujących wszystkie strefy czasowe dostępne w systemie lokalnym.
Local Właściwość	Tworzy wystąpienie obiektu reprezentującego lokalną strefę TimeZoneInfo czasową.
Utc Właściwość	Tworzy wystąpienie obiektu reprezentującego strefę TimeZoneInfo UTC.

Za pomocą CreateCustomTimeZone metody można utworzyć strefę czasową, która nie jest zdefiniowana w lokalnym rejestrze systemowym w systemach Windows lub przez dane strefy czasowej biblioteki ICU w systemie Linux lub macOS. Następnie możesz 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. Możesz użyć FromSerializedString metody , aby przekonwertować serializowany ciąg z powrotem na TimeZoneInfo obiekt.

Właściwości

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 standardowego czasu 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

ClearCachedData()	Czyści buforowane dane strefy czasowej.
ConvertTime(DateTime, TimeZoneInfo)	Konwertuje czas na czas w określonej strefie czasowej.
ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)	Konwertuje czas z jednej strefy czasowej na inną.
ConvertTime(DateTimeOffset, TimeZoneInfo)	Konwertuje czas na czas w określonej strefie czasowej.
ConvertTimeBySystemTimeZoneId(DateTime, String)	Konwertuje czas na czas w innej strefie czasowej na podstawie identyfikatora strefy czasowej.
ConvertTimeBySystemTimeZoneId(DateTime, String, String)	Konwertuje czas z jednej strefy czasowej na inną na podstawie identyfikatorów stref czasowych.
ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)	Konwertuje czas na czas w innej strefie czasowej na podstawie identyfikatora strefy czasowej.
ConvertTimeFromUtc(DateTime, TimeZoneInfo)	Konwertuje uniwersalny czas koordynowany (UTC) na czas w określonej strefie czasowej.
ConvertTimeToUtc(DateTime)	Konwertuje określoną datę i godzinę na uniwersalny czas koordynowany (UTC).
ConvertTimeToUtc(DateTime, TimeZoneInfo)	Konwertuje czas w określonej strefie czasowej na uniwersalny czas koordynowany (UTC).
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.
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, String, TimeZoneInfo+AdjustmentRule[], Boolean)	Tworzy niestandardową strefę czasową z określonym identyfikatorem, przesunięciem z uniwersalnego czasu koordynowanego (UTC), nazwą wyświetlaną, nazwą standardową, nazwą czasu letniego, regułami czasu letniego i wartością wskazującą, czy zwracany obiekt odzwierciedla informacje o czasie letnim.
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 w celu ponownego utworzenia oryginalnego serializowanego TimeZoneInfo obiektu.
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 zamapować niejednoznaczną datę i godzinę.
GetAmbiguousTimeOffsets(DateTimeOffset)	Zwraca informacje o możliwych datach i godzinach, do których można zamapować 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 ani InvalidTimeZoneException.
GetType()	Type Pobiera wartość 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 dwa czasy uniwersalnego koordynowanego czasu (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 dwa czasy uniwersalnego koordynowanego czasu (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 Objectelementu . (Odziedziczone po Object)
ToSerializedString()	Konwertuje bieżący TimeZoneInfo obiekt na ciąg serializowany.
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)	Próbuje przekonwertować identyfikator strefy czasowej systemu Windows na identyfikator IANA.
TryConvertWindowsIdToIanaId(String, String, String)	Próbuje przekonwertować identyfikator strefy czasowej systemu Windows na identyfikator IANA.
TryFindSystemTimeZoneById(String, TimeZoneInfo)	TimeZoneInfo Pobiera obiekt według nazwy strefy czasowej.

Jawne implementacje interfejsu

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.