DateTime.MinValue 필드

정의

DateTime의 가능한 최소값을 나타냅니다.Represents the smallest possible value of DateTime. 이 필드는 읽기 전용입니다.This field is read-only.

public: static initonly DateTime MinValue;
public static readonly DateTime MinValue;
 staticval mutable MinValue : DateTime
Public Shared ReadOnly MinValue 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을 throw 합니다.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.      

설명

이 상수의 값은 그레고리오력에서 0001 00:00:00.0000000 UTC에 1 월 1 일에 해당 합니다.The value of this constant is equivalent to 00:00:00.0000000 UTC, January 1, 0001, in the Gregorian calendar.

MinValue 초기화 되지 않은 DateTime 변수에 할당 된 날짜 및 시간을 정의 합니다.MinValue defines the date and time that is assigned to an uninitialized DateTime variable. 다음은 이에 대한 예입니다.The following example illustrates this.

// Define an uninitialized date.
DateTime date1 = new DateTime();
Console.Write(date1);
if (date1.Equals(DateTime.MinValue))
   Console.WriteLine("  (Equals Date.MinValue)");
// The example displays the following output:
//    1/1/0001 12:00:00 AM  (Equals Date.MinValue)
' Define an uninitialized date.
Dim date1 As Date
Console.Write(date1)
If date1.Equals(Date.MinValue) Then _
   Console.WriteLine("  (Equals Date.MinValue)")
' The example displays the following output:
'    1/1/0001 12:00:00 AM  (Equals Date.MinValue)

MinValueMaxValue 속성은 값이 지원 되는 범위 내에 있는지 확인 하는 데 사용할 수 있으며,이 값을 DateTime 생성자에 전달 합니다.The MinValue and MaxValue properties can be used to ensure that a value lies within the supported range before passing it to a DateTime constructor. 예제 섹션의 코드는이 사용법을 보여 줍니다.The code in the Example section illustrates this usage.

적용 대상