DateTimeOffset.Equals DateTimeOffset.Equals DateTimeOffset.Equals DateTimeOffset.Equals Method

定義

2 つかどうかを判断しますDateTimeOffsetオブジェクトが等しいか、またはDateTimeOffsetオブジェクトが、指定したオブジェクトと等しい。Determines whether two DateTimeOffset objects are equal, or a DateTimeOffset object is equal to a specified object.

オーバーロード

Equals(DateTimeOffset) Equals(DateTimeOffset) Equals(DateTimeOffset) Equals(DateTimeOffset)

決定かどうか、現在DateTimeOffsetオブジェクトが、指定されたのと同じ時点を表してDateTimeOffsetオブジェクト。Determines whether the current DateTimeOffset object represents the same point in time as a specified DateTimeOffset object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

決定かどうかをDateTimeOffsetオブジェクトが、指定されたオブジェクトの同じ時点を表します。Determines whether a DateTimeOffset object represents the same point in time as a specified object.

Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset)

指定した 2 つかどうかを判断しますDateTimeOffsetオブジェクトの同じ時点を表しています。Determines whether two specified DateTimeOffset objects represent the same point in time.

Equals(DateTimeOffset) Equals(DateTimeOffset) Equals(DateTimeOffset) Equals(DateTimeOffset)

決定かどうか、現在DateTimeOffsetオブジェクトが、指定されたのと同じ時点を表してDateTimeOffsetオブジェクト。Determines whether the current DateTimeOffset object represents the same point in time as a specified DateTimeOffset object.

public:
 virtual bool Equals(DateTimeOffset other);
public bool Equals (DateTimeOffset other);
override this.Equals : DateTimeOffset -> bool
Public Function Equals (other As DateTimeOffset) As Boolean

パラメーター

other
DateTimeOffset DateTimeOffset DateTimeOffset DateTimeOffset

現在の DateTimeOffset オブジェクトと比較するオブジェクト。An object to compare to the current DateTimeOffset object.

戻り値

true 両方DateTimeOffsetオブジェクトが同じであるUtcDateTime値。 それ以外の場合、falseします。true if both DateTimeOffset objects have the same UtcDateTime value; otherwise, false.

実装

次の例への呼び出し、Equals(DateTimeOffset)メソッドをテストするDateTimeOffsetオブジェクトの現在の等価性DateTimeOffsetオブジェクト。The following example illustrates calls to the Equals(DateTimeOffset) method to test DateTimeOffset objects for equality with the current DateTimeOffset object.

