TimeZoneInfo 類別

定義

命名空間:

System

組件:

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 Library 時區數據 。 然後， ToSerializedString 您可以使用 屬性將時區物件的資訊儲存為字串，該字串可以儲存在應用程式可存取的某種形式中。 您可以使用 FromSerializedString 方法，將串行化字串轉換回 TimeZoneInfo 物件。

屬性

BaseUtcOffset	取得目前時區標準時間與國際標準時間 (UTC) 的時差。
DaylightName	取得目前時區日光節約時間的顯示名稱。
DisplayName	取得代表時區的一般顯示名稱。
HasIanaId	如果這個 TimeZoneInfo 物件具有 IANA 識別碼，則傳 true 回 。
Id	取得時區識別項。
Local	取得代表本地時區的 TimeZoneInfo 物件。
StandardName	取得時區標準時間的顯示名稱。
SupportsDaylightSavingTime	取得值，這個值表示時區是否具有任何日光節約時間規則。
Utc	取得代表國際標準時間 (UTC) 時區的 TimeZoneInfo 物件。

方法

ClearCachedData()	清除快取的時區資料。
ConvertTime(DateTime, TimeZoneInfo)	將時間轉換為特定時區的時間。
ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)	將時間從一個時區轉換為另一個時區。
ConvertTime(DateTimeOffset, TimeZoneInfo)	將時間轉換為特定時區的時間。
ConvertTimeBySystemTimeZoneId(DateTime, String)	根據時區的識別項將時間轉換為另一時區的時間。
ConvertTimeBySystemTimeZoneId(DateTime, String, String)	根據時區識別項將時間從一個時區轉換為另一個時區。
ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)	根據時區的識別項將時間轉換為另一時區的時間。
ConvertTimeFromUtc(DateTime, TimeZoneInfo)	將國際標準時間 (UTC) 轉換為指定時區的時間。
ConvertTimeToUtc(DateTime)	將指定的日期和時間轉換為國際標準時間 (UTC)。
ConvertTimeToUtc(DateTime, TimeZoneInfo)	將指定時區的時間轉換為國際標準時間 (UTC)。
CreateCustomTimeZone(String, TimeSpan, String, String)	建立具有指定識別項的自訂時區、國際標準時間 (UTC) 的位移、顯示名稱和標準時間顯示名稱。
CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[])	以指定的識別項、國際標準時間 (UTC) 的位移、顯示名稱、標準時間名稱、日光節約時間名稱和日光節約時間規則，建立自訂時區。
CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean)	以指定的識別項、國際標準時間 (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> 其中包含來自本機電腦的所有有效 TimeZone 。 此方法 不會 擲回 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 時區標識碼轉換為 Windows 識別碼。
TryConvertWindowsIdToIanaId(String, String)	嘗試將 Windows 時區識別碼轉換為 IANA 識別碼。
TryConvertWindowsIdToIanaId(String, String, String)	嘗試將 Windows 時區識別碼轉換為 IANA 識別碼。
TryFindSystemTimeZoneById(String, TimeZoneInfo)	TimeZoneInfo依時區名稱擷取物件。

明確介面實作

IDeserializationCallback.OnDeserialization(Object)	在物件完成還原序列化時執行。
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	使用序列化目前 SerializationInfo 物件所需的資料，填入 TimeZoneInfo 物件。