CKTIS / Java
java.util.Date — tijd uitlezen, wijzigen en vergelijken
Date stelt een moment met millisecondenprecisie voor. Leer hoe je het uitleest met getTime(), wijzigt met setTime(long) en vergelijkt met equals(Object).
Versie: 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 stelt een moment voor, niet alleen een kalenderdatum. Date.getTime() retourneert een long: het aantal milliseconden sinds 1970-01-01 00:00:00 GMT. Negatieve waarden staan voor eerdere momenten.
Date.setTime(long) vervangt de tijd in het bestaande object en retourneert void; de methode telt geen tijd op en maakt geen kopie. Let op: het object is veranderlijk.
De implementatie van Date.equals(Object) in de basisklasse retourneert alleen true als het argument een instantie van Date is en getTime() voor beide objecten dezelfde waarde oplevert. In alle andere gevallen, ook als het argument null is, retourneert de methode false. Subklassen kunnen deze methode overschrijven. Zo retourneert een aanroep van equals(Object) op een java.sql.Timestamp met een object van de klasse java.util.Date als argument false, ook als getTime() voor beide objecten dezelfde waarde oplevert.
Deze drie methoden zijn niet verouderd, hoewel veel kalendergerelateerde methoden van de klasse als deprecated zijn gemarkeerd. Het voorbeeld gebruikt vaste waarden in plaats van de systeemklok.
Voorbeelden
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));
}
}Resultaat
0 true 1000 false false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.