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

Определение

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

System

Сборка:

System.Runtime.dll

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

DateTime.cs

Сравнивает два экземпляра объекта 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

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

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

Int32

Число со знаком, обозначающее относительные значения параметров 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 , что объекты представляют время в одном часовом поясе.

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

• CompareTo(Object)
• Equals(Object)