# DateTime.Equals 方法

## 多載

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

## Equals(DateTime)

DateTime.cs

DateTime.cs

DateTime.cs

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

#### 傳回

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

### 範例

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.


## Equals(Object)

DateTime.cs

DateTime.cs

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

### 範例

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.


## Equals(DateTime, DateTime)

DateTime.cs

DateTime.cs

DateTime.cs

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

### 範例

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

// 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

// 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(

// 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( _

' 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 屬性值不會在測試中考慮是否相等。