DateTimeOffset.MaxValue 欄位

定義

命名空間:

System

組件:

System.Runtime.dll

來源:

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 超出範圍，因為它比轉換為 UTC 時晚 MaxValue 一小時。

某些行事曆，例如 UmAlQuraCalendar ，支援早于 MaxValue 的上限日期範圍。 在這些情況下，嘗試存取 MaxValue 變數指派或格式化和剖析作業可能會擲回 ArgumentOutOfRangeException 。 您可以擷取 DateTime.MaxValue 指定文化特性之最新有效日期值的值，而不是擷 Calendar.MaxSupportedDateTime 取 的值。