다음을 통해 공유


DateTime.MaxValue 필드

정의

DateTime의 가능한 최대값을 나타냅니다. 이 필드는 읽기 전용입니다.

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

필드 값

예제

다음 예제에서는 해당 생성자에 Int64 여러 틱을 나타내는 값을 전달하여 개체를 인스턴스화 DateTime 합니다. 생성자를 호출하기 전에 이 값이 보다 크거나 같 DateTime.MinValue.Ticks 고 보다 작거나 같은지 확인합니다 DateTime.MaxValue.Ticks. 그렇지 않은 경우 을 throw합니다 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.
let numberOfTicks = Int64.MaxValue

// Validate the value.
if numberOfTicks >= DateTime.MinValue.Ticks &&
   numberOfTicks <= DateTime.MaxValue.Ticks then
    let validDate = DateTime numberOfTicks
    ()
elif numberOfTicks < DateTime.MinValue.Ticks then
    printfn $"{numberOfTicks:N0} is less than {DateTime.MinValue.Ticks:N0} ticks."
else
    printfn $"{numberOfTicks:N0} is greater than {DateTime.MaxValue.Ticks:N0} 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.

설명

이 상수의 값은 그레고리오력에서 9999년 12월 31일 UTC 23:59:59.9999999 UTC와 동일하며, 정확히 10000년 1월 1일 00:00:00 UTC 이전의 100나노초 틱입니다.

과 같은 ThaiBuddhistCalendar일부 달력은 보다 MaxValue이전의 상위 날짜 범위를 지원합니다. 이러한 경우 변수 할당 또는 서식 지정 및 구문 분석 작업에서 액세스 MaxValue 하려고 하면 가 throw됩니다 ArgumentOutOfRangeException. 의 값을 DateTime.MaxValue검색하는 대신 속성에서 지정된 문화권의 최신 유효한 날짜 값 값을 검색할 Calendar.MaxSupportedDateTime 수 있습니다.

적용 대상

추가 정보