Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

java.util.Date — leer, cambiar y comparar el tiempo

Date representa un instante con precisión de milisegundos. Aprende a leerlo con getTime(), cambiarlo con setTime(long) y compararlo con equals(Object).

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

new Date(long milliseconds)
long getTime()
void setTime(long time)
boolean equals(Object obj)

java.util.Date representa un instante, no solo una fecha del calendario. Date.getTime() devuelve un long: el número de milisegundos transcurridos desde 1970-01-01 00:00:00 GMT. Los valores negativos representan instantes anteriores.

Date.setTime(long) reemplaza el tiempo del objeto existente y devuelve void; no suma tiempo ni crea una copia. Atención: el objeto es mutable.

La implementación de Date.equals(Object) en la clase base solo devuelve true si el argumento es una instancia de Date y getTime() devuelve el mismo valor para ambos objetos. En los demás casos, incluido cuando el argumento es null, devuelve false. Las subclases pueden sobrescribir este método. Por ejemplo, llamar a equals(Object) sobre un objeto java.sql.Timestamp con un objeto de la clase java.util.Date como argumento devuelve false, aunque getTime() devuelva el mismo valor para ambos objetos.

Estos tres métodos no están obsoletos, aunque muchos métodos de la clase relacionados con el calendario están marcados como deprecated. El ejemplo usa valores fijos en lugar del reloj del sistema.

Ejemplos

import java.util.Date;

public class Main {
    public static void main(String[] args) {
        Date first = new Date(0L);
        Date second = new Date(0L);
        System.out.println(first.getTime());
        System.out.println(first.equals(second));
        second.setTime(1000L);
        System.out.println(second.getTime());
        System.out.println(first.equals(second));
        System.out.println(first.equals(null));
    }
}

Resultado

0
true
1000
false
false

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes