DateTime.MinValue Champ

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

DateTime.cs

Représente la plus petite valeur possible de DateTime. Ce champ est en lecture seule.

C#

public static readonly DateTime MinValue;

Valeur de champ

DateTime

Exemples

L’exemple suivant instancie un DateTime objet en passant à son constructeur une Int64 valeur qui représente un certain nombre de cases. Avant d’appeler le constructeur, l’exemple garantit que cette valeur est supérieure ou égale à DateTime.MinValue.Ticks et inférieure ou égale à DateTime.MaxValue.Ticks. Si ce n’est pas le cas, il lève un 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.

Remarques

La valeur de cette constante équivaut à 00:00:00.00000000 UTC, 1er janvier 0001, dans le calendrier grégorien.

MinValue définit la date et l’heure affectées à une variable non initialisée DateTime . L'exemple suivant illustre ce comportement.

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)

Les MinValue propriétés et MaxValue peuvent être utilisées pour vérifier qu’une valeur se trouve dans la plage prise en charge avant de la transmettre à un DateTime constructeur. Le code de la section Exemple illustre cette utilisation.

S’applique à