DateTimeOffset.Inequality(DateTimeOffset, DateTimeOffset) 演算子

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

Source:

DateTimeOffset.cs

指定された 2 つの 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

比較する 2 番目のオブジェクト。

戻り値

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

オペランドと right オペランドのleft等価性を評価する前に、演算子は両方の値を協定世界時 (UTC) に変換します。 この操作は、次の操作と同じです。

return first.UtcDateTime == second.UtcDateTime;

first.UtcDateTime = second.UtcDateTime

Return first.UtcDateTime = second.UtcDateTime

つまり、 メソッドは Inequality 、2 つの 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)