CKTIS / Java
DateTimeFormatter.ofPattern: patrón de fecha y hora con Locale.ENGLISH
Crea un formateador para `yyyy-MM-dd HH:mm z` con `Locale.ENGLISH` explícito y aprende de dónde sale la zona horaria que aparece en la salida.
Versión: Java SE 21
Sintaxis
import java.time.format.DateTimeFormatter;
import java.util.Locale;
DateTimeFormatter.ofPattern(String pattern)
DateTimeFormatter.ofPattern(String pattern, Locale locale)
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm z", Locale.ENGLISH)El método estático DateTimeFormatter.ofPattern del paquete java.time.format crea un formateador inmutable y seguro para varios hilos que puedes reutilizar para formatear y analizar texto. ofPattern(String) toma la configuración regional predeterminada de Locale.Category.FORMAT; ofPattern(String, Locale) usa la que le pasas, como Locale.ENGLISH. Ambas sobrecargas lanzan IllegalArgumentException al crear el formateador si el patrón no es válido. Al analizar texto, ambas usan por defecto el modo de resolución SMART.
Las letras del patrón distinguen entre mayúsculas y minúsculas. En yyyy-MM-dd HH:mm z, yyyy es el año dentro de la era, con al menos cuatro dígitos. MM y dd son el mes y el día del mes; HH y mm, la hora (00–23) y el minuto. Esos cuatro campos se rellenan con un cero inicial cuando es necesario para mostrar dos dígitos. En cambio, uuuu representa el año proléptico, que admite un año 0.
Al formatear, una sola z muestra el nombre corto de la zona y tiene en cuenta el horario de verano si se puede determinar si está vigente. Locale.ENGLISH selecciona el idioma de ese texto, no la zona. Ninguna sobrecarga impone una zona: ZonedDateTime la aporta, pero LocalDateTime por sí solo no basta. Los nombres de zonas regionales pueden variar según los datos de localización del entorno de ejecución y no tienen por qué ser únicos. Con un ZoneOffset fijo, z muestra el identificador del desfase en lugar de un nombre.
Ejemplos
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;
import java.util.Locale;
public class Main {
public static void main(String[] args) {
DateTimeFormatter formatter =
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm z", Locale.ENGLISH);
ZonedDateTime dateTime =
ZonedDateTime.of(2024, 2, 9, 7, 5, 0, 0, ZoneOffset.ofHours(2));
System.out.println(formatter.format(dateTime));
}
}
Resultado
2024-02-09 07:05 +02:00
La salida `2024-02-09 07:05 +02:00` procede de una fecha, una hora y un desfase fijo indicados explícitamente. `+02:00` es el identificador del desfase, no un nombre de zona en inglés. El ejemplo no utiliza el reloj del sistema ni la zona o la configuración regional predeterminadas.
Lecciones relacionadas
- Java · Lección 59 · Intermedio · Versión: 2
Fuentes
- DateTimeFormatter (Java SE 21 & JDK 21) — overloads, pattern letters, and resolver style
- DateTimeFormatterBuilder (Java SE 21 & JDK 21) — formatting and parsing zone text
- ZonedDateTime (Java SE 21 & JDK 21) — constructing a zoned date-time
- ZoneOffset (Java SE 21 & JDK 21) — offset ID
- LocaleServiceProvider (Java SE 21 & JDK 21) — locale data providers