CKTIS / Java
java.util.Date — leggere, modificare e confrontare il tempo
Date rappresenta un istante con precisione al millisecondo. Scopri come leggerlo con getTime(), modificarlo con setTime(long) e confrontarlo con equals(Object).
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
new Date(long milliseconds)
long getTime()
void setTime(long time)
boolean equals(Object obj)java.util.Date rappresenta un istante, non solo una data di calendario. Date.getTime() restituisce un long: il numero di millisecondi trascorsi dal 1970-01-01 00:00:00 GMT. I valori negativi rappresentano istanti precedenti.
Date.setTime(long) sostituisce il tempo nell’oggetto esistente e restituisce void; non aggiunge tempo e non crea una copia. Attenzione: l’oggetto è mutabile.
L’implementazione di Date.equals(Object) nella classe base restituisce true solo se l’argomento è un’istanza di Date e getTime() restituisce lo stesso valore per entrambi gli oggetti. Negli altri casi, anche quando l’argomento è null, restituisce false. Le sottoclassi possono ridefinire questo metodo. Ad esempio, chiamare equals(Object) su un oggetto java.sql.Timestamp passando come argomento un oggetto della classe java.util.Date restituisce false anche se getTime() restituisce lo stesso valore per entrambi gli oggetti.
Questi tre metodi non sono deprecati, anche se molti metodi della classe relativi al calendario sono contrassegnati come deprecated. L’esempio usa valori fissi invece dell’orologio di sistema.
Esempi
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));
}
}Risultato
0 true 1000 false false
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.