DateTime.Compare(DateTime, DateTime) Метод

Определение

Сравнивает два экземпляра объекта DateTime и возвращает целое число, которое показывает, предшествует ли первый экземпляр второму, совпадает или расположен позже.

public static int Compare (DateTime t1, DateTime t2);

Параметры

t1
DateTime

Первый из сравниваемых объектов.

t2
DateTime

Второй из сравниваемых объектов.

Возвращаемое значение

Число со знаком, обозначающее относительные значения параметров t1 и t2.

Тип значения Условие
Меньше нуляМомент, указанный в параметре t1, наступает раньше, чем момент, указанный в параметре t2.
НульПараметр t1 совпадает с параметром t2.
Больше нуляМомент, указанный в параметре t1, наступает позже, чем момент, указанный в параметре t2.

Примеры

В следующем примере демонстрируется Compare метод.

DateTime date1 = new DateTime(2009, 8, 1, 0, 0, 0);
DateTime date2 = new DateTime(2009, 8, 1, 12, 0, 0);
int result = DateTime.Compare(date1, date2);
string relationship;

if (result < 0)
   relationship = "is earlier than";
else if (result == 0)
   relationship = "is the same time as";
else
   relationship = "is later than";

Console.WriteLine("{0} {1} {2}", date1, relationship, date2);

// The example displays the following output for en-us culture:
//    8/1/2009 12:00:00 AM is earlier than 8/1/2009 12:00:00 PM

Комментарии

Чтобы определить связь t1 с , метод сравнивает Ticks свойство t1 и , t2Compare но игнорирует их Kindt2свойство. Перед сравнением объектов убедитесь DateTime , что объекты представляют время в одном часовом поясе.

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

Продукт Версии
.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

См. также раздел