WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

java.util.Date — Zeit auslesen, ändern und vergleichen

Date stellt einen Zeitpunkt mit Millisekundengenauigkeit dar. Erfahre, wie du ihn mit getTime() ausliest, mit setTime(long) änderst und mit equals(Object) vergleichst.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

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

java.util.Date stellt einen Zeitpunkt dar, nicht nur ein Kalenderdatum. Date.getTime() gibt einen long zurück: die Anzahl der Millisekunden seit dem 01.01.1970, 00:00:00 GMT. Negative Werte stehen für frühere Zeitpunkte.

Date.setTime(long) ersetzt die Zeit im vorhandenen Objekt und gibt void zurück; die Methode addiert weder Zeit noch erstellt sie eine Kopie. Achtung: Das Objekt ist veränderlich.

Die Implementierung von Date.equals(Object) in der Basisklasse gibt nur dann true zurück, wenn das Argument eine Instanz von Date ist und getTime() für beide Objekte denselben Wert liefert. Andernfalls, auch bei null, gibt sie false zurück. Unterklassen können diese Methode überschreiben. So liefert ein Aufruf von equals(Object) auf einem java.sql.Timestamp mit einem Objekt der Klasse java.util.Date als Argument auch dann false, wenn getTime() für beide Objekte denselben Wert liefert.

Diese drei Methoden sind nicht veraltet, obwohl viele kalenderbezogene Methoden der Klasse als deprecated markiert sind. Das Beispiel verwendet feste Werte statt der Systemuhr.

Beispiele

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));
    }
}

Ergebnis

0
true
1000
false
false

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen