DateTimeOffset.MaxValue 字段

定义

命名空间:

System

程序集:

System.Runtime.dll

Source:

DateTimeOffset.cs

表示 DateTimeOffset 的最大可能值。 此字段为只读。

public: static initonly DateTimeOffset MaxValue;

public static readonly DateTimeOffset MaxValue;

 staticval mutable MaxValue : DateTimeOffset

Public Shared ReadOnly MaxValue As DateTimeOffset 

字段值

DateTimeOffset

例外

ArgumentOutOfRangeException

DateTime.MaxValue 超出了当前或指定区域性的默认日历的范围。

注解

此常量的值为 12/31/9999 11：59：59 PM +00：00。

属性 MaxValue 用于确定新 DateTimeOffset 对象的值或 DateTimeOffset 算术运算返回的值是否与此最大范围值相同或早于此最大范围值。 否则，该方法将 ArgumentOutOfRangeException引发 。 在 方法将其与 MaxValue进行比较之前，任何DateTimeOffset值都转换为协调世界时 (UTC) 。 这意味着 DateTimeOffset 其日期和时间接近最大范围但偏移量为负的值可能会引发异常。 例如，值 12/31/9999 11：00 PM -02：00 超出范围，因为它比 MaxValue 转换为 UTC 时晚一小时。

某些日历（如 UmAlQuraCalendar）支持早于 MaxValue的日期范围。 在这些情况下，尝试在变量赋值或格式设置和分析操作中访问 MaxValue 可能会引发 ArgumentOutOfRangeException。 可以从 属性中检索指定区域性的最新有效日期值Calendar.MaxSupportedDateTime的值，而不是检索 DateTime.MaxValue的值。