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