TimeZoneInfo 類別

定義

命名空間:

System

組件:

netstandard.dll, System.Runtime.dll

來源:

TimeZoneInfo.cs

代表世界上任何時區。

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

繼承

Object

TimeZoneInfo

實作

IEquatable<TimeZoneInfo> IDeserializationCallback ISerializable

備註

時區是使用相同時間的地理區域。

這個 TimeZoneInfo 類別相較 TimeZone 於僅提供有限功能的類別，提供了顯著的增強。

該 TimeZone 類別僅識別當地時區，並能將協調世界時（UTC）與當地時間之間的時間轉換。 物件 TimeZoneInfo 可以代表任何時區，且該類別的方法 TimeZoneInfo 可用來將一個時區的時間轉換成其他時區的對應時間。 該 TimeZoneInfo 級機車支援以下作業：

• 取用作業系統已定義的時區。

• 列舉系統上可用的時區。

• 跨時區轉換時間。

• 建立一個作業系統尚未定義的新時區。

• 序列化時區以便日後檢索。

備註

該類別的 TimeZoneInfo 實例是不變的。 物件一旦實例化，其值就無法被修改。

你不能用關鍵字new實TimeZoneInfo例化物件。 相反地，你必須呼叫下表中所顯示類別中的 TimeZoneInfo 靜態成員之一。

靜態成員名稱	說明
CreateCustomTimeZone 方法	從應用程式提供的資料建立自訂時區。
FindSystemTimeZoneById 方法	根據識別碼實例化時區。
FromSerializedString 方法	反序列化字串值以重建先前序列化的 TimeZoneInfo 物件。
GetSystemTimeZones 方法	回傳一個可枚舉ReadOnlyCollection<T>TimeZoneInfo物件，代表本地系統上所有可用的時區。
Local 屬性	實例化一個 TimeZoneInfo 代表當地時區的物件。
Utc 屬性	實例化一個 TimeZoneInfo 代表 UTC 區域的物件。

你可以用這個 CreateCustomTimeZone 方法建立一個時區，而在 Windows 系統的本地系統登錄檔中，或在 Linux 或 macOS 上 ICU 圖書館的時區資料 中沒有定義。 接著你可以用這個 ToSerializedString() 屬性將時區物件的資訊儲存成字串，並以應用程式可存取的形式儲存。 你可以用這個 FromSerializedString 方法把序列化字串轉回 TimeZoneInfo 物件。

屬性

名稱	Description
BaseUtcOffset	取得當前時區標準時間與協調世界時（UTC）之間的時差。
DaylightName	會取得該時區夏令時間的顯示名稱。
DisplayName	會得到代表時區的通用顯示名稱。
HasIanaId	如果這個 TimeZoneInfo 物件有 IANA ID，則會回傳 true 。
Id	取得時區識別碼。
Local	會得到 TimeZoneInfo 一個代表當地時區的物件。
StandardName	會獲得該時區標準時間的顯示名稱。
SupportsDaylightSavingTime	會有一個值，表示該時區是否有任何夏令時間規則。
Utc	獲得 TimeZoneInfo 代表協調世界時區（UTC）的物件。

方法

