共用方式為


如何:取得 TimeZoneInfo 物件

取得 TimeZoneInfo 物件最常見的方法是從登錄擷取其相關信息。 若要取得 物件,請在登錄中呼叫 staticShared 在 Visual Basic 中為 ) TimeZoneInfo.FindSystemTimeZoneById 方法。 處理 方法擲回的任何例外狀況,特別是 TimeZoneNotFoundException 登錄中未定義時區時所擲回的 。

注意

從 .NET 8 開始,會傳回快取TimeZoneInfo的物件,TimeZoneInfo.FindSystemTimeZoneById而不是具現化新的物件。 如需詳細資訊,請參閱 FindSystemTimeZoneById 不會傳回新的物件

範例

下列程式碼會擷取 TimeZoneInfo 物件,其代表美加東部標準時間區域,並顯示與本地時間對應的美加東部標準時間。

DateTime timeNow = DateTime.Now;
try
{
    TimeZoneInfo easternZone = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time");
    DateTime easternTimeNow = TimeZoneInfo.ConvertTime(
        timeNow,
        TimeZoneInfo.Local,
        easternZone
        );
    Console.WriteLine("{0} {1} corresponds to {2} {3}.",
                      timeNow,
                      TimeZoneInfo.Local.IsDaylightSavingTime(timeNow) ?
                                TimeZoneInfo.Local.DaylightName :
                                TimeZoneInfo.Local.StandardName,
                      easternTimeNow,
                      easternZone.IsDaylightSavingTime(easternTimeNow) ?
                                  easternZone.DaylightName :
                                  easternZone.StandardName);
}
// Handle exception
//
// As an alternative to simply displaying an error message, an alternate Eastern
// Standard Time TimeZoneInfo object could be instantiated here either by restoring
// it from a serialized string or by providing the necessary data to the
// CreateCustomTimeZone method.
catch (TimeZoneNotFoundException)
{
    Console.WriteLine("The Eastern Standard Time Zone cannot be found on the local system.");
}
catch (InvalidTimeZoneException)
{
    Console.WriteLine("The Eastern Standard Time Zone contains invalid or missing data.");
}
catch (SecurityException)
{
    Console.WriteLine("The application lacks permission to read time zone information from the registry.");
}
catch (OutOfMemoryException)
{
    Console.WriteLine("Not enough memory is available to load information on the Eastern Standard Time zone.");
}
// If we weren't passing FindSystemTimeZoneById a literal string, we also
// would handle an ArgumentNullException.
Dim timeNow As Date = Date.Now
Try
    Dim easternZone As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time")
    Dim easternTimeNow As Date = TimeZoneInfo.ConvertTime(timeNow, TimeZoneInfo.Local, easternZone)
    Console.WriteLine("{0} {1} corresponds to {2} {3}.", _
                      timeNow, _
                      IIf(TimeZoneInfo.Local.IsDaylightSavingTime(timeNow), _
                          TimeZoneInfo.Local.DaylightName, TimeZoneInfo.Local.StandardName), _
                      easternTimeNow, _
                      IIf(easternZone.IsDaylightSavingTime(easternTimeNow), _
                          easternZone.DaylightName, easternZone.StandardName))
    ' Handle exception
    '
    ' As an alternative to simply displaying an error message, an alternate Eastern
    ' Standard Time TimeZoneInfo object could be instantiated here either by restoring
    ' it from a serialized string or by providing the necessary data to the
    ' CreateCustomTimeZone method.
Catch e As TimeZoneNotFoundException
    Console.WriteLine("The Eastern Standard Time Zone cannot be found on the local system.")
Catch e As InvalidTimeZoneException
    Console.WriteLine("The Eastern Standard Time Zone contains invalid or missing data.")
Catch e As SecurityException
    Console.WriteLine("The application lacks permission to read time zone information from the registry.")
Catch e As OutOfMemoryException
    Console.WriteLine("Not enough memory is available to load information on the Eastern Standard Time zone.")
    ' If we weren't passing FindSystemTimeZoneById a literal string, we also 
    ' would handle an ArgumentNullException.
End Try

TimeZoneInfo.FindSystemTimeZoneById 方法的單一參數是您想要擷取之時區的識別項,其對應至物件的 TimeZoneInfo.Id 屬性。 時區識別項是唯一識別時區的索引鍵欄位。 雖然大部分的索引鍵相對較短,但時區識別項相較之下就很長。 在大部分情況下,其值會對應到 StandardName 物件的 TimeZoneInfo 屬性,其用來提供時區標準時間的名稱。 不過仍有例外狀況。 若要確定您提供了有效的識別項,最好的方法是列舉系統上可用的時區,並記下存在於其之上的時區識別項。 如需圖例,請參閱 How to: Enumerate time zones present on a computer。 尋找 本機系統 發行項上定義的時區也包含所選時區標識碼的清單。

如果找到時區,此方法會傳回其 TimeZoneInfo 物件。 如果找不到時區,方法會擲回 TimeZoneNotFoundException。 如果找到時區,但其資料已損毀或不完整,則方法會擲回 InvalidTimeZoneException

如果您的應用程式依賴於必須存在的時區,則您應該先呼叫 FindSystemTimeZoneById 方法,以便從登錄擷取時區資訊。 如果方法呼叫失敗,則例外狀況處理常式應建立新的時區執行個體,或透過將序列化 TimeZoneInfo 物件還原序列化,以重新建立時區執行個體。 如需範例,請參閱如何:從內嵌資源還原時區

另請參閱