DateTimeOffset.Equality(DateTimeOffset, DateTimeOffset) Operador

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

DateTimeOffset.cs

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

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

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

static member ( = ) : DateTimeOffset * DateTimeOffset -> bool

Public Shared Operator == (left As DateTimeOffset, right As DateTimeOffset) As Boolean

Parâmetros

left

DateTimeOffset

O primeiro objeto a ser comparado.

right

DateTimeOffset

O segundo objeto a ser comparado.

Retornos

Boolean

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

let date1 =
    DateTimeOffset(2007, 6, 3, 14, 45, 0, TimeSpan(-7, 0, 0))

let date2 =
    DateTimeOffset(2007, 6, 3, 15, 45, 0, TimeSpan(-6, 0, 0))

let date3 =
    DateTimeOffset(date1.DateTime, TimeSpan(-6, 0, 0))

printfn $"{date1 = date2}" // Displays True
printfn $"{date1 = date3}" // Displays False

Dim date1 As New DateTimeOffset(#6/3/2007 2:45PM#, _
             New TimeSpan(-7, 0, 0))
Dim date2 As New DateTimeOffset(#6/3/2007 3:45PM#, _
             New TimeSpan(-6, 0, 0))
Dim date3 As 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;

first.UtcDateTime = second.UtcDateTime

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)

Confira também

• Equals