Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

java.util.Date — ler, alterar e comparar o tempo

Date representa um instante com precisão de milissegundos. Aprende a lê-lo com getTime(), alterá-lo com setTime(long) e compará-lo com equals(Object).

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

java.util.Date representa um instante, não apenas uma data do calendário. Date.getTime() devolve um long: o número de milissegundos desde 1970-01-01 00:00:00 GMT. Os valores negativos representam instantes anteriores.

Date.setTime(long) substitui o tempo no objeto existente e devolve void; não acrescenta tempo nem cria uma cópia. Atenção: o objeto é mutável.

A implementação de Date.equals(Object) na classe base só devolve true se o argumento for uma instância de Date e getTime() devolver o mesmo valor para ambos os objetos. Nos restantes casos, incluindo quando o argumento é null, devolve false. As subclasses podem redefinir este método. Por exemplo, chamar equals(Object) num objeto java.sql.Timestamp com um objeto da classe java.util.Date como argumento devolve false, mesmo que getTime() devolva o mesmo valor para ambos os objetos.

Estes três métodos não estão obsoletos, embora muitos métodos da classe relacionados com o calendário estejam marcados como deprecated. O exemplo utiliza valores fixos em vez do relógio do sistema.

Exemplos

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

Resultado

0
true
1000
false
false

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes