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

Partilhar via