Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

java.util.Date — odczyt, zmiana i porównywanie czasu

Date reprezentuje chwilę z dokładnością do milisekund. Poznaj odczyt getTime(), zmianę setTime(long) i porównywanie equals(Object).

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

new Date(long milliseconds)
long getTime()
void setTime(long time)
boolean equals(Object obj)

java.util.Date reprezentuje chwilę, nie samą datę kalendarzową. Date.getTime() zwraca long: liczbę milisekund od 1970-01-01 00:00:00 GMT. Wartości ujemne oznaczają wcześniejsze chwile.

Date.setTime(long) zastępuje czas w istniejącym obiekcie i zwraca void; nie dodaje czasu ani nie tworzy kopii. Uwaga: obiekt jest mutowalny.

Implementacja Date.equals(Object) w klasie java.util.Date zwraca true tylko wtedy, gdy argument jest instancją Date i oba obiekty zwracają tę samą wartość z getTime(). W pozostałych przypadkach, także dla null, zwraca false. Podklasy mogą przesłonić tę metodę. Na przykład wywołanie equals(Object) na obiekcie java.sql.Timestamp z obiektem klasy java.util.Date jako argumentem zwraca false, nawet jeśli oba obiekty zwracają tę samą wartość z getTime().

Te trzy metody nie są przestarzałe, choć wiele metod kalendarzowych klasy oznaczono jako deprecated. Przykład używa stałych wartości zamiast zegara systemowego.

Przykłady

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

Wynik

0
true
1000
false
false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła