DateTimeOffset.CompareTo(DateTimeOffset) Método

Definição

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Origem:

DateTimeOffset.cs

Compara o objeto DateTimeOffset atual a um objeto DateTimeOffset especificado e indica se o objeto atual é anterior, o mesmo ou posterior ao segundo objeto DateTimeOffset.

C#

public int CompareTo(DateTimeOffset other);

Parâmetros

other

DateTimeOffset

Um objeto a ser comparado com o objeto DateTimeOffset atual.

Retornos

Int32

Um inteiro com sinal que indica o relacionamento entre o objeto DateTimeOffset atual e other, conforme mostrado na tabela a seguir.

Valor de retorno	Descrição
Menor que zero	O objeto DateTimeOffset atual é anterior a other.
Zero	O objeto DateTimeOffset atual é o mesmo que other.
Maior que zero.	O objeto DateTimeOffset atual é posterior a other.

Implementações

CompareTo(T)

Exemplos

O exemplo a seguir ilustra as chamadas ao CompareTo método para comparar DateTimeOffset objetos.

C#

using System;

public class CompareTimes
{
   private enum TimeComparison
   {
      Earlier = -1,
      Same = 0,
      Later = 1
   };

   public static void Main()
   {
      DateTimeOffset firstTime = new DateTimeOffset(2007, 9, 1, 6, 45, 0,
                                 new TimeSpan(-7, 0, 0));

      DateTimeOffset secondTime = firstTime;
      Console.WriteLine("Comparing {0} and {1}: {2}",
                        firstTime, secondTime,
                        (TimeComparison) firstTime.CompareTo(secondTime));

      secondTime = new DateTimeOffset(2007, 9, 1, 6, 45, 0,
                       new TimeSpan(-6, 0, 0));
      Console.WriteLine("Comparing {0} and {1}: {2}",
                       firstTime, secondTime,
                       (TimeComparison) firstTime.CompareTo(secondTime));

      secondTime = new DateTimeOffset(2007, 9, 1, 8, 45, 0,
                       new TimeSpan(-5, 0, 0));
      Console.WriteLine("Comparing {0} and {1}: {2}",
                       firstTime, secondTime,
                       (TimeComparison) firstTime.CompareTo(secondTime));
      // The example displays the following output to the console:
      //       Comparing 9/1/2007 6:45:00 AM -07:00 and 9/1/2007 6:45:00 AM -07:00: Same
      //       Comparing 9/1/2007 6:45:00 AM -07:00 and 9/1/2007 6:45:00 AM -06:00: Later
      //       Comparing 9/1/2007 6:45:00 AM -07:00 and 9/1/2007 8:45:00 AM -05:00: Same
   }
}

Comentários

Esse método compara objetos DateTimeOffset comparando seus UtcDateTime valores; ou seja, determina se os dois objetos representam um único ponto no tempo e indica se o objeto atual é anterior, posterior ou igual ao other parâmetro .

Aplica-se a