TimeZoneInfo 类

• ClearCachedData 方法
• ConvertTime 方法
• ConvertTime 方法 1
• ConvertTime 方法 2
• ConvertTimeBySystemTimeZoneId 方法
• ConvertTimeBySystemTimeZoneId 方法 1
• ConvertTimeBySystemTimeZoneId 方法 2
• ConvertTimeFromUtc 方法
• ConvertTimeToUtc 方法
• ConvertTimeToUtc 方法 1
• CreateCustomTimeZone 方法
• CreateCustomTimeZone 方法 1
• CreateCustomTimeZone 方法 2
• Equals 方法 1
• FindSystemTimeZoneById 方法
• FromSerializedString 方法
• GetAdjustmentRules 方法
• GetAmbiguousTimeOffsets 方法
• GetAmbiguousTimeOffsets 方法 1
• GetHashCode 方法
• GetSystemTimeZones 方法
• GetUtcOffset 方法
• GetUtcOffset 方法 1
• HasSameRules 方法
• IsAmbiguousTime 方法
• IsAmbiguousTime 方法 1
• IsDaylightSavingTime 方法
• IsDaylightSavingTime 方法 1
• IsInvalidTime 方法
• ToSerializedString 方法
• ToString 方法
• CreateAdjustmentRule 方法
• Equals 方法 1
• GetHashCode 方法

方法描述

将时间从一个时区转换为另一个时区。

语法定义(C# System.TimeZoneInfo.ConvertTime 方法 (DateTime, TimeZoneInfo, TimeZoneInfo) 的用法)

public static DateTime ConvertTime(
	DateTime dateTime,
	TimeZoneInfo sourceTimeZone,
	TimeZoneInfo destinationTimeZone
)

参数/返回值

提示和注释

执行转换时，ConvertTime 方法将有效应用 destinationTimeZone 时区中的任何调整规则。

dateTime 参数的 Kind 属性值必须对应于 sourceTimeZone 参数，如下表所示。

DateTime.Kind 值

sourceTimeZone 值

方法行为

DateTimeKind.Utc

等于 TimeZoneInfo.Utc。

将 dateTime 转换为目标时区的时间。

DateTimeKind.Utc

不等于 TimeZoneInfo.Utc。

引发 ArgumentException。

DateTimeKind.Local

等于 TimeZoneInfo.Local。

将 dateTime 转换为目标时区的时间。

DateTimeKind.Local

不等于 TimeZoneInfo.Local。

引发 ArgumentException。

DateTimeKind.Unspecified

任意。

将 dateTime 转换为目标时区的时间。

您还可以通过调用 ConvertTimeFromUtc 和 ConvertTimeToUtc 方法转换成协调世界时 (UTC) 或从 UTC 进行转换。

如下表所示设置返回的 DateTime 值的 Kind 属性。

Condition

返回的 Kind 属性值

destinationTimeZone 参数为 TimeZoneInfo.Utc。

DateTimeKind.Utc

dateTime 的 Kind 属性为 DateTimeKind.Local，并且 sourceTimeZone 和 destinationTimeZone 都是 DateTimeKind.Local。

DateTimeKind.Local

所有其他日期和时间值、源时区以及目标时区。

DateTimeKind.Unspecified

如果 dateTime 参数值是源时区中的不明确时间，则将该时间解释为标准时间。 如果 dateTime 参数是源时区中的无效时间，则此方法会引发 ArgumentException。

如果 dateTime 的转换结果为早于 DateTime.MinValue 或晚于 DateTime.MaxValue 的日期和时间值，则此方法分别返回 DateTime.MinValue 或 DateTime.MaxValue。

对调用者的说明

在 Windows XP 系统中，如果把 dateTime 视为本地时间，如果 sourceTimeZone 是 TimeZoneInfo.Local，或者如果 destinationTimeZone 是 TimeZoneInfo.Local，那么该方法执行转换时只会应用当前的调整规则。 因此，该方法在当前调整规则生效之前可能无法准确转换时间段。 有关更多信息，请参见 Local 属性中的“调用方说明”一节。

异常

命名空间

namespace: System

程序集: mscorlib（在 mscorlib.dll 中）

版本信息

.NET Framework 受以下版本支持：4、3.5 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。

C# 文件及文件夹操作

C# 文件操作

C# 文件夹操作