DateTime.MinValue Поле

Определение

Пространство имен:

System

Сборки:

netstandard.dll, System.Runtime.dll

Исходный код:

DateTime.cs

Представляет минимально допустимое значение типа DateTime. Это поле доступно только для чтения.

C#

public static readonly DateTime MinValue;

Значение поля

DateTime

Примеры

В следующем примере создается экземпляр объекта путем DateTime передачи его конструктору Int64 значения, представляющего несколько тактов. Перед вызовом конструктора в примере гарантируется, что это значение больше или равно DateTime.MinValue.Ticks и меньше или равно DateTime.MaxValue.Ticks. В противном случае создается исключение 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.

Комментарии

Значение этой константы эквивалентно 00:00:00.0000000 UTC 1 января 0001 г. в григорианском календаре.

MinValue определяет дату и время, назначенные неинициализированной DateTime переменной. Это показано в следующем примере.

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)

Свойства MinValue и MaxValue можно использовать, чтобы убедиться, что значение находится в поддерживаемом диапазоне, прежде чем передавать его конструктору DateTime . Код в разделе Пример иллюстрирует это использование.

Применяется к