DateTimeOffset.Equals 메서드

정의

두 개의 DateTimeOffset 개체가 같은지 또는 하나의 DateTimeOffset 개체가 지정된 다른 개체와 같은지 확인합니다.Determines whether two DateTimeOffset objects are equal, or a DateTimeOffset object is equal to a specified object.

오버로드

Equals(DateTimeOffset)

현재 DateTimeOffset 개체가 나타내는 시각이 지정된 DateTimeOffset 개체와 같은지 확인합니다.Determines whether the current DateTimeOffset object represents the same point in time as a specified DateTimeOffset object.

Equals(Object)

DateTimeOffset 개체가 지정된 개체와 동일한 시각을 나타내는지 확인합니다.Determines whether a DateTimeOffset object represents the same point in time as a specified object.

Equals(DateTimeOffset, DateTimeOffset)

지정된 두 DateTimeOffset 개체가 동일한 시각을 나타내는지 확인합니다.Determines whether two specified DateTimeOffset objects represent the same point in time.

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 개체와 비교할 개체입니다.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) 메서드는 두 개의 DateTimeOffset 개체가 한 시점을 나타내는지 여부를 확인 합니다.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. DateTimeOffset 개체가 같은 시간을 나타내고 동일한 오프셋 값을 사용 하는지 확인 하려면 EqualsExact 메서드를 사용 합니다.To determine whether two DateTimeOffset objects represent the same time and have the same offset value, use the EqualsExact method.

null 되지 않는 DateTimeOffset 개체는 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. other 매개 변수를 개체에서 변환할 필요가 없기 때문에 DateTimeOffset.Equals(Object) 오버 로드 보다 약간 더 나은 성능을 제공 합니다.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)

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

현재 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 개체와 지정 된 개체가 단일 시점을 나타내는지 여부를 확인 합니다.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. 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)

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

비교할 첫 번째 개체입니다.The first object to compare.

second
DateTimeOffset

비교할 두 번째 개체입니다.The second object to compare.

반환

true 개체의 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) 메서드는 두 DateTimeOffset 개체가 단일 시점을 나타내는지 여부를 확인 합니다.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. DateTimeOffset 개체가 같은 시간을 나타내고 동일한 오프셋 값을 사용 하는지 확인 하려면 EqualsExact 메서드를 사용 합니다.To determine whether two DateTimeOffset objects represent the same time and have the same offset value, use the EqualsExact method.

추가 정보

적용 대상