DateTime.Compare(DateTime, DateTime) Método

Referência

Definição

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Compara duas instâncias do DateTime e retorna um inteiro que indica se a primeira instância é anterior, a mesma ou posterior à segunda instância.

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

Parâmetros

t1: DateTime

O primeiro objeto a ser comparado.

t2: DateTime

O segundo objeto a ser comparado.

Retornos

Int32

Um número assinado que indica os valores relativos de t1 e t2.

Tipo do Valor	Condição
Menor que zero	`t1` é anterior a `t2`.
Zero	`t1` é o mesmo que `t2`.
Maior que zero	`t1` é posterior a `t2`.

Exemplos

O exemplo a seguir demonstra o Compare método.

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

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

Comentários

Para determinar a relação de t1 com , o método compara a propriedade de e , mas ignora sua t2 Compare Ticks t1 t2 Kind propriedade. Antes de comparar DateTime objetos, verifique se os objetos representam tempos no mesmo fuso horário.

Aplica-se a

Produto	Versões
.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
.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
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Compartilhar via