DateTime.MinValue, champ

La valeur de cette constante équivaut à 00:00:00.0000000, le 1er janvier 0001.

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

// 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 propriétés MinValue et MaxValue permettent de vérifier qu'une valeur est comprise dans la plage prise en charge avant de la passer à un constructeur DateTime. Le code qui se trouve dans la section Exemple illustre cette utilisation.

L'exemple suivant instancie un objet DateTime en passant à son constructeur une valeur Int64 qui représente un nombre de graduations. Avant d'appeler le constructeur, l'exemple vérifie 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, elle lève une 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.

.NET Framework

.NET Framework Client Profile

Bibliothèque de classes portable

.NET pour les applications du Windows Store

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence