DateTimeOffset.Equals 메서드

참조

정의

네임스페이스:: System

어셈블리:: System.Runtime.dll

어셈블리:: mscorlib.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

두 개의 DateTimeOffset 개체가 같은지 또는 하나의 DateTimeOffset 개체가 지정된 다른 개체와 같은지 확인합니다.

오버로드

Equals(DateTimeOffset)	현재 DateTimeOffset 개체가 나타내는 시각이 지정된 DateTimeOffset 개체와 같은지 확인합니다.
Equals(Object)	DateTimeOffset 개체가 지정된 개체와 동일한 시각을 나타내는지 확인합니다.
Equals(DateTimeOffset, DateTimeOffset)	지정된 두 DateTimeOffset 개체가 동일한 시각을 나타내는지 확인합니다.

Equals(DateTimeOffset)

현재 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

두 DateTimeOffset 개체의 UtcDateTime 값이 모두 같으면 true이고, 그렇지 않으면 false입니다.

구현

Equals(T)

예제

다음 예제에서는 현재 DateTimeOffset 개체와 같은 개체를 테스트 DateTimeOffset 하는 메서드에 대 한 호출 Equals(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) 두 DateTimeOffset 개체가 단일 시점을 나타내는지 여부를 결정합니다. 날짜와 시간 또는 오프셋을 직접 비교하지 않습니다. 두 DateTimeOffset 개체가 같은 시간을 나타내고 오프셋 값이 같은지 확인하려면 메서드를 EqualsExact 사용합니다.

DateTimeOffset 그렇지 않은 null 개체는 다음 개체보다 큼(또는 그 이상)으로 null간주됩니다.

메서드의 Equals(DateTimeOffset) 이 오버로드는 메서드를 IEquatable<T>.Equals 구현합니다. 매개 변수를 DateTimeOffset.Equals(Object) 개체에서 변환할 필요가 없으므로 오버로드 other 보다 약간 더 나은 성능을 제공합니다.

추가 정보

EqualsExact(DateTimeOffset)

적용 대상

Equals(Object)

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

obj 매개 변수가 DateTimeOffset 개체이고 현재 DateTimeOffset 개체의 시간과 같은 시각을 나타내면 true이고, 그렇지 않으면 false입니다.

예제

다음 예제에서는 현재 DateTimeOffset 개체가 Null 참조 및 개체뿐만 아니라 다른 DateTimeOffset 여러 개체와 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 개체와 지정된 개체가 단일 시점을 나타내는지 여부를 결정합니다. 날짜와 시간 또는 오프셋을 직접 비교하지 않습니다. 두 DateTimeOffset 개체가 같은 시간을 나타내고 오프셋 값이 같은지 확인하려면 메서드를 EqualsExact 사용합니다.

인 경우 obj 또는 런타임 형식 obj 이 아닌 DateTimeOffset경우 메서드가 반환됩니다false.null

추가 정보

EqualsExact(DateTimeOffset)

적용 대상

Equals(DateTimeOffset, DateTimeOffset)

지정된 두 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

비교할 두 번째 개체입니다.

반환

Boolean

두 DateTimeOffset 개체의 UtcDateTime 값이 같으면 true이고, 그렇지 않으면 false입니다.

예제

다음 예제에서는 메서드를 호출하여 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

설명

비교를 수행하기 전에 이 메서드는 두 개체를 UTC DateTimeOffset (협정 세계시)로 변환합니다. 메서드는 다음과 같습니다.

return first.UtcDateTime == second.UtcDateTime;

first.UtcDateTime = second.UtcDateTime

Return first.UtcDateTime = second.UtcDateTime

즉, 메서드는 Equals(DateTimeOffset, DateTimeOffset) 두 DateTimeOffset 개체가 단일 시점을 나타내는지 여부를 결정합니다. 날짜와 시간 또는 오프셋을 직접 비교하지 않습니다. 두 DateTimeOffset 개체가 같은 시간을 나타내고 오프셋 값이 같은지 확인하려면 메서드를 EqualsExact 사용합니다.

추가 정보

EqualsExact(DateTimeOffset)

적용 대상

DateTimeOffset.Equals 메서드

정의

오버로드

Equals(DateTimeOffset)

매개 변수

반환

구현

예제

설명

추가 정보

적용 대상

Equals(Object)

매개 변수

반환

예제

설명

추가 정보

적용 대상

Equals(DateTimeOffset, DateTimeOffset)

매개 변수

반환

예제

설명

추가 정보

적용 대상

추가 리소스