DateTimeOffset.Equality(DateTimeOffset, DateTimeOffset) Operador

Definição

Determina se dois objetos DateTimeOffset especificados representam o mesmo ponto no tempo.

public static bool operator == (DateTimeOffset left, DateTimeOffset right);

Parâmetros

left
DateTimeOffset

O primeiro objeto a ser comparado.

right
DateTimeOffset

O segundo objeto a ser comparado.

Retornos

true se ambos os objetos DateTimeOffset tiverem o mesmo valor UtcDateTime; caso contrário, false.

Comentários

O Equality método define a operação do operador de igualdade para DateTimeOffset objetos. Ele permite que o código seja o seguinte:

DateTimeOffset date1 = new DateTimeOffset(2007, 6, 3, 14, 45, 0,
             new TimeSpan(-7, 0, 0));
DateTimeOffset date2 = new DateTimeOffset(2007, 6, 3, 15, 45, 0,
             new TimeSpan(-6, 0, 0));
DateTimeOffset date3 = new DateTimeOffset(date1.DateTime,
             new TimeSpan(-6, 0, 0));
Console.WriteLine(date1 == date2);        // Displays True
Console.WriteLine(date1 == date3);        // Displays False

Antes de avaliar os left operandos e right para igualdade, o operador converte os dois valores em UTC (Tempo Universal Coordenado). A operação é equivalente ao seguinte:

return first.UtcDateTime == second.UtcDateTime;

Em outras palavras, o Equality método determina se os dois DateTimeOffset objetos representam um único ponto no tempo. Ele não compara diretamente datas e horas nem deslocamentos. Para determinar se dois objetos DateTimeOffset representam a mesma hora e têm o mesmo valor de deslocamento, use o método EqualsExact.

O método equivalente para esse operador é DateTimeOffset.Equals(DateTimeOffset, DateTimeOffset)

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, 8, 9
.NET Framework 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, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Confira também