System.TimeZoneInfo.GetAmbiguousTimeOffsets 方法 (DateTimeOffset)
方法描述
返回不明确的日期和时间可能映射到的日期和时间的相关信息。
语法定义(C# System.TimeZoneInfo.GetAmbiguousTimeOffsets 方法 (DateTimeOffset) 的用法)
public TimeSpan[] GetAmbiguousTimeOffsets( DateTimeOffset dateTimeOffset )
参数/返回值
参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
---|---|---|
dateTimeOffset | System-DateTimeOffset | 日期和时间。 |
返回值 | System.TimeSpan[] | 对象的数组,它表示特定日期和时间可以映射到的可能的协调世界时 (UTC) 偏移量。 |
提示和注释
此方法的确切行为取决于 dateTimeOffset 参数的 Offset 属性与 TimeZoneInfo 对象之间的关系。 如果 Offset 属性值对应于当前时区与该日期和时间所对应协调世界时 (UTC) 的可能偏移量,则该方法返回可能的偏移量。 否则,该方法将 dateTime 转换为当前时区中的时间,然后返回该日期和时间的可能偏移量。
尚未定义 TimeSpan 对象在该方法返回的数组中的顺序。 但可以通过比较数组元素值与时区的 BaseUtcOffset 属性,来确定哪个元素表示与时区标准时间的偏移量。 若要将不明确的时间映射至时区的标准时间,请参见如何:解决不明确的时间。
对调用者的说明
在 Windows XP 系统上,此方法仅在确定 dateTimeOffset 是否含糊不清时适用当前调整规则(如果当前实例是 TimeZoneInfo.Local)。 因此,该方法在当前调整规则生效之前可能无法准确转换不明确的时间偏移量。更多信息,请参见 Local 属性中的调用节说明。
System.TimeZoneInfo.GetAmbiguousTimeOffsets 方法 (DateTimeOffset)例子
异常
异常 | 异常描述 |
---|---|
ArgumentException | dateTime 是明确的时间。 |
版本信息
.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 系统要求。