Auf Englisch lesen

Freigeben über


DateTime.MinValue Feld

Definition

Stellt den kleinstmöglichen Wert von DateTime dar. Dieses Feld ist schreibgeschützt.

public static readonly DateTime MinValue;

Feldwert

Beispiele

Im folgenden Beispiel wird ein DateTime Objekt instanziiert, indem dem Konstruktor ein Int64 Wert übergeben wird, der eine Anzahl von Ticks darstellt. Vor dem Aufrufen des Konstruktors stellt das Beispiel sicher, dass dieser Wert größer oder gleich DateTime.MinValue.Ticks und kleiner als oder gleich DateTime.MaxValue.Ticksist. Andernfalls wird ein ArgumentOutOfRangeExceptionausgelöst.

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

Hinweise

Der Wert dieser Konstante entspricht 00:00:00:00.000000 UTC, 1. Januar 0001 im gregorianischen Kalender.

MinValue definiert das Datum und die Uhrzeit, die einer nicht initialisierten DateTime Variablen zugewiesen sind. Dies wird anhand des folgenden Beispiels veranschaulicht.

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

Die MinValue Eigenschaften und MaxValue können verwendet werden, um sicherzustellen, dass ein Wert innerhalb des unterstützten Bereichs liegt, bevor er an einen DateTime Konstruktor übergeben wird. Der Code im Abschnitt Beispiel veranschaulicht diese Verwendung.

Gilt für:

Produkt Versionen
.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
.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