TimeZoneInfo.BaseUtcOffset 屬性

定義

命名空間:

System

組件:

netstandard.dll, System.Runtime.dll

來源:

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小時（比協調世界時（UTC）快14小時的時區）到 -14 小時（落後UTC14小時的時區）不等。 領先UTC的時區則有正偏移;落後於UTC的時區則有負偏移。

BaseUtcOffset數值以整數分鐘表示。 它不能包含分數分鐘。

備註

由於 BaseUtcOffset 是物件的屬性 TimeZoneInfo ，而非物件本身 TimeZoneInfo.AdjustmentRule ，類別對 TimeZoneInfo 整個時區的調整都套用一個 UTC 偏移量。 若要反映已改變與UTC偏移的時區，必須使用該 CreateCustomTimeZone 方法建立新時區。

此 BaseUtcOffset 性質與方法 GetUtcOffset 的不同之處如下：

• 該屬性會 BaseUtcOffset 回傳 UTC 與該時區標準時間的差值;該 GetUtcOffset 方法則會回傳特定時間點 UTC 與該時區時間的差值。

• 此 GetUtcOffset 方法反映任何調整規則對時區的應用;但該 BaseUtcOffset 物業則不適用。

另請參閱

• GetUtcOffset