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

CKTIS / Java

ResolverStyle — resolução rigorosa de datas

ResolverStyle controla a forma como os campos analisados se combinam para formar uma data ou hora. O comportamento de ResolverStyle.STRICT depende dos campos: numa data do calendário ISO indicada por ano, mês e dia, este estilo rejeita 29 de fevereiro num ano não bissexto.

Versão: Java SE 21 (documentation scope); repository and production runtimes not attested

Sintaxe

DateTimeFormatter.ofPattern("uuuu-MM-dd", Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)

ResolverStyle é um tipo enum de java.time.format. A análise começa por ler os campos do texto e, em seguida, combina-os numa data ou hora. O estilo controla esta segunda fase, não a correspondência inicial do texto com um padrão nem a formatação do resultado.

Ao resolver uma data do calendário ISO a partir do ano, do mês e do dia, ResolverStyle.STRICT exige que o dia exista no mês e no ano indicados. Para esses mesmos campos, ResolverStyle.SMART pode substituir um número de dia demasiado elevado pelo último dia do mês, enquanto ResolverStyle.LENIENT permite transferir o excesso de um campo para outro. As regras dependem dos campos a resolver. Por exemplo, em Java SE 21, ao resolver uma data expressa em semanas, os campos de WeekFields que dependem da configuração regional podem reduzir a semana 53 à semana 52 num ano baseado em semanas que só tem 52 semanas, mesmo no modo STRICT.

Define o estilo com withResolverStyle(ResolverStyle.STRICT) e conserva o formatter devolvido: o método não altera o original. Um formatter criado com ofPattern usa SMART por predefinição. Para um padrão de data sem era, usa uuuu-MM-dd: uuuu significa ano, enquanto yyyy significa ano da era, que pode não ser suficiente para criar um LocalDate com resolução rigorosa sem era.

O exemplo aceita 2024-02-29, mas captura DateTimeParseException para 2023-02-29. Apresenta uma mensagem fixa, em vez do texto da exceção, que depende da implementação. Âmbito da documentação: Java SE 21; os ambientes de execução do repositório e de produção não foram atestados.

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) {
        DateTimeFormatter formatter = DateTimeFormatter
                .ofPattern("uuuu-MM-dd", Locale.ROOT)
                .withResolverStyle(ResolverStyle.STRICT);

        for (String text : new String[] {"2024-02-29", "2023-02-29"}) {
            try {
                System.out.println(LocalDate.parse(text, formatter));
            } catch (DateTimeParseException ex) {
                System.out.println("Rejected: " + text);
            }
        }
    }
}

Resultado

2024-02-29
Rejected: 2023-02-29

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