DateTime.MinValue Campo

Definición

Espacio de nombres:

System

Ensamblados:

netstandard.dll, System.Runtime.dll

Source:

DateTime.cs

Representa el menor valor posible de DateTime. Este campo es de solo lectura.

C#

public static readonly DateTime MinValue;

Valor de campo

DateTime

Ejemplos

En el ejemplo siguiente se crea una instancia de un DateTime objeto pasando su constructor un Int64 valor que representa un número de tics. Antes de invocar el constructor, el ejemplo garantiza que este valor sea mayor o igual que DateTime.MinValue.Ticks y menor o igual que DateTime.MaxValue.Ticks. Si no es así, inicia una ArgumentOutOfRangeExceptionexcepción .

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.

Comentarios

El valor de esta constante equivale a 00:00:00.0000000 UTC, 1 de enero de 0001, en el calendario gregoriano.

MinValue define la fecha y hora que se asigna a una variable sin inicializar DateTime . Esto se ilustra en el siguiente ejemplo:

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)

Las MinValue propiedades y MaxValue se pueden usar para asegurarse de que un valor se encuentra dentro del intervalo admitido antes de pasarlo a un DateTime constructor. El código de la sección Ejemplo ilustra este uso.

Se aplica a