TimeZoneInfo Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje jakékoli časové pásmo na světě.
public ref class TimeZoneInfo sealed : IEquatable<TimeZoneInfo ^>
public ref class TimeZoneInfo sealed : IEquatable<TimeZoneInfo ^>, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>
public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
[System.Serializable]
public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
type TimeZoneInfo = class
interface IEquatable<TimeZoneInfo>
type TimeZoneInfo = class
interface IEquatable<TimeZoneInfo>
interface IDeserializationCallback
interface ISerializable
type TimeZoneInfo = class
interface IEquatable<TimeZoneInfo>
interface ISerializable
interface IDeserializationCallback
type TimeZoneInfo = class
interface IDeserializationCallback
interface ISerializable
interface IEquatable<TimeZoneInfo>
[<System.Serializable>]
type TimeZoneInfo = class
interface IEquatable<TimeZoneInfo>
interface ISerializable
interface IDeserializationCallback
Public NotInheritable Class TimeZoneInfo
Implements IEquatable(Of TimeZoneInfo)
Public NotInheritable Class TimeZoneInfo
Implements IDeserializationCallback, IEquatable(Of TimeZoneInfo), ISerializable
- Dědičnost
-
TimeZoneInfo
- Atributy
- Implementuje
Poznámky
Časové pásmo je geografická oblast, ve které se používá stejný čas.
Třída TimeZoneInfo nabízí významná vylepšení oproti TimeZone třídě, která poskytuje pouze omezené funkce.
Třída TimeZone rozpoznává pouze místní časové pásmo a může převádět časy mezi koordinovaným univerzálním časem (UTC) a místním časem. Objekt TimeZoneInfo může představovat libovolné časové pásmo a metody TimeZoneInfo třídy lze použít k převodu času v jednom časovém pásmu na odpovídající čas v libovolném jiném časovém pásmu. Členové TimeZoneInfo třídy podporují následující operace:
Načítání časového pásma, které je již definováno operačním systémem.
Výčet časových pásem, která jsou k dispozici v systému.
Převod časů mezi různými časovými pásmy
Vytvoření nového časového pásma, které ještě není definováno operačním systémem.
Serializace časového pásma pro pozdější načtení.
Poznámka
Instance TimeZoneInfo třídy je neměnná. Po vytvoření instance objektu nelze změnit jeho hodnoty.
Nelze vytvořit instanci objektu TimeZoneInfo pomocí klíčového new
slova. Místo toho musíte volat jeden ze statických TimeZoneInfo členů třídy uvedené v následující tabulce.
Název statického člena | Description |
---|---|
Metoda CreateCustomTimeZone | Vytvoří vlastní časové pásmo z dat dodaných aplikací. |
Metoda FindSystemTimeZoneById | Vytvoří instanci časového pásma na základě jeho identifikátoru. |
Metoda FromSerializedString | Deserializuje řetězcovou hodnotu pro opětovné vytvoření dříve serializovaného TimeZoneInfo objektu. |
Metoda GetSystemTimeZones | Vrátí výčet ReadOnlyCollection<T>TimeZoneInfo objektů, které představují všechna časová pásma, která jsou k dispozici v místním systému. |
Local Vlastnost | Vytvoří instanci objektu TimeZoneInfo , který představuje místní časové pásmo. |
Utc Vlastnost | Vytvoří instanci objektu TimeZoneInfo , který představuje zónu UTC. |
Pomocí metody můžete CreateCustomTimeZone vytvořit časové pásmo, které není definované v místním systémovém registru v systémech Windows nebo daty časového pásma knihovny ICU v Linuxu nebo macOS. Vlastnost pak můžete použít ToSerializedString k uložení informací o objektu časového pásma jako řetězce, který může být uložen v nějaké formě, která je přístupná pro aplikaci. Můžete použít metodu FromSerializedString k převodu serializovaného řetězce zpět na TimeZoneInfo objekt.
Vlastnosti
BaseUtcOffset |
Získá časový rozdíl mezi standardním časem aktuálního časového pásma a koordinovaným univerzálním časem (UTC). |
DaylightName |
Získá zobrazovaný název aktuálního časového pásma letního času. |
DisplayName |
Získá obecný zobrazovaný název, který představuje časové pásmo. |
HasIanaId |
Vrátí |
Id |
Získá identifikátor časového pásma. |
Local |
TimeZoneInfo Získá objekt, který představuje místní časové pásmo. |
StandardName |
Získá zobrazovaný název pro standardní čas časového pásma. |
SupportsDaylightSavingTime |
Získá hodnotu označující, zda časové pásmo má nějaké letní čas pravidla. |
Utc |
Získá TimeZoneInfo objekt, který představuje koordinovaný univerzální čas (UTC) zónu. |
Metody
ClearCachedData() |
Vymaže data časového pásma v mezipaměti. |
ConvertTime(DateTime, TimeZoneInfo) |
Převede čas na čas v určitém časovém pásmu. |
ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) |
Převede čas z jednoho časového pásma do jiného. |
ConvertTime(DateTimeOffset, TimeZoneInfo) |
Převede čas na čas v určitém časovém pásmu. |
ConvertTimeBySystemTimeZoneId(DateTime, String) |
Převede čas na čas v jiném časovém pásmu na základě identifikátoru časového pásma. |
ConvertTimeBySystemTimeZoneId(DateTime, String, String) |
Převede čas z jednoho časového pásma na jiné na základě identifikátorů časových pásem. |
ConvertTimeBySystemTimeZoneId(DateTimeOffset, String) |
Převede čas na čas v jiném časovém pásmu na základě identifikátoru časového pásma. |
ConvertTimeFromUtc(DateTime, TimeZoneInfo) |
Převede koordinovaný univerzální čas (UTC) na čas v zadaném časovém pásmu. |
ConvertTimeToUtc(DateTime) |
Převede zadané datum a čas na koordinovaný světový čas (UTC). |
ConvertTimeToUtc(DateTime, TimeZoneInfo) |
Převede čas v zadaném časovém pásmu na koordinovaný univerzální čas (UTC). |
CreateCustomTimeZone(String, TimeSpan, String, String) |
Vytvoří vlastní časové pásmo se zadaným identifikátorem, posunem od koordinovaného univerzálního času (UTC), zobrazovaným názvem a zobrazovaným názvem standardního času. |
CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[]) |
Vytvoří vlastní časové pásmo se zadaným identifikátorem, posunem od koordinovaného univerzálního času (UTC), zobrazovaným názvem, názvem standardního času, názvem letního času a pravidly letního času. |
CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean) |
Vytvoří vlastní časové pásmo se zadaným identifikátorem, posunem od koordinovaného univerzálního času (UTC), zobrazovaným názvem, názvem standardního času, názvem letního času, pravidly letního času a hodnotou, která označuje, zda vrácený objekt odráží informace o letním času. |
Equals(Object) |
Určuje, zda aktuální TimeZoneInfo objekt a jiný objekt jsou si rovny. |
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
Equals(TimeZoneInfo) |
Určuje, zda aktuální TimeZoneInfo objekt a jiný TimeZoneInfo objekt jsou si rovny. |
FindSystemTimeZoneById(String) |
Vrátí objekt na TimeZoneInfo základě jeho identifikátoru. |
FromSerializedString(String) |
Deserializuje řetězec k opětovnému vytvoření původního serializovaného TimeZoneInfo objektu. |
GetAdjustmentRules() |
Načte pole TimeZoneInfo.AdjustmentRule objektů, které platí pro aktuální TimeZoneInfo objekt. |
GetAmbiguousTimeOffsets(DateTime) |
Vrátí informace o možných datech a časech, na které lze namapovat nejednoznačné datum a čas. |
GetAmbiguousTimeOffsets(DateTimeOffset) |
Vrátí informace o možných datech a časech, na které lze namapovat nejednoznačné datum a čas. |
GetHashCode() |
Slouží jako hashovací funkce pro hashování algoritmů a datových struktur, jako jsou hashovací tabulky. |
GetSystemTimeZones() |
Vrátí seřazenou kolekci všech časových pásem, o kterých jsou k dispozici informace v místním systému. |
GetSystemTimeZones(Boolean) |
ReadOnlyCollection<T> Vrátí hodnotu obsahující všechny platné časové zóny z místního počítače. Tato metoda nevyvolá TimeZoneNotFoundException nebo InvalidTimeZoneException. |
GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
GetUtcOffset(DateTime) |
Vypočítá posun nebo rozdíl mezi časem v tomto časovém pásmu a koordinovaným univerzálním časem (UTC) pro konkrétní datum a čas. |
GetUtcOffset(DateTimeOffset) |
Vypočítá posun nebo rozdíl mezi časem v tomto časovém pásmu a koordinovaným univerzálním časem (UTC) pro konkrétní datum a čas. |
HasSameRules(TimeZoneInfo) |
Určuje, zda aktuální objekt a jiný TimeZoneInfo objekt mají stejná pravidla úprav. |
IsAmbiguousTime(DateTime) |
Určuje, zda je určité datum a čas v určitém časovém pásmu nejednoznačné a lze je namapovat na dva nebo více časů UTC (Coordinated Universal Time). |
IsAmbiguousTime(DateTimeOffset) |
Určuje, zda je určité datum a čas v určitém časovém pásmu nejednoznačné a lze je namapovat na dva nebo více časů UTC (Coordinated Universal Time). |
IsDaylightSavingTime(DateTime) |
Určuje, zda zadané datum a čas spadá do rozsahu letního času pro časové pásmo aktuálního TimeZoneInfo objektu. |
IsDaylightSavingTime(DateTimeOffset) |
Určuje, zda zadané datum a čas spadá do rozsahu letního času pro časové pásmo aktuálního TimeZoneInfo objektu. |
IsInvalidTime(DateTime) |
Určuje, jestli je určité datum a čas neplatné. |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
ToSerializedString() |
Převede aktuální TimeZoneInfo objekt na serializovaný řetězec. |
ToString() |
Vrátí zobrazovaný název aktuálního TimeZoneInfo objektu. |
TryConvertIanaIdToWindowsId(String, String) |
Pokusí se převést ID IANA časového pásma na ID Systému Windows. |
TryConvertWindowsIdToIanaId(String, String) |
Pokusí se převést ID časového pásma Systému Windows na ID IANA. |
TryConvertWindowsIdToIanaId(String, String, String) |
Pokusí se převést ID časového pásma Systému Windows na ID IANA. |
TryFindSystemTimeZoneById(String, TimeZoneInfo) |
Načte TimeZoneInfo objekt podle názvu časového pásma. |
Explicitní implementace rozhraní
IDeserializationCallback.OnDeserialization(Object) |
Spouští se po dokončení rekonstrukce objektu. |
ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Naplní SerializationInfo objekt daty potřebnými k serializaci aktuálního TimeZoneInfo objektu. |