DateTimeOffset.Equals メソッド

定義

名前空間:: System

アセンブリ:: mscorlib.dll, System.Runtime.dll

アセンブリ:: netstandard.dll, System.Runtime.dll

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

2 つの DateTimeOffset オブジェクトが等しいか、 DateTimeOffset オブジェクトが指定したオブジェクトと等しいかを判断します。

オーバーロード

名前	説明
Equals(DateTimeOffset)	現在の DateTimeOffset オブジェクトが、指定した DateTimeOffset オブジェクトと同じ時点を表すかどうかを判断します。
Equals(Object)	DateTimeOffset オブジェクトが指定したオブジェクトと同じ時点を表すかどうかを判断します。
Equals(DateTimeOffset, DateTimeOffset)	指定した 2 つの DateTimeOffset オブジェクトが同じ時点を表すかどうかを判断します。

Equals(DateTimeOffset)

ソース:: DateTimeOffset.cs

ソース:: DateTimeOffset.cs

ソース:: DateTimeOffset.cs

ソース:: DateTimeOffset.cs

ソース:: DateTimeOffset.cs

現在の DateTimeOffset オブジェクトが、指定した DateTimeOffset オブジェクトと同じ時点を表すかどうかを判断します。

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 オブジェクトと比較するオブジェクト。

返品

Boolean

両方のオブジェクトの値が同じである場合は 2a0/&。それ以外の場合は。

実装

Equals(T)

例

次の例は、現在のEquals(DateTimeOffset) オブジェクトと等しいかどうかをDateTimeOffsetオブジェクトをテストするDateTimeOffset メソッドの呼び出しを示しています。

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

let firstTime = DateTimeOffset(2007, 9, 1, 6, 45, 0, TimeSpan(-7, 0, 0))

let secondTime = firstTime
printfn $"{firstTime} = {secondTime}: {firstTime.Equals secondTime}"

let secondTime = DateTimeOffset(2007, 9, 1, 6, 45, 0, TimeSpan(-6, 0, 0))
printfn $"{firstTime} = {secondTime}: {firstTime.Equals secondTime}"

let secondTime = DateTimeOffset(2007, 9, 1, 8, 45, 0, TimeSpan(-5, 0, 0))
printfn $"{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) に変換します。このメソッドは、次と同じです。

return this.UtcDateTime == other.UtcDateTime;

this.UtcDateTime = other.UtcDateTime

Return Me.UtcDateTime = other.UtcDateTime

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

DateTimeOffsetされていないnull オブジェクトは、nullされたオブジェクトより後 (またはそれ以上) であると見なされます。

Equals(DateTimeOffset) メソッドのこのオーバーロードは、IEquatable<T>.Equals メソッドを実装します。 DateTimeOffset.Equals(Object) パラメーターをオブジェクトから変換する必要がないため、otherオーバーロードよりもパフォーマンスが若干向上します。

こちらもご覧ください

EqualsExact(DateTimeOffset)

適用対象

Equals(Object)

ソース:: DateTimeOffset.cs

ソース:: DateTimeOffset.cs

ソース:: DateTimeOffset.cs

ソース:: DateTimeOffset.cs

ソース:: DateTimeOffset.cs

DateTimeOffset オブジェクトが指定したオブジェクトと同じ時点を表すかどうかを判断します。

public:
 override bool Equals(System::Object ^ obj);

public override bool Equals(object obj);

public override bool Equals(object? obj);

override this.Equals : obj -> bool

Public Overrides Function Equals (obj As Object) As Boolean

パラメーター

obj: Object

現在の DateTimeOffset オブジェクトと比較するオブジェクト。

返品

Boolean

true obj パラメーターがDateTimeOffset オブジェクトであり、現在のDateTimeOffset オブジェクトと同じ時点を表す場合は。それ以外の場合はfalse。

例

次の例は、現在の DateTimeOffset オブジェクトが他のいくつかの DateTimeOffset オブジェクトと等しいかどうか、および null 参照と DateTime オブジェクトに等しいかどうかを示します。

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

let compareForEquality2 () =
    let firstTime = DateTimeOffset(2007, 9, 1, 6, 45, 0, TimeSpan(-7, 0, 0))

    let secondTime: obj = firstTime
    printfn $"{firstTime} = {secondTime}: {firstTime.Equals secondTime}"

    let secondTime = DateTimeOffset(2007, 9, 1, 6, 45, 0, TimeSpan(-6, 0, 0))
    printfn $"{firstTime} = {secondTime}: {firstTime.Equals secondTime}"

    let secondTime = DateTimeOffset(2007, 9, 1, 8, 45, 0, TimeSpan(-5, 0, 0))
    printfn $"{firstTime} = {secondTime}: {firstTime.Equals secondTime}"

    let secondTime = null
    printfn $"{firstTime} = {secondTime}: {firstTime.Equals secondTime}"

    let secondTime = DateTime(2007, 9, 1, 6, 45, 00)
    printfn $"{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) に変換します。このメソッドは、次と同じです。

return this.UtcDateTime == ((DateTimeOffset) obj).UtcDateTime;

this.UtcDateTime = (obj :?> DateTimeOffset).UtcDateTime

Return Me.UtcDateTime = DirectCast(obj, DatetimeOffset).UtcDateTime

つまり、 DateTimeOffset.Equals(Object) メソッドは、現在の DateTimeOffset オブジェクトと指定したオブジェクトが単一時点を表すかどうかを判断します。日付と時刻もオフセットも直接比較しません。 2 つの DateTimeOffset オブジェクトが同じ時間を表し、同じオフセット値を持っているかどうかを判断するには、 EqualsExact メソッドを使用します。

objがnullの場合、またはobjの実行時の型がDateTimeOffsetされていない場合、メソッドはfalseを返します。

こちらもご覧ください

EqualsExact(DateTimeOffset)

適用対象

Equals(DateTimeOffset, DateTimeOffset)

ソース:: DateTimeOffset.cs

ソース:: DateTimeOffset.cs

ソース:: DateTimeOffset.cs

ソース:: DateTimeOffset.cs

ソース:: DateTimeOffset.cs

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

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

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

second: DateTimeOffset

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

返品

Boolean

2 つのオブジェクトが同じ値を持つ場合は a0/&。それ以外の場合は。

例

次の例は、 Equals(DateTimeOffset, DateTimeOffset) メソッドを呼び出して、 DateTimeOffset オブジェクトのさまざまなペアの等価性をテストする方法を示しています。

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

let firstTime = DateTimeOffset(2007, 11, 15, 11, 35, 00, DateTimeOffset.Now.Offset)
let secondTime = firstTime
printfn $"{firstTime} = {secondTime}: {DateTimeOffset.Equals(firstTime, secondTime)}"

// The value of firstTime remains unchanged
let secondTime = DateTimeOffset(firstTime.DateTime, TimeSpan.FromHours(firstTime.Offset.Hours + 1 |> float))
printfn $"{firstTime} = {secondTime}: {DateTimeOffset.Equals(firstTime, secondTime)}"

// value of firstTime remains unchanged
let secondTime = DateTimeOffset(firstTime.DateTime + TimeSpan.FromHours 1, TimeSpan.FromHours(firstTime.Offset.Hours + 1 |> float))
printfn $"{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) に変換します。このメソッドは、次と同じです。

return first.UtcDateTime == second.UtcDateTime;

first.UtcDateTime = second.UtcDateTime

Return first.UtcDateTime = second.UtcDateTime

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

こちらもご覧ください

EqualsExact(DateTimeOffset)

適用対象

フィードバック

このページはお役に立ちましたか?