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

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