Método DateTime.CompareTo() en C#

Este método se utiliza para comparar el valor de esta instancia con un valor de fecha y hora especificado e indica si esta instancia es anterior, igual o posterior al valor de fecha y hora especificado. Hay dos métodos en la lista de sobrecarga de este método de la siguiente manera:

• Comparar con (fecha y hora)
• Comparar con (objeto)

Método CompareTo(DateTime)

Este método se utiliza para comparar el valor de esta instancia con un valor de fecha y hora especificado y devuelve un número entero que indica si esta instancia es anterior, igual o posterior al valor de fecha y hora especificado.

Sintaxis:

public int CompareTo (DateTime value);

Aquí, el valor del parámetro es el objeto a comparar con la instancia actual.

Valor devuelto: este método devuelve un número con signo que indica los valores relativos de esta instancia y el parámetro de valor.

• Menos que cero : si esta instancia es anterior al valor.
• Cero : si esta instancia es la misma que el valor.
• Mayor que cero : si esta instancia es posterior al valor.

Ejemplo:

// C# code to demonstrate
// CompareTo(DateTime) function
using System;
  
public class GFG {
  
    // Main Method
    public static void Main()
    {
  
        // Taking two DateTime Objects
        DateTime d1 = new DateTime(2018, 12,
                              31, 16, 0, 0);
  
        DateTime d2 = new DateTime(2018, 12,
                              31, 20, 0, 0);
  
        // Using the method
        int res = d1.CompareTo(d2);
  
        string r;
  
        if (res > 0)
            r = "is later than";
  
        else if (res == 0)
            r = "is the same time as";
        else
            r = "is earlier than";
  
        Console.WriteLine("{0} {1} {2}", d1, r, d2);
    }
}

12/31/2018 16:00:00 is earlier than 12/31/2018 20:00:00

Comparar con (objeto) Método

Este método se utiliza para comparar el valor de esta instancia con un objeto especificado que contiene un valor de fecha y hora especificado y devuelve un número entero que indica si esta instancia es anterior, igual o posterior al valor de fecha y hora especificado.

Sintaxis:

public int CompareTo (object value);

Aquí, el valor del parámetro es el objeto encuadrado para comparar o nulo.

Valor devuelto: este método devuelve un número con signo que indica los valores relativos de esta instancia y el parámetro de valor.

• Menos que cero : si esta instancia es anterior al valor.
• Cero : si esta instancia es la misma que el valor.
• Mayor que cero : si esta instancia es posterior al valor.

Excepción: este método dará ArgumentException si el valor no es DateTime.

Ejemplo:

// C# code to demonstrate
// CompareTo(Object) function
using System;
  
public class GFG {
  
    // Main Method
    public static void Main()
    {
  
        // Taking a DateTime Object
        DateTime d1 = new DateTime(2018, 12,
                              31, 16, 0, 0);
                                
        // Using the method
        // Here, "DateTime.Today" is
        // the property of DateTime struct
        int res = d1.CompareTo(DateTime.Today);
  
        string r;
  
        if (res > 0)
            r = "is later than";
  
        else if (res == 0)
            r = "is the same time as";
        else
            r = "is earlier than";
  
        Console.WriteLine("{0} {1} {2}", d1, r, 
                                DateTime.Today);
    }
}

Producción:

12/31/2018 16:00:00 is earlier than 01/21/2019 00:00:00

Referencia:

• https://docs.microsoft.com/en-us/dotnet/api/system.datetime.compareto?view=netframework-4.7.2