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.