Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

DateTimeFormatter — formato y análisis de fechas

DateTimeFormatter convierte fechas y horas en texto y analiza texto. Aprende sobre patrones, la selección explícita de Locale, la validación estricta y las diferencias entre MM y mm, y entre uuuu y yyyy.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

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

DateTimeFormatter es inmutable y seguro para usar en varios hilos. DateTimeFormatter.ofPattern crea un formateador a partir de un patrón; puedes reutilizarlo para dar formato y analizar fechas.

En MM y mm: MM representa el mes con dos dígitos, mientras que mm representa los minutos con dos dígitos. En uuuu y yyyy: uuuu representa el año proléptico, mientras que yyyy representa el año de la era. Para analizar estrictamente fechas ISO sin era, usa uuuu; yyyy por sí solo no basta para resolver la fecha.

DateTimeFormatter.withLocale devuelve un formateador con el Locale seleccionado, que afecta, por ejemplo, a los nombres de los meses. DateTimeFormatter.withResolverStyle tampoco modifica el objeto original. Elige ResolverStyle.STRICT para rechazar fechas no válidas. El modo predeterminado de ofPattern, SMART, puede ajustar el día al final del mes; por ejemplo, convertir 2023-02-29 en 2023-02-28.

El ejemplo acepta 2024-02-29 09:07, pero rechaza 2023-02-29 09:07. STRICT controla la resolución de campos durante el análisis, no el formato.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes