TimeZoneInfo.BaseUtcOffset 屬性
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得目前時區標準時間與國際標準時間 (UTC) 的時差。
public:
property TimeSpan BaseUtcOffset { TimeSpan get(); };
public TimeSpan BaseUtcOffset { get; }
member this.BaseUtcOffset : TimeSpan
Public ReadOnly Property BaseUtcOffset As 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 小時 (的時區 UTC) 。 早于 UTC 的時區有正位移;UTC 後方的時區會有負位移。
此值 BaseUtcOffset 會以整分鐘數表示。 它不能包含小數分鐘數。
注意
因為 BaseUtcOffset 是 物件的 屬性 TimeZoneInfo ,而不是 TimeZoneInfo.AdjustmentRule 物件,所以 TimeZoneInfo 類別會將從 UTC 的單一位移套用到所有時區的調整。 若要反映已修改其與 UTC 位移的時區,您必須使用 CreateCustomTimeZone 方法來建立新的時區。
屬性 BaseUtcOffset 與 方法不同 GetUtcOffset ,方式如下:
屬性會 BaseUtcOffset 傳回 UTC 與時區標準時間之間的差異; GetUtcOffset 方法會傳回 UTC 與時區在特定時間點之間的差異。
方法 GetUtcOffset 會反映將任何調整規則套用至時區; BaseUtcOffset 屬性則不會。
產品 | 版本 |
---|---|
.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, 8, 9 |
.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, 4.8.1 |
.NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
UWP | 10.0 |