TimeZone.ToLocalTime(DateTime) 方法

定义

命名空间:
System
程序集:
netstandard.dll, System.Runtime.dll
程序集:
System.Runtime.dll
程序集:
mscorlib.dll
程序集:
netstandard.dll
Source:
TimeZone.cs
Source:
TimeZone.cs
Source:
TimeZone.cs
Source:
TimeZone.cs
Source:
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 参数 Behavior 返回值
协调世界时（UTC）时间（DateTimeKind.Utc）。 将时间从 UTC 转换为本地时间。 一个 DateTime 对象，其值为对应于 time的本地时间。
本地时间（DateTimeKind.Local）。 无需转换。 参数表示DateTime的相同time值。
未指定的时间（DateTimeKind.Unspecified）。 假定时间为 UTC，并将其从 UTC 转换为本地时间。 一个 DateTime 对象，其值为对应于 time的本地时间。

如果本地时区遵守夏令时， ToLocalTime 请在执行转换时应用当前调整规则 time 。

注释

该方法 ToLocalTime 仅识别本地时区的当前夏令时调整规则。 因此，保证仅在最新调整规则生效的时间段内准确返回对应于特定 UTC 时间的本地时间。 如果 time 某个历史日期和时间值受以前的调整规则约束，则它可能会返回不准确的结果。

该方法 ToLocalTime 对应于 TimeZoneInfo.ConvertTimeFromUtc 其 destinationTimeZone 参数设置为 TimeZoneInfo.Local.. 尽可能使用 TimeZoneInfo.ConvertTimeFromUtc 该方法。

继承者说明

尽管这不是必需的，但在大多数情况下，派生类应替代此方法的默认实现。 默认实现的行为取决于 Kind 参数的属性 time 。 如果值为 Local，此方法将 time 返回不变。 如果此方法的值为 UtcUnspecifiedUTC， time 并且不调用 GetUtcOffset(DateTime) 该方法，则将其转换为本地系统时间。

适用于

另请参阅