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.