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.