Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

java.util.Date — čtení, změna a porovnání času

Date představuje okamžik s přesností na milisekundy. Naučte se jej načíst pomocí getTime(), změnit pomocí setTime(long) a porovnat pomocí equals(Object).

Verze: 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 představuje okamžik, nikoli pouze kalendářní datum. Date.getTime() vrací hodnotu typu long: počet milisekund od 1970-01-01 00:00:00 GMT. Záporné hodnoty označují dřívější okamžiky.

Date.setTime(long) nahradí čas v existujícím objektu a vrací void; čas nepřičítá ani nevytváří kopii. Pozor: objekt je proměnlivý.

Implementace Date.equals(Object) v základní třídě vrací true pouze tehdy, pokud je argument instancí třídy Date a getTime() vrací pro oba objekty stejnou hodnotu. V ostatních případech, včetně argumentu null, vrací false. Podtřídy mohou tuto metodu přepsat. Například volání metody equals(Object) na objektu java.sql.Timestamp s objektem třídy java.util.Date jako argumentem vrátí false, i když getTime() vrátí pro oba objekty stejnou hodnotu.

Tyto tři metody nejsou zastaralé, ačkoli mnoho metod této třídy souvisejících s kalendářem je označeno jako deprecated. Příklad používá pevné hodnoty namísto systémových hodin.

Příklady

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

Výsledek

0
true
1000
false
false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje