TimeZoneInfo.Local TimeZoneInfo.Local TimeZoneInfo.Local TimeZoneInfo.Local Property

Определение

Возвращает объект 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.

В системах Windows TimeZoneInfo объект, возвращаемый 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.

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

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

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