DateTimeOffset.MaxValue 字段

定义

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

public: static initonly DateTimeOffset MaxValue;
public static readonly DateTimeOffset MaxValue;
 staticval mutable MaxValue : DateTimeOffset
Public Shared ReadOnly MaxValue As DateTimeOffset 

字段值

DateTimeOffset

例外

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其值。

适用于