TimeZoneInfo.Local 属性

定义

命名空间:

System

程序集:

System.Runtime.dll

Source:

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 和本地时区对象