Číst v angličtině

Sdílet prostřednictvím


DateTime.MaxValue Pole

Definice

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

C#
public static readonly DateTime MaxValue;

Hodnota pole

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

C#
// 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.

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.

Platí pro

Produkt Verze
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Viz také