导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

DateTimeOffset.Equals 方法 (DateTimeOffset)

2013/12/13

确定当前的 DateTimeOffset 对象是否与指定的 DateTimeOffset 对象表示同一时间点。

Namespace:  System
程序集:  mscorlib(位于 mscorlib.dll 中)

public bool Equals(
	DateTimeOffset other
)

参数

other
类型: System.DateTimeOffset
要与当前 DateTimeOffset 对象进行比较的对象。

返回值

类型: System.Boolean
如果两个 DateTimeOffset 对象具有相同的 UtcDateTime 值,则为 true;否则为 false

实现

IEquatable<T>.Equals(T)

在执行比较之前,此方法会将这两个 DateTimeOffset 对象的值转换为协调世界时 (UTC)。此方法与下列代码功能等效:


return this.UtcDateTime == other.UtcDateTime;


换言之,Equals(DateTimeOffset) 方法决定两个 DateTimeOffset 对象是否表示同一时间点。它既不直接比较日期和时间,也不直接比较偏移量。若要确定两个 DateTimeOffset 对象是否表示相同时间以及是否具有相同的偏移量值,请使用 EqualsExact 方法。

值不为 nullDateTimeOffset 对象被认为是晚于(或大于)值为 null 的对象。

Equals(DateTimeOffset) 方法的此重载将实现 IEquatable<T>.Equals 方法。它的执行效果略好于 DateTimeOffset.Equals(Object) 重载,因为不必从对象中转换 other 参数。

下面的示例演示如何调用 Equals(DateTimeOffset) 方法来测试 DateTimeOffset 对象是否与当前 DateTimeOffset 对象相等。


private static void CompareForEquality1(System.Windows.Controls.TextBlock outputBlock)
{
   DateTimeOffset firstTime = new DateTimeOffset(2007, 9, 1, 6, 45, 0,
                              new TimeSpan(-7, 0, 0));

   DateTimeOffset secondTime = firstTime;
   outputBlock.Text += String.Format("{0} = {1}: {2}",
                     firstTime, secondTime,
                     firstTime.Equals(secondTime)) + "\n";

   secondTime = new DateTimeOffset(2007, 9, 1, 6, 45, 0,
                    new TimeSpan(-6, 0, 0));
   outputBlock.Text += String.Format("{0} = {1}: {2}",
                    firstTime, secondTime,
                    firstTime.Equals(secondTime)) + "\n";

   secondTime = new DateTimeOffset(2007, 9, 1, 8, 45, 0,
                    new TimeSpan(-5, 0, 0));
   outputBlock.Text += String.Format("{0} = {1}: {2}",
                    firstTime, secondTime,
                    firstTime.Equals(secondTime)) + "\n";
   // The example displays the following output:
   //      9/1/2007 6:45:00 AM -07:00 = 9/1/2007 6:45:00 AM -07:00: True
   //      9/1/2007 6:45:00 AM -07:00 = 9/1/2007 6:45:00 AM -06:00: False
   //      9/1/2007 6:45:00 AM -07:00 = 9/1/2007 8:45:00 AM -05:00: True       


Windows Phone OS

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

显示:
© 2014 Microsoft