TimeZoneInfo.Local 屬性

定義

命名空間:

System

組件:

System.Runtime.dll

來源:

TimeZoneInfo.cs

取得代表本地時區的 TimeZoneInfo 物件。

public:
 static property TimeZoneInfo ^ Local { TimeZoneInfo ^ get(); };

public static TimeZoneInfo Local { get; }

static member Local : TimeZoneInfo

Public Shared ReadOnly Property Local As TimeZoneInfo

屬性值

TimeZoneInfo

代表本地時區的物件。

範例

下列範例會 TimeZoneInfo 擷取代表當地時區的 物件，並輸出其顯示名稱、標準時間名稱和日光節約時間名稱。

using System;

public class Example
{
   public static void Main()
   {
      TimeZoneInfo localZone = TimeZoneInfo.Local;
      Console.WriteLine("Local Time Zone ID: {0}", localZone.Id);
      Console.WriteLine("   Display Name is: {0}.", localZone.DisplayName);
      Console.WriteLine("   Standard name is: {0}.", localZone.StandardName);
      Console.WriteLine("   Daylight saving name is: {0}.", localZone.DaylightName); 
   }
}
// The example displays output like the following:
//     Local Time Zone ID: Pacific Standard Time
//        Display Name is: (UTC-08:00) Pacific Time (US & Canada).
//        Standard name is: Pacific Standard Time.
//        Daylight saving name is: Pacific Daylight Time.

open System

let localZone = TimeZoneInfo.Local
printfn $"Local Time Zone ID: {localZone.Id}"
printfn $"   Display Name is: {localZone.DisplayName}."
printfn $"   Standard name is: {localZone.StandardName}."
printfn $"   Daylight saving name is: {localZone.DaylightName}."
// The example displays output like the following:
//     Local Time Zone ID: Pacific Standard Time
//        Display Name is: (UTC-08:00) Pacific Time (US & Canada).
//        Standard name is: Pacific Standard Time.
//        Daylight saving name is: Pacific Daylight Time.

Module Example
   Public Sub Main()
      Dim localZone As TimeZoneInfo = TimeZoneInfo.Local
      Console.WriteLine("Local Time Zone ID: {0}", localZone.Id)
      Console.WriteLine("   Display Name is: {0}.", localZone.DisplayName)
      Console.WriteLine("   Standard name is: {0}.", localZone.StandardName)
      Console.WriteLine("   Daylight saving name is: {0}.", localZone.DaylightName) 
   End Sub
End Module
' The example displays output like the following:
'     Local Time Zone ID: Pacific Standard Time
'        Display Name is: (UTC-08:00) Pacific Time (US & Canada).
'        Standard name is: Pacific Standard Time.
'        Daylight saving name is: Pacific Daylight Time.

備註

當地時區是執行程式碼之電腦上的時區。

重要

您應該一律透過 屬性存取當地時區， TimeZoneInfo.Local 而不是將當地時區指派給 TimeZoneInfo 物件變數。 這可防止 TimeZoneInfo 物件變數因為呼叫 ClearCachedData 方法而失效。

在 Windows 系統上， TimeZoneInfo 屬性所傳 TimeZoneInfo.Local 回的物件會反映主控台日期和時間應用程式中 [自動調整日光節約時間的時鐘] 核取方塊的設定。 如果未核取此核取方塊，則本機時區的快取複本不會包含日光節約時間資訊。 這表示：

• 當地時區 GetAdjustmentRules 的 方法會傳回長度為零的陣列。

• 當地時區的 SupportsDaylightSavingTime 屬性會傳 false 回 。

• 當地時區沒有模棱兩可或不正確時間， (所有呼叫 IsAmbiguousTime 或 IsInvalidTime 傳回 false) 。

• 具有個別當地時間的所有呼叫 IsDaylightSavingTime 都會傳回 false。

不過，如果使用 FindSystemTimeZoneById 方法擷取本機時區的參考，則這不是真。

屬性 Local 會對應至 CurrentTimeZone 類別的 TimeZone 屬性。

另請參閱

• 如何：存取預先定義的 UTC 和本機時區物件