CKTIS / Java
java.util.Date — lire, modifier et comparer le temps
Date représente un instant avec une précision à la milliseconde. Apprenez à le lire avec getTime(), à le modifier avec setTime(long) et à le comparer avec equals(Object).
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
new Date(long milliseconds)
long getTime()
void setTime(long time)
boolean equals(Object obj)java.util.Date représente un instant, et pas seulement une date du calendrier. Date.getTime() renvoie un long : le nombre de millisecondes écoulées depuis le 01/01/1970 à 00:00:00 GMT. Les valeurs négatives représentent des instants antérieurs.
Date.setTime(long) remplace le temps dans l’objet existant et renvoie void ; la méthode n’ajoute pas de durée et ne crée pas de copie. Attention : l’objet est mutable.
L’implémentation de Date.equals(Object) dans la classe de base ne renvoie true que si l’argument est une instance de Date et que getTime() renvoie la même valeur pour les deux objets. Dans les autres cas, y compris si l’argument est null, elle renvoie false. Les sous-classes peuvent redéfinir cette méthode. Par exemple, un appel à equals(Object) sur un objet java.sql.Timestamp avec un objet de la classe java.util.Date en argument renvoie false, même si getTime() renvoie la même valeur pour les deux objets.
Ces trois méthodes ne sont pas obsolètes, même si de nombreuses méthodes de la classe liées au calendrier sont marquées deprecated. L’exemple utilise des valeurs fixes plutôt que l’horloge système.
Exemples
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));
}
}Résultat
0 true 1000 false false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.