TimeZone.ToUniversalTime(DateTime) 方法

定义

返回对应于指定时间的协调世界时 (UTC)。

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

参数

time
DateTime

日期和时间。

返回

DateTime

一个 DateTime 对象,其值为对应于 time 的协调世界时 (UTC)。

注解

如果本地时区观察到夏令时, ToUniversalTime 请在执行转换时将 time 当前调整规则应用于参数。

备注

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

time如果参数是一个不明确的时间,该方法假定它是标准时间。 (一个不明确的时间是可以映射到标准时间或本地时区的夏令时。) 如果 time 时间无效,该方法只会从本地时区的 UTC 偏移量中减去本地时间以返回 UTC。 (由于夏令时调整规则的应用,无效的时间不存在。)

由于解释与当前系统上的当前时区有关,因此 time 如果应用程序在不同的计算机上运行,或者在同一台具有不同时区的计算机上运行,则此方法返回的日期和时间可能有所不同。 对于日期和时间值必须表示单个明确时间点的情况,请使用一个 DateTimeOffset 值来表示本地时间。

该方法 ToUniversalTime 对应于 TimeZoneInfo.ConvertTimeToUtc(DateTime) 方法重载, DateTimeKind 属性不相等 DateTimeKind.Utc的参数。 尽可能使用 TimeZoneInfo.ConvertTimeToUtc(DateTime) 方法重载。

适用于

另请参阅