DateTime.Equals 方法

參考

定義

命名空間:: System

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

傳回值，指出兩個 DateTime 物件，或 DateTime 執行個體和另一個物件或 DateTime 是否有相同的值。

多載

Equals(DateTime)	傳回值，該值指出這個執行個體的值是否等於指定之 DateTime 執行個體的值。
Equals(Object)	傳回值，該值表示這個執行個體是否和指定的物件相等。
Equals(DateTime, DateTime)	傳回值，指出兩 DateTime 個實例是否有相同的日期和時間值。

Equals(DateTime)

Source:: DateTime.cs

Source:: DateTime.cs

Source:: DateTime.cs

傳回值，該值指出這個執行個體的值是否等於指定之 DateTime 執行個體的值。

public:
 virtual bool Equals(DateTime value);

public bool Equals (DateTime value);

override this.Equals : DateTime -> bool

Public Function Equals (value As DateTime) As Boolean

參數

value: DateTime

與這個執行個體相比較的物件。

傳回

Boolean

當 true 參數等於這個執行個體的值時為 value，否則為 false。

實作

Equals(T)

範例

下列範例示範 Equals 方法。

using System;

public class Application
{
    public static void Main()
    {
        // Create some DateTime objects.
        DateTime one = DateTime.UtcNow;

        DateTime two = DateTime.Now;

        DateTime three = one;

        // Compare the DateTime objects and display the results.
        bool result = one.Equals(two);

        Console.WriteLine("The result of comparing DateTime object one and two is: {0}.", result);

        result = one.Equals(three);

        Console.WriteLine("The result of comparing DateTime object one and three is: {0}.", result);
    }
}

// This code example displays the following:
//
// The result of comparing DateTime object one and two is: False.
// The result of comparing DateTime object one and three is: True.

open System

// Create some DateTime objects.
let one = DateTime.UtcNow

let two = DateTime.Now

let three = one

// Compare the DateTime objects and display the results.
let result = one.Equals two

printfn $"The result of comparing DateTime object one and two is: {result}."

let result2 = one.Equals three

printfn $"The result of comparing DateTime object one and three is: {result2}."

// This code example displays the following:
//
// The result of comparing DateTime object one and two is: False.
// The result of comparing DateTime object one and three is: True.

Module Application

    Sub Main()
        ' Create some DateTime objects.
        Dim one As DateTime = DateTime.UtcNow

        Dim two As DateTime = DateTime.Now

        Dim three As DateTime = one

        ' Compare the DateTime objects and display the results.
        Dim result As Boolean = one.Equals(two)

        Console.WriteLine("The result of comparing DateTime object one and two is: {0}.", result)

        result = one.Equals(three)

        Console.WriteLine("The result of comparing DateTime object one and three is: {0}.", result)

    End Sub
End Module

' This code example displays the following:
'
' The result of comparing DateTime object one and two is: False.
' The result of comparing DateTime object one and three is: True.

備註

目前的實例，如果其 Ticks 屬性值相等，則 value 為相等。其 Kind 屬性值不會在測試中考慮是否相等。

這個方法會實作 System.IEquatable<T> 介面，並執行比方法稍微好 Equals 一點，因為 value 參數不需要轉換成物件。

另請參閱

適用於

Equals(Object)

Source:: DateTime.cs

Source:: DateTime.cs

Source:: DateTime.cs

傳回值，該值表示這個執行個體是否和指定的物件相等。

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

public override bool Equals (object value);

public override bool Equals (object? value);

override this.Equals : obj -> bool

Public Overrides Function Equals (value As Object) As Boolean

參數

value: Object

與這個執行個體相比較的物件。

傳回

Boolean

如果 value 是 DateTime 的執行個體，並且等於這個執行個體的值，則為 true，否則為 false。

範例

下列範例示範 Equals 方法。

using System;

public class Application
{
    public static void Main()
    {
        // Create some DateTime objects.
        DateTime one = DateTime.UtcNow;

        DateTime two = DateTime.Now;

        DateTime three = one;

        // Compare the DateTime objects and display the results.
        bool result = one.Equals(two);

        Console.WriteLine("The result of comparing DateTime object one and two is: {0}.", result);

        result = one.Equals(three);

        Console.WriteLine("The result of comparing DateTime object one and three is: {0}.", result);
    }
}

// This code example displays the following:
//
// The result of comparing DateTime object one and two is: False.
// The result of comparing DateTime object one and three is: True.

open System

// Create some DateTime objects.
let one = DateTime.UtcNow

