DateTimeOffset.Equality(DateTimeOffset, DateTimeOffset) Оператор
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет, представляют ли два заданных объекта 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
Второй из сравниваемых объектов.
Возвращаемое значение
Значение true
, если объекты DateTimeOffset имеют одинаковые значения UtcDateTime; в противном случае — значение 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
Перед вычислением left
и right
операндов для равенства оператор преобразует оба значения в формат UTC. Операция эквивалентна следующей:
return first.UtcDateTime == second.UtcDateTime;
first.UtcDateTime = second.UtcDateTime
Return first.UtcDateTime = second.UtcDateTime
Другими словами, метод определяет, Equality представляют ли два DateTimeOffset объекта одну точку во времени. Он напрямую не сравнивает ни даты, ни время, ни смещения. Чтобы определить, представляют ли два DateTimeOffset объекта одинаковое время и имеют одно и то же значение смещения, используйте EqualsExact метод.
Эквивалентный метод для этого оператора: DateTimeOffset.Equals(DateTimeOffset, DateTimeOffset)