DateTimeOffset.MaxValue 字段

定义

命名空间:

System

程序集:

System.Runtime.dll

程序集:

mscorlib.dll

程序集:

netstandard.dll

表示 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。 任何 DateTimeOffset 值都转换为协调世界时 (UTC) ，然后该方法将其与 MaxValue它进行比较。 这意味着 DateTimeOffset 日期和时间接近最大范围但偏移量为负的值可能会引发异常。 例如，值 12/31/9999 11：00 PM -02：00 超出范围，因为它比 MaxValue 转换为 UTC 时晚一小时。

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