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.