private static void CompareForEquality1()
{
   DateTimeOffset firstTime = new DateTimeOffset(2007, 9, 1, 6, 45, 0, 
                              new TimeSpan(-7, 0, 0));

   DateTimeOffset secondTime = firstTime;
   Console.WriteLine("{0} = {1}: {2}", 
                     firstTime, secondTime, 
                     firstTime.Equals(secondTime));

   secondTime = new DateTimeOffset(2007, 9, 1, 6, 45, 0, 
                    new TimeSpan(-6, 0, 0));      
   Console.WriteLine("{0} = {1}: {2}", 
                    firstTime, secondTime, 
                    firstTime.Equals(secondTime));

   secondTime = new DateTimeOffset(2007, 9, 1, 8, 45, 0, 
                    new TimeSpan(-5, 0, 0));
   Console.WriteLine("{0} = {1}: {2}", 
                    firstTime, secondTime, 
                    firstTime.Equals(secondTime));
   // The example displays the following output to the console:
   //      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       
Dim firstTime As New DateTimeOffset(#09/01/2007 6:45:00AM#, _
                 New TimeSpan(-7, 0, 0))

Dim secondTime As DateTimeOffset = firstTime
Console.WriteLine("{0} = {1}: {2}", _
                  firstTime, secondTime, _
                  firstTime.Equals(secondTime))

secondTime = New DateTimeOffset(#09/01/2007 6:45:00AM#, _
                 New TimeSpan(-6, 0, 0))      
Console.WriteLine("{0} = {1}: {2}", _
                 firstTime, secondTime, _
                 firstTime.Equals(secondTime))

secondTime = New DateTimeOffset(#09/01/2007 8:45:00AM#, _
                 New TimeSpan(-5, 0, 0))
Console.WriteLine("{0} = {1}: {2}", _
                 firstTime, secondTime, _
                 firstTime.Equals(secondTime))
' The example displays the following output to the console:
'       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

注釈

比較を実行する前に、このメソッドは、両方の値を変換しますDateTimeOffsetオブジェクトを世界協定時刻 (UTC)。Before it performs the comparison, this method converts the values of both DateTimeOffset objects to Coordinated Universal Time (UTC). メソッドは、次のと同等です。The method is equivalent to the following:

return this.UtcDateTime == other.UtcDateTime;
Return Me.UtcDateTime = other.UtcDateTime

つまり、Equals(DateTimeOffset)メソッドは、2 つかどうかを判断します。DateTimeOffsetオブジェクトの 1 つの点を表しています。In other words, the Equals(DateTimeOffset) method determines whether two DateTimeOffset objects represent a single point in time. 日付と時刻もオフセットと直接比較します。It directly compares neither dates and times nor offsets. 2 つかどうかを判断するDateTimeOffsetオブジェクトが同じ時間を表すしを使用して、同じオフセット値を持つ、EqualsExactメソッド。To determine whether two DateTimeOffset objects represent the same time and have the same offset value, use the EqualsExact method.

ADateTimeOffsetないオブジェクトのnull以降 (またはそれ以上) あると見なされますが 1 よりもnullします。A DateTimeOffset object that is not null is considered to be later (or greater) than one that is null.

このオーバー ロード、Equals(DateTimeOffset)メソッドの実装、IEquatable<T>.Equalsメソッド。This overload of the Equals(DateTimeOffset) method implements the IEquatable<T>.Equals method. も若干優れたパフォーマンスを提供、DateTimeOffset.Equals(Object)ため、オーバー ロード、otherパラメーターは、オブジェクトから変換する必要はありません。It offers slightly better performance than the DateTimeOffset.Equals(Object) overload because the other parameter does not have to be converted from an object.

こちらもご覧ください

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

決定かどうかをDateTimeOffsetオブジェクトが、指定されたオブジェクトの同じ時点を表します。Determines whether a DateTimeOffset object represents the same point in time as a specified object.

public:
 override bool Equals(System::Object ^ obj);
public override bool Equals (object obj);
override this.Equals : obj -> bool
Public Overrides Function Equals (obj As Object) As Boolean

パラメーター

obj
Object Object Object Object

現在と比較するオブジェクトDateTimeOffsetオブジェクト。The object to compare to the current DateTimeOffset object.

戻り値

true 場合、objパラメーターは、DateTimeOffsetオブジェクトし、現在の同じ時点を表してDateTimeOffsetオブジェクト。 それ以外の場合、falseします。true if the obj parameter is a DateTimeOffset object and represents the same point in time as the current DateTimeOffset object; otherwise, false.

次の例を示すかどうか、現在DateTimeOffsetオブジェクトが他のいくつかと等しいDateTimeOffset、null 参照にも、オブジェクトDateTimeオブジェクト。The following example indicates whether the current DateTimeOffset object is equal to several other DateTimeOffset objects, as well as to a null reference and a DateTime object.

private static void CompareForEquality2()
{
   DateTimeOffset firstTime = new DateTimeOffset(2007, 9, 1, 6, 45, 0, 
                              new TimeSpan(-7, 0, 0));

   object secondTime = firstTime;
   Console.WriteLine("{0} = {1}: {2}", 
                     firstTime, secondTime, 
                     firstTime.Equals(secondTime));

   secondTime = new DateTimeOffset(2007, 9, 1, 6, 45, 0, 
                    new TimeSpan(-6, 0, 0));      
   Console.WriteLine("{0} = {1}: {2}", 
                    firstTime, secondTime, 
                    firstTime.Equals(secondTime));

   secondTime = new DateTimeOffset(2007, 9, 1, 8, 45, 0, 
                    new TimeSpan(-5, 0, 0));
   Console.WriteLine("{0} = {1}: {2}", 
                    firstTime, secondTime, 
                    firstTime.Equals(secondTime));
                    
   secondTime = null;
   Console.WriteLine("{0} = {1}: {2}", 
                    firstTime, secondTime, 
                    firstTime.Equals(secondTime));

   secondTime = new DateTime(2007, 9, 1, 6, 45, 00);                       
   Console.WriteLine("{0} = {1}: {2}", 
                    firstTime, secondTime, 
                    firstTime.Equals(secondTime));
   // The example displays the following output to the console:
   //       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  
   //       9/1/2007 6:45:00 AM -07:00 = : False                           
   //       9/1/2007 6:45:00 AM -07:00 = 9/1/2007 6:45:00 AM: False          
Dim firstTime As New DateTimeOffset(#09/01/2007 6:45:00AM#, _
                 New TimeSpan(-7, 0, 0))

Dim secondTime As Object = firstTime
Console.WriteLine("{0} = {1}: {2}", _
                  firstTime, secondTime, _
                  firstTime.Equals(secondTime))

secondTime = New DateTimeOffset(#09/01/2007 6:45:00AM#, _
                 New TimeSpan(-6, 0, 0))      
Console.WriteLine("{0} = {1}: {2}", _
                 firstTime, secondTime, _
                 firstTime.Equals(secondTime))

secondTime = New DateTimeOffset(#09/01/2007 8:45:00AM#, _
                 New TimeSpan(-5, 0, 0))
Console.WriteLine("{0} = {1}: {2}", _
                 firstTime, secondTime, _
                 firstTime.Equals(secondTime))
                 
secondTime = Nothing
Console.WriteLine("{0} = {1}: {2}", _
                 firstTime, secondTime, _
                 firstTime.Equals(secondTime))

secondTime = #9/1/2007 6:45AM#
Console.WriteLine("{0} = {1}: {2}", _
                 firstTime, secondTime, _
                 firstTime.Equals(secondTime))
                             
' The example displays the following output to the console:
'       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  
'       9/1/2007 6:45:00 AM -07:00 = : False                           
'       9/1/2007 6:45:00 AM -07:00 = 9/1/2007 6:45:00 AM: False          

注釈

このメソッドが、両方の現在の値を変換して、比較を実行する前にDateTimeOffsetオブジェクトとobjパラメーターを世界協定時刻 (UTC)。Before it performs the comparison, this method converts the values of both the current DateTimeOffset object and the obj parameter to Coordinated Universal Time (UTC). メソッドは、次のと同等です。The method is equivalent to the following:

return this.UtcDateTime == ((DateTimeOffset) obj).UtcDateTime;
Return Me.UtcDateTime = DirectCast(obj, DatetimeOffset).UtcDateTime

つまり、DateTimeOffset.Equals(Object)メソッドを判断するかどうか現在DateTimeOffsetオブジェクトと指定したオブジェクトは、時間の 1 つの時点を表しています。In other words, the DateTimeOffset.Equals(Object) method determines whether the current DateTimeOffset object and a specified object represent a single point in time. 日付と時刻もオフセットと直接比較します。It directly compares neither dates and times nor offsets. 2 つかどうかを判断するDateTimeOffsetオブジェクトが同じ時間を表すしを使用して、同じオフセット値を持つ、EqualsExactメソッド。To determine whether two DateTimeOffset objects represent the same time and have the same offset value, use the EqualsExact method.

場合objnull、実行時の型の場合、またはobjないDateTimeOffset、メソッドを返しますfalseします。If obj is null, or if the run-time type of obj is not DateTimeOffset, the method returns false.

こちらもご覧ください

Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset)

指定した 2 つかどうかを判断しますDateTimeOffsetオブジェクトの同じ時点を表しています。Determines whether two specified DateTimeOffset objects represent the same point in time.

public:
 static bool Equals(DateTimeOffset first, DateTimeOffset second);
public static bool Equals (DateTimeOffset first, DateTimeOffset second);
static member Equals : DateTimeOffset * DateTimeOffset -> bool
Public Shared Function Equals (first As DateTimeOffset, second As DateTimeOffset) As Boolean

パラメーター

first
DateTimeOffset DateTimeOffset DateTimeOffset DateTimeOffset

比較する最初のオブジェクト。The first object to compare.

second
DateTimeOffset DateTimeOffset DateTimeOffset DateTimeOffset

比較する 2 番目のオブジェクト。The second object to compare.

戻り値

true 場合、2 つDateTimeOffsetオブジェクトが同じであるUtcDateTime値。 それ以外の場合、falseします。true if the two DateTimeOffset objects have the same UtcDateTime value; otherwise, false.

次の例への呼び出し、Equals(DateTimeOffset, DateTimeOffset)メソッドのさまざまなペアをテストするDateTimeOffsetオブジェクトの等価性。The following example illustrates calls to the Equals(DateTimeOffset, DateTimeOffset) method to test various pairs of DateTimeOffset objects for equality.

DateTimeOffset firstTime = new DateTimeOffset(2007, 11, 15, 11, 35, 00, 
                                    DateTimeOffset.Now.Offset);
DateTimeOffset secondTime = firstTime;
Console.WriteLine("{0} = {1}: {2}", 
                  firstTime, secondTime, 
                  DateTimeOffset.Equals(firstTime, secondTime));

// The value of firstTime remains unchanged
secondTime = new DateTimeOffset(firstTime.DateTime, 
             TimeSpan.FromHours(firstTime.Offset.Hours + 1));      
Console.WriteLine("{0} = {1}: {2}", 
                  firstTime, secondTime, 
                  DateTimeOffset.Equals(firstTime, secondTime));
                        
// value of firstTime remains unchanged
secondTime = new DateTimeOffset(firstTime.DateTime + TimeSpan.FromHours(1), 
                                TimeSpan.FromHours(firstTime.Offset.Hours + 1));
Console.WriteLine("{0} = {1}: {2}", 
                  firstTime, secondTime, 
                  DateTimeOffset.Equals(firstTime, secondTime));
 // The example produces the following output:
 //       11/15/2007 11:35:00 AM -07:00 = 11/15/2007 11:35:00 AM -07:00: True
 //       11/15/2007 11:35:00 AM -07:00 = 11/15/2007 11:35:00 AM -06:00: False
 //       11/15/2007 11:35:00 AM -07:00 = 11/15/2007 12:35:00 PM -06:00: True       
Dim firstTime As New DateTimeOffset(#11/15/2007 11:35AM#, _
                                    DateTimeOffset.Now.Offset)
Dim secondTime As DateTimeOffset = firstTime
Console.WriteLine("{0} = {1}: {2}", _
                  firstTime, secondTime, _
                  DateTimeOffset.Equals(firstTime, secondTime))

' The value of firstTime remains unchanged
secondTime = New DateTimeOffset(firstTime.DateTime, _
             TimeSpan.FromHours(firstTime.Offset.Hours + 1))      
Console.WriteLine("{0} = {1}: {2}", _
                  firstTime, secondTime, _
                  DateTimeOffset.Equals(firstTime, secondTime))

' value of firstTime remains unchanged
secondTime = New DateTimeOffset(firstTime.DateTime + TimeSpan.FromHours(1), _
                                TimeSpan.FromHours(firstTime.Offset.Hours + 1))
Console.WriteLine("{0} = {1}: {2}", _
                  firstTime, secondTime, _
                  DateTimeOffset.Equals(firstTime, secondTime))
 ' The example produces the following output:
 '       11/15/2007 11:35:00 AM -07:00 = 11/15/2007 11:35:00 AM -07:00: True
 '       11/15/2007 11:35:00 AM -07:00 = 11/15/2007 11:35:00 AM -06:00: False
 '       11/15/2007 11:35:00 AM -07:00 = 11/15/2007 12:35:00 PM -06:00: True       

注釈

このメソッドは両方に変換して、比較を実行する前にDateTimeOffsetオブジェクトを世界協定時刻 (UTC)。Before it performs the comparison, this method converts both DateTimeOffset objects to Coordinated Universal Time (UTC). メソッドは、次のと同等です。The method is equivalent to the following:

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

つまり、Equals(DateTimeOffset, DateTimeOffset)メソッドを判断するかどうか、2 つDateTimeOffsetオブジェクトの 1 つの点を表しています。In other words, the Equals(DateTimeOffset, DateTimeOffset) method determines whether the two DateTimeOffset objects represent a single point in time. 日付と時刻もオフセットと直接比較します。It directly compares neither dates and times nor offsets. 2 つかどうかを判断するDateTimeOffsetオブジェクトが同じ時間を表すしを使用して、同じオフセット値を持つ、EqualsExactメソッド。To determine whether two DateTimeOffset objects represent the same time and have the same offset value, use the EqualsExact method.

こちらもご覧ください

適用対象