KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

DateTimeFormatter.ofPattern: datum- en tijdpatroon met Locale.ENGLISH

Maak een formatter voor `yyyy-MM-dd HH:mm z` met expliciet `Locale.ENGLISH` en ontdek waar de tijdzone in de uitvoer vandaan komt.

Versie: Java SE 21

Syntax

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)

De statische methode DateTimeFormatter.ofPattern uit java.time.format maakt een onveranderlijke, threadveilige formatter die je kunt hergebruiken voor formatteren en parsen. ofPattern(String) neemt de standaardlocale voor Locale.Category.FORMAT; ofPattern(String, Locale) gebruikt de locale die je meegeeft, bijvoorbeeld Locale.ENGLISH. Beide overloads gooien al bij het maken van de formatter een IllegalArgumentException als het patroon ongeldig is. Bij het parsen gebruiken ze standaard de resolutiestijl SMART.

Patroonletters zijn hoofdlettergevoelig. In yyyy-MM-dd HH:mm z is yyyy het jaartal binnen een jaartelling, met minstens vier cijfers. MM en dd staan voor de maand en de dag van de maand; HH en mm voor het uur (00–23) en de minuten. Die vier velden krijgen zo nodig een voorloopnul om op twee cijfers uit te komen. uuuu staat daarentegen voor het proleptische jaar, dat ook jaar 0 kent.

Bij het formatteren toont één z de korte tijdzonenaam en houdt het rekening met zomertijd als kan worden vastgesteld of die geldt. Locale.ENGLISH kiest de taal van die tekst, niet de tijdzone. Geen van beide overloads legt een tijdzone op: een ZonedDateTime levert die, maar een LocalDateTime alleen niet. Regionale tijdzonenamen kunnen afhangen van de localegegevens van de runtime en hoeven niet uniek te zijn. Bij een vaste ZoneOffset toont z de offset-ID in plaats van een naam.

Voorbeelden

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

Resultaat

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

De uitvoer `2024-02-09 07:05 +02:00` komt van een expliciet opgegeven datum, tijd en vaste offset. `+02:00` is de offset-ID, geen Engelse tijdzonenaam. Het voorbeeld gebruikt noch de systeemklok, noch de standaardtijdzone of standaardlocale.

Gerelateerde lessen

  • Java · Les 59 · Gemiddeld · Versie: 2

Bronnen