DateTimeOffset.Inequality(DateTimeOffset, DateTimeOffset) Operador

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

DateTimeOffset.cs

Determina se dois objetos DateTimeOffset especificados referem-se a diferentes pontos no tempo.

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

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

static member op_Inequality : 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 left e right não têm o mesmo valor UtcDateTime; caso contrário, false.

Comentários

O Inequality método define a operação do operador de desigualdade para DateTimeOffset objetos . Ele sempre retorna o resultado oposto de Equality. O Inequality método habilita o código como 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 False
Console.WriteLine(date1 != date3);        // Displays True

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 False
printfn $"{date1 <> date3}" // Displays True

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 False
Console.WriteLine(date1 <> date3)        ' Displays True

Antes de avaliar os left operandos e right quanto à 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 Inequality método determina se os dois DateTimeOffset objetos representam pontos diferentes no tempo. Ele não compara diretamente datas e horas nem deslocamentos.

Linguagens que não dão suporte a operadores personalizados podem chamar o método Compare em vez disso. Além disso, alguns idiomas também podem chamar o Inequality método diretamente, como mostra o exemplo a seguir.

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(-7, 0, 0))
Dim date3 As New DateTimeOffset(date1.DateTime, _
             New TimeSpan(-6, 0, 0))
Dim date4 As DateTimeOffset = date1
Console.WriteLine( _
    DateTimeOffset.op_Inequality(date1, date2))   ' Displays True
Console.WriteLine( _
    DateTimeOffset.op_Inequality(date1, date3))   ' Displays True
Console.WriteLine( _
    DateTimeOffset.op_Inequality(date1, date4))   ' Displays False

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