DateTime.MinValue Pole

Definice

Představuje nejmenší možnou hodnotu objektu DateTime. Toto pole je jen ke čtení.

C#
public static readonly DateTime MinValue;

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 zaškrtnutí. 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á 00:00:00.0000000 UTC, 1. ledna 0001 v gregoriánském kalendáři.

MinValue definuje datum a čas přiřazené neinicializované DateTime proměnné. Toto dokládá následující příklad.

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

Vlastnosti MinValue a MaxValue lze použít k zajištění, že hodnota leží v podporovaném rozsahu před předáním do konstruktoru DateTime . Toto použití znázorňuje kód v části Příklad.

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