DateTime.MaxValue Pole

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Zdroj:

DateTime.cs

Představuje největší možnou hodnotu .DateTime Toto pole je jen ke čtení.

public: static initonly DateTime MaxValue;

public static readonly DateTime MaxValue;

 staticval mutable MaxValue : DateTime

Public Shared ReadOnly MaxValue As DateTime 

Hodnota pole

DateTime

Příklady

Následující příklad vytvoří instanci objektu DateTime předáním jeho konstruktoru Int64 hodnotu, která představuje počet značek. Před vyvoláním konstruktoru příklad zajistí, že je tato hodnota větší nebo rovna DateTime.MinValue.Ticks a menší než nebo rovna DateTime.MaxValue.Ticks. Pokud ne, vyvolá .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.

Poznámky

Hodnota této konstanty odpovídá hodnotě 23:59:59.9999999 UTC, 31. prosince 9999 v gregoriánském kalendáři, přesně jeden 100-nanosekundový interval před 00:00:00 UTC, 1. ledna 10000.

Některé kalendáře, například ThaiBuddhistCalendar, podporují horní rozsah kalendářních dat, který je starší než MaxValue. V těchto případech může pokus o přístup MaxValue k přiřazení proměnných nebo operací formátování a parsování vyvolat výjimku ArgumentOutOfRangeException. Místo načtení hodnoty DateTime.MaxValuemůžete z vlastnosti načíst hodnotu poslední platné hodnoty data pro zadanou Calendar.MaxSupportedDateTime jazykovou verzi.

Viz také

• MinValue