DateTimeOffset.Equality(DateTimeOffset, DateTimeOffset) 演算子

定義

指定された 2 つの DateTimeOffset オブジェクトが、同じ特定の時点を表しているかどうかを判断します。

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

パラメーター

left
DateTimeOffset

比較する最初のオブジェクト。

right
DateTimeOffset

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

戻り値

Boolean

両方の DateTimeOffset オブジェクトが同じ UtcDateTime 値を持つ場合は true。それ以外の場合は false

注釈

このメソッドは Equality 、オブジェクトの等値演算子の操作を DateTimeOffset 定義します。 これにより、次のようなコードが有効になります。

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

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

return first.UtcDateTime == second.UtcDateTime;
first.UtcDateTime = second.UtcDateTime
Return first.UtcDateTime = second.UtcDateTime

言い換えると、このメソッドは Equality 、2 つの DateTimeOffset オブジェクトが 1 つの時点を表すかどうかを判断します。 日付と時刻もオフセットも直接比較しません。 2 つの DateTimeOffset オブジェクトが同じ時間を表し、同じオフセット値を持っているかどうかを判断するには、メソッドを使用します EqualsExact

この演算子の同等のメソッドは次のようになります。 DateTimeOffset.Equals(DateTimeOffset, DateTimeOffset)

適用対象

こちらもご覧ください