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

CKTIS / Java

Duration — tempo decorrido e diferenças entre instantes

java.time.Duration representa uma quantidade de tempo em segundos e nanossegundos. Duration.between calcula a diferença entre objetos temporais compatíveis; o resultado pode ser positivo, zero ou negativo.

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

Sintaxe

Duration.between(Temporal startInclusive, Temporal endExclusive)

java.time.Duration representa uma quantidade de tempo imutável e segura para utilização por várias threads, não uma data nem um instante. Armazena segundos e uma fração de segundo expressa em nanossegundos. Ao contrário de Period, que se baseia no calendário, um dia em Duration significa sempre 24 horas, sem ter em conta as mudanças da hora de verão.

Duration.between(startInclusive, endExclusive) calcula a diferença desde o início incluído até ao fim excluído. Os argumentos têm de suportar SECONDS; a precisão total requer também NANOS ou NANO_OF_SECOND. Se os argumentos forem de tipos diferentes, o tipo do primeiro determina como o segundo é interpretado. Se o início for um LocalDateTime, o fim pode ser um OffsetDateTime: o seu desvio em relação a UTC é ignorado. Na ordem inversa, a chamada lança DateTimeException, pois LocalDateTime não tem desvio em relação a UTC. Objetos incompatíveis podem causar DateTimeException, enquanto um overflow causa ArithmeticException.

O exemplo utiliza valores Instant fixos, pelo que não depende do relógio nem do fuso horário predefinido. O resultado PT1H30M45S significa 1 hora, 30 minutos e 45 segundos. toMinutes() devolve o número total de minutos inteiros, ou seja, 90, e não a componente dos minutos 30. Neste exemplo, trocar a ordem dos argumentos dá uma duração negativa.

Exemplos

import java.time.Duration;
import java.time.Instant;

public class Main {
    public static void main(String[] args) {
        Instant start = Instant.parse("2025-01-01T10:00:00Z");
        Instant end = Instant.parse("2025-01-01T11:30:45Z");
        Duration elapsed = Duration.between(start, end);

        System.out.println(elapsed);
        System.out.println(elapsed.toMinutes());
        System.out.println(Duration.between(end, start).isNegative());
    }
}

Resultado

PT1H30M45S
90
true

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