CKTIS / Java
DateTimeFormatter: patrones, configuración regional y análisis estricto
Elige un patrón y una configuración regional para el texto, y un estilo de resolución para validar la fecha. Distingue `MM` de `mm` y `uuuu` de `yyyy`.
Versión: Java SE 21
Sintaxis
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.ResolverStyleEl método estático DateTimeFormatter.ofPattern crea un formateador a partir de un patrón. La sobrecarga ofPattern(String) usa la configuración regional predeterminada de la categoría FORMAT; ofPattern(String, Locale) usa la indicada explícitamente. Ambas empiezan con SMART. Si el patrón no es válido, se lanza IllegalArgumentException al crear el formateador.
El patrón distingue mayúsculas y minúsculas: dd es el día del mes, MM es el mes numérico y mm indica minutos. dd-MM-uuuu, dd/MM/uuuu y uuuu-MM-dd fijan el orden de los campos y los separadores. uuuu representa el año proléptico (que incluye el año cero); yyyy representa el año de la era. En el análisis ISO estricto, yyyy junto con solo el mes y el día no basta para obtener un LocalDate, porque no se presupone ninguna era. Usa uuuu para fechas sin era.
DateTimeFormatter.withLocale establece la Locale del formateador devuelto. Afecta al texto, como los nombres completos de los meses (MMMM), tanto al formatear como al analizar, pero no reordena los campos ni cambia los separadores de un patrón explícito. Los formateadores son inmutables y seguros para compartir entre hilos: conserva el resultado de withLocale o withResolverStyle, porque el original no cambia.
DateTimeFormatter.withResolverStyle controla la segunda fase del análisis: tras leer los campos con el patrón, el formateador los combina en una fecha. No cambia el formateo. Para fechas ISO, STRICT rechaza las fechas imposibles, SMART puede ajustar un día del intervalo 1–31 al último día del mes y LENIENT puede trasladar los días sobrantes al mes siguiente. LocalDate.parse(text, formatter) lanza DateTimeParseException si el texto no encaja o no se puede convertir en una fecha.
Ejemplos
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
La configuración regional cambia el nombre del mes, no la estructura de la fecha. Los nombres dependen de los datos regionales del entorno de ejecución. Para `31-02-2024`, `SMART` devuelve `2024-02-29`, mientras que `STRICT` rechaza la entrada.
Lecciones relacionadas
- Java · Lección 61 · Avanzado · Versión: 2