DateTime.Equals Method (DateTime)

Returns a value indicating whether this instance is equal to the specified DateTime instance.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

public bool Equals (
	DateTime value
)
public final boolean Equals (
	DateTime value
)
public final function Equals (
	value : DateTime
) : boolean
Not applicable.

Parameters

value

A DateTime instance to compare to this instance.

Return Value

true if the value parameter equals the value of this instance; otherwise, false.

This method implements the System.IEquatable interface, and performs slightly better than the Equals method because the value parameter does not have to be converted to an object.

The following code example demonstrates the Equals method.

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.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

.NET Compact Framework

Supported in: 2.0

XNA Framework

Supported in: 1.0

Community Additions

ADD
Show: