TimeZoneInfo.Local Свойство

Определение

Возвращает объект TimeZoneInfo, представляющий местный часовой пояс.

C#
public static TimeZoneInfo Local { get; }
C#
public static TimeZoneInfo Local { [System.Security.SecurityCritical] get; }

Значение свойства

TimeZoneInfo

Объект, представляющий местный часовой пояс.

Атрибуты

Примеры

В следующем примере извлекается объект, представляющий локальный часовой TimeZoneInfo пояс, и выводит его отображаемое имя, стандартное имя времени и имя летнего времени.

C#
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.

Комментарии

Локальный часовой пояс — это часовой пояс на компьютере, где выполняется код.

Важно!

Следует всегда обращаться к местному часовом поясу TimeZoneInfo.Local через свойство, а не назначать локальный часовой пояс объектной переменной TimeZoneInfo . Это предотвращает TimeZoneInfo недопустимую объектную переменную вызовом ClearCachedData метода.

В системах Windows объект, возвращаемый свойствомTimeZoneInfo.Local, TimeZoneInfo отражает параметр автоматической настройки часов для флажка "Летнее время" в приложении панель управления даты и времени. Если флажок снят, кэшированная копия локального часового пояса не содержит сведений о летнем времени. Это означает следующее.

  • Метод локального часового пояса GetAdjustmentRules возвращает массив, длина которого равна нулю.

  • Возвращается falseсвойство местного часового поясаSupportsDaylightSavingTime.

  • Локальный часовой пояс не имеет неоднозначного или недопустимого времени (все вызовы IsAmbiguousTime или IsInvalidTime возврат).false

  • Все вызовы IsDaylightSavingTime с отдельным локальным временем возвращают значение false.

Однако это не так, если ссылка на локальный часовой пояс извлекается с помощью FindSystemTimeZoneById метода.

Свойство Local соответствует свойству CurrentTimeZone TimeZone класса.

Применяется к

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

См. также раздел