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

CKTIS / Java

TimeUnit: unidades de tempo de duração fixa

`TimeUnit` disponibiliza sete unidades, dos nanossegundos aos dias. Escolhe a unidade que corresponde a um valor ou converte várias durações para uma unidade comum.

Versão: Java SE 21

Sintaxe

import java.util.concurrent.TimeUnit;

long minutesPerHour = TimeUnit.MINUTES.convert(1L, TimeUnit.HOURS);
long minutesPerDay = TimeUnit.MINUTES.convert(1L, TimeUnit.DAYS);

java.util.concurrent.TimeUnit é uma enumeração que representa unidades de tempo de duração fixa. Da mais pequena à maior, as constantes são NANOSECONDS, MICROSECONDS, MILLISECONDS, SECONDS, MINUTES, HOURS e DAYS.

Uma constante indica a unidade, não a quantidade: 1L com HOURS significa uma hora, enquanto 1L com DAYS significa um dia. Em TimeUnit, um dia tem sempre 24 horas. Não é um dia de calendário, cuja duração pode variar quando muda a hora.

Para exprimir várias durações na mesma unidade, usa targetUnit.convert(amount, sourceUnit). Chama o método na unidade de destino e passa a unidade de origem como segundo argumento. Ao converter para uma unidade maior, a parte fracionária é descartada: TimeUnit.HOURS.convert(90L, TimeUnit.MINUTES) devolve 1.

Exemplos

import java.util.concurrent.TimeUnit;

public class Main {
    public static void main(String[] args) {
        long minutesPerHour = TimeUnit.MINUTES.convert(1L, TimeUnit.HOURS);
        long minutesPerDay = TimeUnit.MINUTES.convert(1L, TimeUnit.DAYS);

        System.out.println(minutesPerHour);
        System.out.println(minutesPerDay);
    }
}

Resultado

60
1440

Ambas as conversões devolvem um número de minutos. O programa escreve `60` para uma hora e `1440` para um dia.

Lições relacionadas

  • Java · Lição 41 · Avançado · Versão: 2

Fontes