DateTimeOffset.Equals Metoda

Reference

Definice

Obor názvů:: System

Sestavení:: System.Runtime.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Určuje, zda jsou dva DateTimeOffset objekty stejné, nebo DateTimeOffset je objekt roven zadanému objektu.

Přetížení

Equals(DateTimeOffset)	Určuje, zda aktuální DateTimeOffset objekt představuje stejný bod v čase jako zadaný DateTimeOffset objekt.
Equals(Object)	Určuje, zda DateTimeOffset objekt představuje stejný bod v čase jako zadaný objekt.
Equals(DateTimeOffset, DateTimeOffset)	Určuje, zda dva zadané DateTimeOffset objekty představují stejný bod v čase.

Equals(DateTimeOffset)

Určuje, zda aktuální DateTimeOffset objekt představuje stejný bod v čase jako zadaný DateTimeOffset objekt.

public:
 virtual bool Equals(DateTimeOffset other);

public bool Equals (DateTimeOffset other);

override this.Equals : DateTimeOffset -> bool

Public Function Equals (other As DateTimeOffset) As Boolean

Parametry

other: DateTimeOffset

Objekt, který se má porovnat s aktuálním DateTimeOffset objektem.

Návraty

Boolean

true pokud oba DateTimeOffset objekty mají stejnou UtcDateTime hodnotu, falsejinak .

Implementuje

Equals(T)

Příklady

Následující příklad znázorňuje volání Equals(DateTimeOffset) metody pro testování DateTimeOffset objektů pro rovnost s aktuálním DateTimeOffset objektem.

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

Poznámky

Před provedením porovnání tato metoda převede hodnoty obou DateTimeOffset objektů na standard UTC (Coordinated Universal Time). Metoda je ekvivalentní následujícímu zápisu:

return this.UtcDateTime == other.UtcDateTime;

this.UtcDateTime = other.UtcDateTime

Return Me.UtcDateTime = other.UtcDateTime

Jinými slovy, metoda určuje, Equals(DateTimeOffset) zda dva DateTimeOffset objekty představují jeden bod v čase. Neporovnává přímo ani data a časy, ani posuny. Chcete-li zjistit, zda dva DateTimeOffset objekty představují stejný čas a mají stejnou hodnotu posunu, použijte metodu EqualsExact .

Objekt DateTimeOffset , který není null považován za pozdější (nebo větší) než objekt, který je null.

Toto přetížení Equals(DateTimeOffset) metody implementuje metodu IEquatable<T>.Equals . Nabízí mírně lepší výkon než DateTimeOffset.Equals(Object) přetížení, protože other parametr nemusí být převeden z objektu.

Viz také

EqualsExact(DateTimeOffset)

Platí pro

Equals(Object)

Určuje, zda DateTimeOffset objekt představuje stejný bod v čase jako zadaný objekt.

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

Parametry

obj: Object

Objekt, který se má porovnat s aktuálním DateTimeOffset objektem.

Návraty

Boolean

trueobj pokud je DateTimeOffset parametr objektem a představuje stejný bod v čase jako aktuální DateTimeOffset objekt; v opačném případě false.

Příklady

Následující příklad označuje, zda je aktuální DateTimeOffset objekt roven několika dalším DateTimeOffset objektům, stejně jako nulový odkaz a DateTime objekt.

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

Poznámky

Před provedením porovnání tato metoda převede hodnoty aktuálního DateTimeOffset objektu i parametru obj na standard UTC (Coordinated Universal Time). Metoda je ekvivalentní následujícímu zápisu:

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

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

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

Jinými slovy, metoda určuje, DateTimeOffset.Equals(Object) zda aktuální DateTimeOffset objekt a zadaný objekt představují jeden bod v čase. Neporovnává přímo ani data a časy, ani posuny. Chcete-li zjistit, zda dva DateTimeOffset objekty představují stejný čas a mají stejnou hodnotu posunu, použijte metodu EqualsExact .

Pokud obj je null, nebo pokud typ obj běhu není DateTimeOffset, metoda vrátí false.

Viz také

EqualsExact(DateTimeOffset)

Platí pro

Equals(DateTimeOffset, DateTimeOffset)

Určuje, zda dva zadané DateTimeOffset objekty představují stejný bod v čase.

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

Parametry

first: DateTimeOffset

První objekt k porovnání

second: DateTimeOffset

Druhý objekt k porovnání

Návraty

Boolean

true pokud mají dva DateTimeOffset objekty stejnou UtcDateTime hodnotu, jinak false.

Příklady

Následující příklad znázorňuje volání Equals(DateTimeOffset, DateTimeOffset) metody k otestování různých dvojic DateTimeOffset objektů pro rovnost.

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

Poznámky

Před provedením porovnání tato metoda převede oba DateTimeOffset objekty na koordinovaný univerzální čas (UTC). Metoda je ekvivalentní následujícímu zápisu:

return first.UtcDateTime == second.UtcDateTime;

first.UtcDateTime = second.UtcDateTime

Return first.UtcDateTime = second.UtcDateTime

Jinými slovy, metoda určuje, Equals(DateTimeOffset, DateTimeOffset) zda dva DateTimeOffset objekty představují jeden bod v čase. Neporovnává přímo ani data a časy, ani posuny. Chcete-li zjistit, zda dva DateTimeOffset objekty představují stejný čas a mají stejnou hodnotu posunu, použijte metodu EqualsExact .

Viz také

EqualsExact(DateTimeOffset)

Platí pro

Sdílet prostřednictvím

DateTimeOffset.Equals Metoda

Definice

Přetížení

Equals(DateTimeOffset)

Parametry

Návraty

Implementuje

Příklady

Poznámky

Viz také

Platí pro

Equals(Object)

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

Equals(DateTimeOffset, DateTimeOffset)

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

Další materiály