Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

DateTimeFormatter.ofPattern: vzor data a času s Locale.ENGLISH

Vytvoř formátovač pro vzor `yyyy-MM-dd HH:mm z` s výslovně zadaným `Locale.ENGLISH` a zjisti, odkud se bere časové pásmo ve výstupu.

Verze: Java SE 21

Syntaxe

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)

Statická metoda DateTimeFormatter.ofPattern z balíčku java.time.format vytvoří neměnný formátovač, který lze bezpečně sdílet mezi vlákny a opakovaně používat k formátování i parsování. ofPattern(String) použije výchozí jazykové a regionální nastavení kategorie Locale.Category.FORMAT; ofPattern(String, Locale) použije předané nastavení, například Locale.ENGLISH. Obě přetížení při vytváření formátovače s neplatným vzorem vyvolají IllegalArgumentException. Při parsování mají výchozí režim vyhodnocení SMART.

Písmena vzoru rozlišují velká a malá písmena. Ve vzoru yyyy-MM-dd HH:mm z znamená yyyy rok v rámci éry, alespoň čtyřmístný. MM a dd označují měsíc a den v měsíci; HH a mm hodinu (00–23) a minutu. Tato čtyři pole se podle potřeby doplňují nulou zleva na dvě číslice. Naproti tomu uuuu označuje proleptický rok, který může mít i hodnotu 0.

Při formátování jedno z vypíše krátký název časového pásma a zohlední letní čas, pokud lze určit, zda platí. Locale.ENGLISH vybírá jazyk tohoto textu, nikoli pásmo. Žádné z přetížení pásmo nepřepisuje: ZonedDateTime je poskytne, samotné LocalDateTime nestačí. Názvy oblastních pásem se mohou lišit podle lokalizačních dat běhového prostředí a nemusejí být jednoznačné. Pro pevný ZoneOffset vypíše z místo názvu identifikátor posunu.

Příklady

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

Výsledek

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

Výstup `2024-02-09 07:05 +02:00` vychází z výslovně zadaného data, času a pevného posunu. `+02:00` je identifikátor posunu, nikoli anglický název pásma. Příklad nepoužívá systémové hodiny ani výchozí časové pásmo či jazykové a regionální nastavení.

Související lekce

  • Java · Lekce 59 · Středně pokročilá · Verze: 2

Zdroje