名稱	Description
ClearCachedData()	清除快取的時區資料。
ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)	將一個時區的時間轉換成另一個時區。
ConvertTime(DateTime, TimeZoneInfo)	將時間轉換為特定時區的時間。
ConvertTime(DateTimeOffset, TimeZoneInfo)	將時間轉換為特定時區的時間。
ConvertTimeBySystemTimeZoneId(DateTime, String, String)	根據時區識別碼將時間從一個時區轉換到另一個時區。
ConvertTimeBySystemTimeZoneId(DateTime, String)	根據該時區的識別碼，將時間轉換為另一個時區的時間。
ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)	根據該時區的識別碼，將時間轉換為另一個時區的時間。
ConvertTimeFromUtc(DateTime, TimeZoneInfo)	將協調世界時（UTC）轉換為指定時區的時間。
ConvertTimeToUtc(DateTime, TimeZoneInfo)	將指定時區的時間轉換為協調世界時（UTC）。
ConvertTimeToUtc(DateTime)	將指定的日期與時間轉換為協調世界時（UTC）。
CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean)	建立自訂時區，包含指定識別碼、協調世界時（UTC）的偏移量、顯示名稱、標準時間名稱、夏令時間名稱、夏令時間規則，以及指示回傳物件是否反映夏令時間資訊的值。
CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[])	建立自訂時區，並設定指定識別碼、協調世界時（UTC）的偏移量、顯示名稱、標準時間名稱、夏令時間名稱及夏令時間規則。
CreateCustomTimeZone(String, TimeSpan, String, String)	建立自訂時區，包含指定識別碼、協調世界時（UTC）的偏移量、顯示名稱及標準時間顯示名稱。
Equals(Object)	判斷當前 TimeZoneInfo 物體與另一個物體是否相等。
Equals(TimeZoneInfo)	判斷當前 TimeZoneInfo 物體與另一個 TimeZoneInfo 物體是否相等。
FindSystemTimeZoneById(String)	根據物件識別碼回傳 TimeZoneInfo 物件。
FromSerializedString(String)	反序列化字串以重建原始序列化物件 TimeZoneInfo 。
GetAdjustmentRules()	擷取一套適用於當前TimeZoneInfo物件的物件陣列TimeZoneInfo.AdjustmentRule。
GetAmbiguousTimeOffsets(DateTime)	回傳關於模糊日期與時間可映射的可能日期與時間資訊。
GetAmbiguousTimeOffsets(DateTimeOffset)	回傳關於模糊日期與時間可映射的可能日期與時間資訊。
GetHashCode()	作為雜湊演算法及資料結構（如雜湊表）的雜湊函數。
GetSystemTimeZones()	回傳一個排序後的所有時區集合，這些資訊可在本地系統中取得。
GetSystemTimeZones(Boolean)	回傳 ReadOnlyCollection<T> 包含本地機器所有有效時區的資料。 此方法 不會 拋出 TimeZoneNotFoundException 或 InvalidTimeZoneException。
GetType()	取得目前實例的 Type。 (繼承來源 Object)
GetUtcOffset(DateTime)	計算特定日期和時間下，該時區與協調世界時（UTC）時間之間的偏移或差異。
GetUtcOffset(DateTimeOffset)	計算特定日期和時間下，該時區與協調世界時（UTC）時間之間的偏移或差異。
HasSameRules(TimeZoneInfo)	表示當前物件與另一個 TimeZoneInfo 物件是否有相同的調整規則。
IsAmbiguousTime(DateTime)	判斷特定時區的日期與時間是否模糊，並可對應兩個或多個協調世界時（UTC）時間。
IsAmbiguousTime(DateTimeOffset)	判斷特定時區的日期與時間是否模糊，並可對應兩個或多個協調世界時（UTC）時間。
IsDaylightSavingTime(DateTime)	表示指定日期與時間是否屬於當前 TimeZoneInfo 物體時區的夏令時間範圍。
IsDaylightSavingTime(DateTimeOffset)	表示指定日期與時間是否屬於當前 TimeZoneInfo 物體時區的夏令時間範圍。
IsInvalidTime(DateTime)	表示某個日期和時間是否無效。
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ToSerializedString()	將目前 TimeZoneInfo 物件轉換為序列化字串。
ToString()	回傳當前 TimeZoneInfo 物件的顯示名稱。
TryConvertIanaIdToWindowsId(String, String)	嘗試將 IANA 時區 ID 轉換成 Windows ID。
TryConvertWindowsIdToIanaId(String, String, String)	嘗試將 Windows 時區 ID 轉換成 IANA ID。
TryConvertWindowsIdToIanaId(String, String)	嘗試將 Windows 時區 ID 轉換成 IANA ID。
TryFindSystemTimeZoneById(String, TimeZoneInfo)	透過時區名稱擷取物件 TimeZoneInfo 。

明確介面實作

名稱	Description
IDeserializationCallback.OnDeserialization(Object)	當物件完成反序列化後執行。
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	會 SerializationInfo 將物件填入序列化當前 TimeZoneInfo 物件所需的資料。