¿Qué métodos ofrece java.util.Date para trabajar con fechas y horas en Java?

Personalmente me encanta desarrollas aplicaciones que dependen del tiempo, como calendarios, sistemas de reserva o análisis de datos, porque una vez que aprendes a usar java.util.Date, resultan muy sencillas de llevar a cabo. Aunque actualmente se está usando la API de fechas moderna, créeme que no está de más que comprendas los fundamentos del manejo de fechas en Java. Voy a explicarte detalladamente qué es y qué métodos te brinda.

¿Qué es java.util.Date?

java.util.Date es una clase de Java con la que puedes representar instancias de tiempo específicas, con precisión de milisegundos. Esta clase proporciona métodos para manejar, comparar y formatear fechas. Aunque fue introducida en las primeras versiones de Java, sigue siendo una herramienta importante para entender cómo manejar fechas.

Para usarla, primero debes importarla:

import java.util.Date;

Constructores de java.util.Date

java.util.Date te ofrece dos constructores principales con los que puedes crear objetos de tipo Date.

Constructor 1: Date()

Ten en cuenta que, este constructor inicializa un objeto Date con la fecha y hora actuales del sistema.

import java.util.Date;

public class EjemploFecha {
    public static void main(String[] args) {
        Date fechaActual = new Date();
        System.out.println("Fecha actual: " + fechaActual);
    }
}

Mira el resultado:

Fecha actual: Lun Dic 13 16:41:37 GMT 2021

Constructor 2: Date(long milisegundos)

Lo grandioso de este constructor, es que te deja crear un objeto Date basado en la cantidad de milisegundos que han pasado desde el 1 de enero de 1970 a las 00:00:00 GMT (el famoso Epoch Time).

import java.util.Date;

public class EjemploFechaMilisegundos {
    public static void main(String[] args) {
        long tiempoEnMilisegundos = 1_000_000_000L;
        Date fechaDesdeMilisegundos = new Date(tiempoEnMilisegundos);
        System.out.println("Fecha desde milisegundos: " + fechaDesdeMilisegundos);
    }
}

Observa el resultado:

Fecha desde milisegundos: Dom Ene 11 13:46:40 GMT 1970

Métodos principales de java.util.Date

Algo que me ha encantado es que, la clase java.util.Date te proporciona varios métodos útiles para trabajar con fechas y horas. Voy a explicártelos con estos ejemplos claros.

after(Date date)

Con este método podrás saber si una fecha es posterior a otra.

import java.util.Date;

public class EjemploAfter {
    public static void main(String[] args) {
        Date fecha1 = new Date(1_000_000_000L);
        Date fecha2 = new Date();

        boolean esPosterior = fecha2.after(fecha1);
        System.out.println("¿Fecha2 es posterior a Fecha1? " + esPosterior);
    }
}

Resultado:

¿Fecha2 es posterior a Fecha1? true

before(Date date)

Este te permite comprobar si una fecha es anterior a otra.

boolean esAnterior = fecha1.before(fecha2);
System.out.println("¿Fecha1 es anterior a Fecha2? " + esAnterior);

El resultado:

¿Fecha1 es anterior a Fecha2? true

compareTo(Date date)

Al usarlo podrás comparar dos fechas. Esto es lo que devuelve:

• Un valor negativo si la primera fecha es anterior.
• Cero si son iguales.
• Un valor positivo si la primera fecha es posterior.

int comparacion = fecha1.compareTo(fecha2);
System.out.println("Comparación: " + comparacion);

Mira el resultado:

Comparación: -1

equals(Date date)

Gracias a este método podrás comprobar si dos fechas son exactamente iguales.

boolean sonIguales = fecha1.equals(fecha2);
System.out.println("¿Fecha1 y Fecha2 son iguales? " + sonIguales);

El resultado queda así:

¿Fecha1 y Fecha2 son iguales? false

getTime() y setTime(long time)

• getTime(): Este te devuelve el número de milisegundos desde el Epoch.
• setTime(long time): Este cambia la fecha actual por una nueva basada en milisegundos.

long tiempo = fecha2.getTime();
System.out.println("Milisegundos desde Epoch: " + tiempo);

fecha1.setTime(tiempo);
System.out.println("Fecha1 actualizada: " + fecha1);

Resultado:

Milisegundos desde Epoch: 1672445068000
Fecha1 actualizada: Mar Dic 31 10:44:28 GMT 2023

toString()

Con este método puedes convertir un objeto Date en una representación de texto legible.

String fechaComoTexto = fecha2.toString();
System.out.println("Fecha como texto: " + fechaComoTexto);

Te queda así el resultado:

Fecha como texto: Mar Dic 31 10:44:28 GMT 2023

¿Cuándo usar java.util.Date?

Aunque java.util.Date es útil para manejar fechas, ten en cuenta que es una clase antigua. En proyectos modernos, yo te aconsejo usar la API de fechas de java.time, introducida en Java 8, que ofrece mayor flexibilidad y mejores herramientas para manejar zonas horarias y formatos.

Sin embargo, no dejes de lado java.util.Date cuando trabajes con APIs o bibliotecas que dependen de esta clase, o si estás estudiando las bases de la programación en Java.

Ya te expliqué cómo trabajar con fechas y horas usando la clase java.util.Date. Anímate a usar sus métodos, porque te dejan realizar operaciones de comparación y manipulación de fechas fácilmente. Me alegra que ahora tengas una base sólida para manejar el tiempo en tus aplicaciones.

Apúntate al Bootcamp de Java Full Stack de KeepCoding y aprende a dominar tanto las herramientas clásicas como las modernas del ecosistema Java. Prepárate para construir aplicaciones robustas y dar un salto al mundo IT en menos de lo que te imaginas. ¡Empieza hoy y transforma tu futuro!