CKTIS / Java
DateTimeFormatter: padrões, região e análise estrita
Escolhe um padrão e uma configuração regional para o texto e um estilo de resolução para validar a data. Distingue `MM` de `mm` e `uuuu` de `yyyy`.
Versão: Java SE 21
Sintaxe
java.time.format.DateTimeFormatter (Java SE 21)
static DateTimeFormatter ofPattern(String pattern)
static DateTimeFormatter ofPattern(String pattern, Locale locale)
DateTimeFormatter withLocale(Locale locale)
DateTimeFormatter withResolverStyle(ResolverStyle resolverStyle)
Locale: java.util.Locale
ResolverStyle: java.time.format.ResolverStyleO método estático DateTimeFormatter.ofPattern cria um formatador a partir de um padrão. A sobrecarga ofPattern(String) usa a configuração regional predefinida da categoria FORMAT; ofPattern(String, Locale) usa a que for indicada. Ambas começam com SMART. Um padrão inválido provoca uma IllegalArgumentException ao criar o formatador.
As maiúsculas e minúsculas são significativas: dd é o dia do mês, MM é o mês numérico e mm representa os minutos. dd-MM-uuuu, dd/MM/uuuu e uuuu-MM-dd definem a ordem dos campos e os separadores. uuuu representa o ano proléptico (inclui o ano zero); yyyy representa o ano da era. Na análise ISO estrita, yyyy com apenas o mês e o dia não chega para obter um LocalDate, pois não se presume nenhuma era. Usa uuuu para datas sem era.
DateTimeFormatter.withLocale define a Locale do formatador devolvido. Afeta texto como os nomes completos dos meses (MMMM), na formatação e na análise, mas não altera a ordem dos campos nem os separadores de um padrão explícito. Os formatadores são imutáveis e podem ser partilhados em segurança entre threads: guarda o resultado de withLocale ou withResolverStyle, pois o original não é alterado.
DateTimeFormatter.withResolverStyle controla a segunda fase da análise: depois de ler os campos de acordo com o padrão, o formatador combina-os numa data. Não altera a formatação. Nas datas ISO, STRICT rejeita datas impossíveis, SMART pode ajustar um dia entre 1 e 31 ao último dia do mês, e LENIENT pode transferir os dias excedentes para o mês seguinte. LocalDate.parse(text, formatter) lança DateTimeParseException se o texto não corresponder ao padrão ou não permitir obter uma data.
Exemplos
import java.time.LocalDate;
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) {
LocalDate date = LocalDate.of(2024, 1, 5);
DateTimeFormatter english = DateTimeFormatter.ofPattern("dd MMMM uuuu", Locale.US);
DateTimeFormatter french = english.withLocale(Locale.FRANCE);
System.out.println(date.format(english));
System.out.println(date.format(french));
DateTimeFormatter smart = DateTimeFormatter.ofPattern("dd-MM-uuuu", Locale.ROOT);
DateTimeFormatter strict = smart.withResolverStyle(ResolverStyle.STRICT);
String invalid = "31-02-2024";
System.out.println("SMART: " + LocalDate.parse(invalid, smart));
try {
System.out.println("STRICT: " + LocalDate.parse(invalid, strict));
} catch (DateTimeParseException e) {
System.out.println("STRICT: rejected");
}
}
}
Resultado
05 January 2024 05 janvier 2024 SMART: 2024-02-29 STRICT: rejected
A configuração regional altera o nome do mês, não a estrutura da data. Os nomes dependem dos dados regionais do ambiente de execução. Para `31-02-2024`, `SMART` devolve `2024-02-29`, enquanto `STRICT` rejeita a entrada.
Lições relacionadas
- Java · Lição 61 · Avançado · Versão: 2