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.