TimeZone.ToUniversalTime(DateTime) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
返回对应于指定时间的协调世界时 (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 对象,其值为对应于 time
的协调世界时 (UTC)。
注解
如果本地时区观察到夏令时, ToUniversalTime 请在执行转换时将 time
当前调整规则应用于参数。
备注
该方法 ToUniversalTime 仅识别本地时区的当前夏令时调整规则。 因此,保证仅在最新调整规则生效的时间段内准确返回与特定本地时间相对应的协调世界时 (UTC) 。 如果 time
某个历史日期和时间值受以前的调整规则的约束,它可能会返回不准确的结果。
time
如果参数是一个不明确的时间,该方法假定它是标准时间。 (一个不明确的时间是可以映射到标准时间或本地时区的夏令时。) 如果 time
时间无效,该方法只会从本地时区的 UTC 偏移量中减去本地时间以返回 UTC。 (由于夏令时调整规则的应用,无效的时间不存在。)
由于解释与当前系统上的当前时区有关,因此 time
如果应用程序在不同的计算机上运行,或者在同一台具有不同时区的计算机上运行,则此方法返回的日期和时间可能有所不同。 对于日期和时间值必须表示单个明确时间点的情况,请使用一个 DateTimeOffset 值来表示本地时间。
该方法 ToUniversalTime 对应于 TimeZoneInfo.ConvertTimeToUtc(DateTime) 方法重载, DateTime 其 Kind 属性不相等 DateTimeKind.Utc的参数。 尽可能使用 TimeZoneInfo.ConvertTimeToUtc(DateTime) 方法重载。