Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

DateTimeFormatter.ofPattern: schema di data e ora con Locale.ENGLISH

Crea un formattatore per `yyyy-MM-dd HH:mm z` specificando `Locale.ENGLISH` e scopri da dove proviene il fuso orario mostrato nell’output.

Versione: Java SE 21

Sintassi

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)

Il metodo statico DateTimeFormatter.ofPattern del package java.time.format crea un formattatore immutabile e thread-safe, riutilizzabile per la formattazione e il parsing. ofPattern(String) prende le impostazioni locali predefinite per Locale.Category.FORMAT; ofPattern(String, Locale) usa quelle passate al metodo, come Locale.ENGLISH. Entrambi gli overload lanciano IllegalArgumentException già alla creazione se lo schema non è valido. Nel parsing usano per impostazione predefinita la modalità di risoluzione SMART.

Le lettere dello schema distinguono tra maiuscole e minuscole. In yyyy-MM-dd HH:mm z, yyyy rappresenta l’anno dell’era con almeno quattro cifre. MM e dd indicano il mese e il giorno del mese; HH e mm, l’ora (00–23) e i minuti. Questi quattro campi vengono portati a due cifre con uno zero iniziale, se necessario. uuuu rappresenta invece l’anno prolettico, che ammette l’anno 0.

Durante la formattazione, una sola z mostra il nome breve del fuso e tiene conto dell’ora legale quando è possibile stabilire se sia in vigore. Locale.ENGLISH sceglie la lingua di quel testo, non il fuso. Nessuno dei due overload impone un fuso: ZonedDateTime lo fornisce, mentre LocalDateTime da solo non basta. I nomi dei fusi regionali possono variare a seconda dei dati di localizzazione dell’ambiente di esecuzione e non sono necessariamente univoci. Con un ZoneOffset fisso, z mostra l’ID dell’offset anziché un nome.

Esempi

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));
    }
}

Risultato

2024-02-09 07:05 +02:00

L’output `2024-02-09 07:05 +02:00` deriva da data, ora e offset fisso specificati esplicitamente. `+02:00` è l’ID dell’offset, non il nome inglese di un fuso. L’esempio non usa l’orologio di sistema, né il fuso o le impostazioni locali predefinite.

Lezioni correlate

  • Java · Lezione 59 · Intermedio · Versione: 2

Fonti