KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen