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.