DateTime.MaxValue フィールド

定義

DateTime の最大有効値を表します。 このフィールドは読み取り専用です。

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

フィールド値

DateTime

次の例では、 DateTime Int64 タイマー刻みの数を表す値をコンストラクターに渡すことによって、オブジェクトをインスタンス化します。 この例では、コンストラクターを呼び出す前に、この値が次の値以上であることを確認し DateTime.MinValue.Ticks DateTime.MaxValue.Ticks ます。 そうでない場合は、をスロー ArgumentOutOfRangeException します。

// Attempt to assign an out-of-range value to a DateTime constructor.
long numberOfTicks = Int64.MaxValue;
DateTime validDate;

// Validate the value.
if (numberOfTicks >= DateTime.MinValue.Ticks &&
    numberOfTicks <= DateTime.MaxValue.Ticks)
   validDate = new DateTime(numberOfTicks);
else if (numberOfTicks < DateTime.MinValue.Ticks)
   Console.WriteLine("{0:N0} is less than {1:N0} ticks.",
                     numberOfTicks,
                     DateTime.MinValue.Ticks);
else
   Console.WriteLine("{0:N0} is greater than {1:N0} ticks.",
                     numberOfTicks,
                     DateTime.MaxValue.Ticks);
// The example displays the following output:
//   9,223,372,036,854,775,807 is greater than 3,155,378,975,999,999,999 ticks.
' Attempt to assign an out-of-range value to a DateTime constructor.
Dim numberOfTicks As Long = Int64.MaxValue
Dim validDate As Date

' Validate the value.
If numberOfTicks >= Date.MinValue.Ticks And _
   numberOfTicks <= Date.MaxValue.Ticks Then
   validDate = New Date(numberOfTicks)
ElseIf numberOfTicks < Date.MinValue.Ticks Then
   Console.WriteLine("{0:N0} is less than {1:N0} ticks.", 
                     numberOfTicks, 
                     DateTime.MinValue.Ticks)      
Else                                                   
   Console.WriteLine("{0:N0} is greater than {1:N0} ticks.", 
                     numberOfTicks, 
                     DateTime.MaxValue.Ticks)     
End If
' The example displays the following output:
'   9,223,372,036,854,775,807 is greater than 3,155,378,975,999,999,999 ticks.

注釈

この定数の値は、グレゴリオ暦の 23:59: 59.9999999 UTC、9999年12月31日に相当します。これは、00:00:00 UTC (1 月 1万1日) の前に正確に 1 100 ナノ秒ティックを示します。

などの一部のカレンダーで ThaiBuddhistCalendar は、よりも前の日付の範囲がサポートされて MaxValue います。 このような場合 MaxValue は、変数の代入や書式設定および解析操作でにアクセスしようとすると、がスローされることが ArgumentOutOfRangeException あります。 の値を取得するのではなく DateTime.MaxValue 、指定したカルチャの有効な日付値の値をプロパティから取得でき Calendar.MaxSupportedDateTime ます。

適用対象

こちらもご覧ください