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
- 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