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

Определение

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

public:
 static int Compare(DateTime t1, DateTime t2);
public static int Compare (DateTime t1, DateTime t2);
static member Compare : DateTime * DateTime -> int
Public Shared Function Compare (t1 As DateTime, t2 As DateTime) As Integer

Параметры

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
let date1 = DateTime(2009, 8, 1, 0, 0, 0)
let date2 = DateTime(2009, 8, 1, 12, 0, 0)
let result = DateTime.Compare(date1, date2)

let relationship =
    if result < 0 then
        "is earlier than"
    elif result = 0 then
        "is the same time as"
    else
        "is later than"

printfn $"{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
Module Example
   Public Sub Main()
      Dim date1 As Date = #08/01/2009 12:00AM#
      Dim date2 As Date = #08/01/2009 12:00PM#
      Dim result As Integer = DateTime.Compare(date1, date2)
      Dim relationship As String
      
      If result < 0 Then
         relationship = "is earlier than"
      ElseIf result = 0 Then
         relationship = "is the same time as"         
      Else
         relationship = "is later than"
      End If
      
      Console.WriteLine("{0} {1} {2}", date1, relationship, date2)
   End Sub
End Module
' The example displays the following output:
'    8/1/2009 12:00:00 AM is earlier than 8/1/2009 12:00:00 PM

Комментарии

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

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

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