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

CKTIS / Java

DateTimeFormatter — formatação e análise de datas

DateTimeFormatter converte datas e horas em texto e analisa texto. Aprende sobre padrões, a seleção explícita de Locale, a validação estrita e as diferenças entre MM e mm, e entre uuuu e yyyy.

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

Sintaxe

DateTimeFormatter.ofPattern("uuuu-MM-dd HH:mm").withLocale(Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)

DateTimeFormatter é imutável e seguro para utilização concorrente. DateTimeFormatter.ofPattern cria um formatador a partir de um padrão; podes reutilizá-lo para formatar e analisar datas.

Quanto a MM e mm: MM representa o mês com dois algarismos, enquanto mm representa os minutos com dois algarismos. Quanto a uuuu e yyyy: uuuu representa o ano proléptico, enquanto yyyy representa o ano da era. Para analisar estritamente datas ISO sem era, utiliza uuuu; yyyy por si só não permite determinar a data.

DateTimeFormatter.withLocale devolve um formatador com o Locale escolhido, que influencia, por exemplo, os nomes dos meses. DateTimeFormatter.withResolverStyle também não altera o objeto original. Escolhe ResolverStyle.STRICT para rejeitar datas inválidas. O modo predefinido de ofPattern, SMART, pode ajustar o dia para o fim do mês, por exemplo, de 2023-02-29 para 2023-02-28.

O exemplo aceita 2024-02-29 09:07, mas rejeita 2023-02-29 09:07. STRICT controla a resolução dos campos durante a análise, não a formatação.

Exemplos

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.time.format.ResolverStyle;
import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        DateTimeFormatter formatter = DateTimeFormatter
                .ofPattern("uuuu-MM-dd HH:mm")
                .withLocale(Locale.ROOT)
                .withResolverStyle(ResolverStyle.STRICT);

        LocalDateTime value = LocalDateTime.parse("2024-02-29 09:07", formatter);
        System.out.println(value.format(formatter));

        try {
            LocalDateTime.parse("2023-02-29 09:07", formatter);
            throw new AssertionError("Expected rejection");
        } catch (DateTimeParseException ex) {
            System.out.println("Invalid date rejected");
        }
    }
}

Resultado

2024-02-29 09:07
Invalid date rejected

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