語言

TimeZone.ToLocalTime(DateTime) 方法

定義

命名空間:
System
組件:
netstandard.dll, System.Runtime.dll
組件:
System.Runtime.dll
組件:
mscorlib.dll
組件:
netstandard.dll
來源:
TimeZone.cs
來源:
TimeZone.cs
來源:
TimeZone.cs
來源:
TimeZone.cs
來源:
TimeZone.cs

回傳對應特定日期和時間值的當地時間。

public:
 virtual DateTime ToLocalTime(DateTime time);
public virtual DateTime ToLocalTime(DateTime time);
abstract member ToLocalTime : DateTime -> DateTime
override this.ToLocalTime : DateTime -> DateTime
Public Overridable Function ToLocalTime (time As DateTime) As DateTime

參數

time
DateTime

協調世界時（UTC）時間。

傳回

DateTime

一個 DateTime 物件，其值為對應於 time的當地時間。

備註

下表顯示參數與time此方法回傳值之間的DateTime關係。

time 參數 行為 返回值
協調世界時（UTC）時間（DateTimeKind.Utc）。 將UTC時間轉換為當地時間。 一個 DateTime 物件，其值為對應於 time的當地時間。
當地時間（DateTimeKind.Local）。 不需要轉換。 與參數所代表DateTime的值相同time。
一個未指定的時間（DateTimeKind.Unspecified）。 假設時間為 UTC，並將時間從 UTC 換算為當地時間。 一個 DateTime 物件，其值為對應於 time的當地時間。

若當地時區實行夏令時間， ToLocalTime 則在進行換算時套用當前調整規則 time 。

Note

此 ToLocalTime 方法僅承認當地時區的現行夏令時間調整規則。 因此，它保證只會在最新調整規則生效期間內，準確回傳對應特定 UTC 的當地時間。 若 time 是歷史日期與時間值且受先前調整規則影響，可能會回傳不準確的結果。

該 ToLocalTime 方法對應 TimeZoneInfo.ConvertTimeFromUtc 於參數 destinationTimeZone 設為 TimeZoneInfo.Local的方法。 只要可能，就用這個 TimeZoneInfo.ConvertTimeFromUtc 方法。

給繼承者的注意事項

雖然不是必須的，但在大多數情況下，導出類別應該會覆蓋此方法的預設實作。 預設實作的行為取決於 Kind 參數 time 的性質。 若其值為 Local，則此方法會回傳 time 不變。 若其值為 Utc 或 Unspecified，此方法假設 time 為 UTC，並轉換為當地系統時間而不呼叫該 GetUtcOffset(DateTime) 方法。

適用於

另請參閱