DateTime.MaxValue DateTime.MaxValue DateTime.MaxValue DateTime.MaxValue Field

定義

DateTime の最大有効値を表します。Represents the largest possible value of DateTime. このフィールドは読み取り専用です。This field is read-only.

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

フィールド値

次の例では、インスタンス化、DateTimeコンス トラクターに渡して、オブジェクト、Int64タイマー刻みの数を表す値です。The following example instantiates a DateTime object by passing its constructor an Int64 value that represents a number of ticks. この値より大きいまたは等しいが例では、コンス トラクターを呼び出す前にによりDateTime.MinValue.Ticks以下と等しい、DateTime.MaxValue.Ticksします。Before invoking the constructor, the example ensures that this value is greater than or equal to DateTime.MinValue.Ticks and less than or equal to DateTime.MaxValue.Ticks. そうでないをスローした場合、ArgumentOutOfRangeExceptionします。If not, it throws an 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) 12 月 31 日 9999 グレゴリオ暦の 00時 00分: 00 UTC、10000 1 月 1 日の前に 1 つの 100 ナノ秒タイマー刻みで。The value of this constant is equivalent to 23:59:59.9999999 UTC, December 31, 9999 in the Gregorian calendar, exactly one 100-nanosecond tick before 00:00:00 UTC, January 1, 10000.

などの一部の暦、ThaiBuddhistCalendarより前である日付範囲をサポートしてMaxValueします。Some calendars, such as the ThaiBuddhistCalendar, support an upper date range that is earlier than MaxValue. このような場合にアクセスしようとしてMaxValue変数の代入、または書式設定と解析操作ではスロー、ArgumentOutOfRangeExceptionします。In these cases, trying to access MaxValue in variable assignments or formatting and parsing operations can throw an ArgumentOutOfRangeException. 値を取得するのではなくDateTime.MaxValue、最新の有効な日付値を指定したカルチャの値を取得することができます、Calendar.MaxSupportedDateTimeプロパティ。Rather than retrieving the value of DateTime.MaxValue, you can retrieve the value of the specified culture's latest valid date value from the Calendar.MaxSupportedDateTime property.

適用対象

こちらもご覧ください