TimeZoneInfo.Local Свойство

Определение

Возвращает объект TimeZoneInfo, представляющий местный часовой пояс.Gets a TimeZoneInfo object that represents the local time zone.

public:
 static property TimeZoneInfo ^ Local { TimeZoneInfo ^ get(); };
[get: System.Security.SecurityCritical]
public static TimeZoneInfo Local { get; }
member this.Local : TimeZoneInfo
Public Shared ReadOnly Property Local As TimeZoneInfo

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

Объект, представляющий местный часовой пояс.An object that represents the local time zone.

Атрибуты

Примеры

В следующем примере извлекается TimeZoneInfo объект, представляющий местный часовой пояс, и выводится его отображаемое имя, имя стандартного времени и имя перехода на летнее время.The following example retrieves a TimeZoneInfo object that represents the local time zone and outputs its display name, standard time name, and daylight saving time name.

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

Комментарии

Местный часовой пояс — это часовой пояс на компьютере, на котором выполнялся код.The local time zone is the time zone on the computer where the code is executing.

Важно!

Необходимо всегда обращаться к локальному часовому поясу через свойство, TimeZoneInfo.Local а не назначать местный часовой пояс TimeZoneInfo переменной объекта.You should always access the local time zone through the TimeZoneInfo.Local property rather than assigning the local time zone to a TimeZoneInfo object variable. Это предотвращает TimeZoneInfo недействительность аннулирования переменной объекта при вызове ClearCachedData метода.This prevents the TimeZoneInfo object variable from being invalidated by a call to the ClearCachedData method.

В системах TimeZoneInfo Windows объект, TimeZoneInfo.Local возвращаемый свойством, отражает флажок автоматически регулировать часы для летнего времени в приложении " Дата и время " панели управления.On Windows systems, the TimeZoneInfo object returned by the TimeZoneInfo.Local property reflects the setting of the Automatically adjust clock for Daylight Saving Time checkbox in the Control Panel Date and Time application. Если флажок снят, кэшированная копия местного часового пояса не содержит сведений о летнем времени.If the checkbox is unchecked, the cached copy of the local time zone contains no daylight saving time information. Это означает следующее.This means that:

  • GetAdjustmentRules Метод местного часового пояса возвращает массив, длина которого равна нулю.The local time zone's GetAdjustmentRules method returns an array whose length is zero.

  • SupportsDaylightSavingTime Свойство местного часового пояса возвращает falseзначение.The local time zone's SupportsDaylightSavingTime property returns false.

  • Местный часовой пояс не имеет однозначного или недопустимого времени (все вызовы IsAmbiguousTime или IsInvalidTime возвращают false).The local time zone has no ambiguous or invalid times (all calls to IsAmbiguousTime or IsInvalidTime return false).

  • Все вызовы IsDaylightSavingTime с отдельным местным временем возвращают значение false.All calls to IsDaylightSavingTime with individual local times return false.

Однако это не верно, если ссылка на местный часовой пояс извлекается с помощью FindSystemTimeZoneById метода.This is not true, however, if a reference to the local time zone is retrieved using the FindSystemTimeZoneById method.

Свойство соответствует CurrentTimeZone свойствуTimeZoneкласса. LocalThe Local property corresponds to the CurrentTimeZone property of the TimeZone class.

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

Дополнительно