DateTimeOffset.Inequality(DateTimeOffset, DateTimeOffset) 運算子

定義

命名空間:

System

組件:

System.Runtime.dll

組件:

mscorlib.dll

組件:

netstandard.dll

判斷兩個指定的 DateTimeOffset 物件是否參照不同的時間點。

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

參數

left

DateTimeOffset

要比較的第一個物件。

right

DateTimeOffset

要比較的第二個物件。

傳回

Boolean

如果 left 和 right 不具有相同的 UtcDateTime 值，則為 true，否則為 false。

備註

方法 Inequality 會定義物件的不等比較運算子運算 DateTimeOffset 。 它一律會從 Equality 傳回相反的結果。 方法 Inequality 會啟用如下的程式碼：

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

在 left 評估 和 right 運算元是否相等之前，運算子會將這兩個值轉換為國際標準時間 (UTC) 。 此作業相當於下列專案：

return first.UtcDateTime == second.UtcDateTime;

first.UtcDateTime = second.UtcDateTime

Return first.UtcDateTime = second.UtcDateTime

換句話說， Inequality 方法會判斷這兩 DateTimeOffset 個物件是否代表不同的時間點。 它會直接比較日期和時間和位移。

不支援自訂運算子的語言可以改為呼叫 Compare 方法。 此外，某些語言也可以直接呼叫 Inequality 方法，如下列範例所示。

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

這個運算子的對等方法為 DateTimeOffset.Compare(DateTimeOffset, DateTimeOffset)