TimeZoneInfo.BaseUtcOffset Свойство

Определение

Пространство имен:
System
Сборки:
mscorlib.dll, System.Runtime.dll
Сборки:
netstandard.dll, System.Runtime.dll
Сборка:
System.Runtime.dll
Сборка:
System.Core.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll
Исходный код:
TimeZoneInfo.cs
Исходный код:
TimeZoneInfo.cs
Исходный код:
TimeZoneInfo.cs
Исходный код:
TimeZoneInfo.cs
Исходный код:
TimeZoneInfo.cs

Возвращает разницу времени между стандартным временем текущего часового пояса и согласованным универсальным временем (UTC).

public:
 property TimeSpan BaseUtcOffset { TimeSpan get(); };
public TimeSpan BaseUtcOffset { get; }
member this.BaseUtcOffset : TimeSpan
Public ReadOnly Property BaseUtcOffset As TimeSpan

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

TimeSpan

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

Примеры

В следующем примере свойство используется BaseUtcOffset для отображения разницы между локальным временем и согласованным универсальным временем (UTC).

TimeZoneInfo localZone = TimeZoneInfo.Local;
Console.WriteLine("The {0} time zone is {1}:{2} {3} than Coordinated Universal Time.",  
                  localZone.DisplayName, 
                  Math.Abs(localZone.BaseUtcOffset.Hours), 
                  Math.Abs(localZone.BaseUtcOffset.Minutes), 
                  (localZone.BaseUtcOffset >= TimeSpan.Zero) ? "later" : "earlier");

let localZone = TimeZoneInfo.Local
printfn $"""The {localZone.DisplayName} time zone is {abs localZone.BaseUtcOffset.Hours}:{abs localZone.BaseUtcOffset.Minutes} {if localZone.BaseUtcOffset >= TimeSpan.Zero then "later" else "earlier"} than Coordinated Universal Time."""

Dim localZone As TimeZoneInfo = TimeZoneInfo.Local
Console.WriteLine("The {0} time zone is {1}:{2} {3} than Coordinated Universal Time.", _ 
                  localZone.StandardName, _
                  Math.Abs(localZone.BaseUtcOffset.Hours), _
                  Math.Abs(localZone.BaseUtcOffset.Minutes), _
                  IIf(localZone.BaseUtcOffset >= TimeSpan.Zero, "later", "earlier"))

Комментарии

Интервал времени, возвращаемый BaseUtcOffset свойством, может варьироваться от 14 часов (для часового пояса, который составляет 14 часов до времени UTC) до -14 часов (для часового пояса, который составляет 14 часов за utc). Часовые пояса, которые опережают UTC, имеют положительное смещение; часовые пояса, которые находятся за utc, имеют отрицательное смещение.

Значение BaseUtcOffset представлено целым числом минут. Оно не может содержать дробное количество минут.

Замечание

Поскольку BaseUtcOffset это свойство TimeZoneInfo объекта, а не TimeZoneInfo.AdjustmentRule объект, TimeZoneInfo класс применяет одно смещение от UTC ко всем корректировкам часового пояса. Чтобы отразить часовой пояс, который изменил смещение из UTC, необходимо создать новый часовой пояс с помощью CreateCustomTimeZone метода.

Свойство BaseUtcOffset отличается от GetUtcOffset метода следующим образом:

  • Свойство BaseUtcOffset возвращает разницу между временем в формате UTC и часовой поясом; GetUtcOffset метод возвращает разницу между временем в формате UTC и временем часового пояса в определенный момент времени.

  • Метод GetUtcOffset отражает применение любых правил корректировки к часовому поясу; BaseUtcOffset свойство не учитывается.

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

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