let two = DateTime.Now

let three = one

// Compare the DateTime objects and display the results.
let result = one.Equals two

printfn $"The result of comparing DateTime object one and two is: {result}."

let result2 = one.Equals three

printfn $"The result of comparing DateTime object one and three is: {result2}."

// This code example displays the following:
//
// The result of comparing DateTime object one and two is: False.
// The result of comparing DateTime object one and three is: True.

Module Application

    Sub Main()
        ' Create some DateTime objects.
        Dim one As DateTime = DateTime.UtcNow

        Dim two As DateTime = DateTime.Now

        Dim three As DateTime = one

        ' Compare the DateTime objects and display the results.
        Dim result As Boolean = one.Equals(two)

        Console.WriteLine("The result of comparing DateTime object one and two is: {0}.", result)

        result = one.Equals(three)

        Console.WriteLine("The result of comparing DateTime object one and three is: {0}.", result)

    End Sub
End Module

' This code example displays the following:
'
' The result of comparing DateTime object one and two is: False.
' The result of comparing DateTime object one and three is: True.

備註

目前的實例，如果其 Ticks 屬性值相等，則 value 為相等。其 Kind 屬性值不會在測試中考慮是否相等。

另請參閱

適用於

Equals(DateTime, DateTime)

Source:: DateTime.cs

Source:: DateTime.cs

Source:: DateTime.cs

傳回值，指出兩 DateTime 個實例是否有相同的日期和時間值。

public:
 static bool Equals(DateTime t1, DateTime t2);

public static bool Equals (DateTime t1, DateTime t2);

static member Equals : DateTime * DateTime -> bool

Public Shared Function Equals (t1 As DateTime, t2 As DateTime) As Boolean

參數

t1: DateTime

要比較的第一個物件。

t2: DateTime

要比較的第二個物件。

傳回

Boolean

當兩個值相等時為 true，否則為 false。

範例

下列範例示範 Equals 方法。

System::DateTime today1 = System::DateTime(
   System::DateTime::Today.Ticks );
System::DateTime today2 = System::DateTime(
   System::DateTime::Today.Ticks );
System::DateTime tomorrow = System::DateTime(
   System::DateTime::Today.AddDays( 1 ).Ticks );

// todayEqualsToday gets true.
bool todayEqualsToday = System::DateTime::Equals( today1, today2 );

// todayEqualsTomorrow gets false.
bool todayEqualsTomorrow = System::DateTime::Equals( today1, tomorrow );

let today1 = 
    System.DateTime System.DateTime.Today.Ticks

let today2 =
    System.DateTime System.DateTime.Today.Ticks

let tomorrow =
    System.DateTime.Today.AddDays(1).Ticks
    |> System.DateTime 

// todayEqualsToday gets true.
let todayEqualsToday = System.DateTime.Equals(today1, today2)

// todayEqualsTomorrow gets false.
let todayEqualsTomorrow = System.DateTime.Equals(today1, tomorrow)

System.DateTime today1 =
        new System.DateTime(System.DateTime.Today.Ticks);
System.DateTime today2 =
        new System.DateTime(System.DateTime.Today.Ticks);
System.DateTime tomorrow =
        new System.DateTime(
                    System.DateTime.Today.AddDays(1).Ticks);

// todayEqualsToday gets true.
bool todayEqualsToday = System.DateTime.Equals(today1, today2);

// todayEqualsTomorrow gets false.
bool todayEqualsTomorrow = System.DateTime.Equals(today1, tomorrow);

Dim today1 As New System.DateTime(System.DateTime.Today.Ticks)
Dim today2 As New System.DateTime(System.DateTime.Today.Ticks)
Dim tomorrow As New System.DateTime( _
                        System.DateTime.Today.AddDays(1).Ticks)

' todayEqualsToday gets true.
Dim todayEqualsToday As Boolean = System.DateTime.Equals(today1, today2)

' todayEqualsTomorrow gets false.
Dim todayEqualsTomorrow As Boolean = System.DateTime.Equals(today1, tomorrow)

備註

t1如果屬性值 Ticks 相等，和 t2 就會相等。其 Kind 屬性值不會在測試中考慮是否相等。

另請參閱

適用於

DateTime.Equals 方法

定義

多載

Equals(DateTime)

參數

傳回

實作

範例

備註

另請參閱

適用於

Equals(Object)

參數

傳回

範例

備註

另請參閱

適用於

Equals(DateTime, DateTime)

參數

傳回

範例

備註

另請參閱

適用於

意見反應

其他資源