Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources