CKTIS / Java
DateTimeFormatter.ofPattern: wzorzec daty i czasu z Locale.ENGLISH
Utwórz formater dla wzorca `yyyy-MM-dd HH:mm z` z jawnym `Locale.ENGLISH` i sprawdź, skąd pochodzi strefa czasowa wyświetlana w wyniku.
Wersja: Java SE 21
Składnia
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)Statyczna metoda DateTimeFormatter.ofPattern z pakietu java.time.format tworzy niemutowalny, bezpieczny wątkowo formater do wielokrotnego formatowania i parsowania. ofPattern(String) pobiera domyślne ustawienia regionalne kategorii Locale.Category.FORMAT, a ofPattern(String, Locale) używa podanych wprost, np. Locale.ENGLISH. Oba przeciążenia od razu zgłaszają IllegalArgumentException dla nieprawidłowego wzorca. Przy parsowaniu domyślnie stosują tryb SMART.
We wzorcu yyyy-MM-dd HH:mm z wielkość liter ma znaczenie. yyyy to rok ery z co najmniej czterema cyframi; MM i dd oznaczają miesiąc i dzień miesiąca, a HH i mm — godzinę w zakresie 00–23 i minuty. Te cztery pola są uzupełniane zerami do dwóch cyfr. uuuu oznacza rok proleptyczny, w którym istnieje rok 0, a nie rok ery.
Podczas formatowania pojedyncze z wyświetla krótką nazwę strefy, uwzględniając czas letni, jeśli można ustalić, czy obowiązuje. Locale.ENGLISH wybiera język tekstu, ale nie ustawia strefy. Żadne z przeciążeń nie narzuca strefy: ZonedDateTime ją dostarcza, a sam LocalDateTime nie wystarczy. Nazwy stref regionalnych mogą zależeć od danych językowych środowiska Java i nie muszą być jednoznaczne. Dla stałego ZoneOffset pole z wypisuje identyfikator przesunięcia zamiast nazwy.
Przykłady
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));
}
}
Wynik
2024-02-09 07:05 +02:00
Wynik `2024-02-09 07:05 +02:00` pochodzi z jawnie podanej daty, godziny i stałego przesunięcia. `+02:00` to identyfikator przesunięcia, a nie angielska nazwa strefy. Przykład nie korzysta z zegara ani z domyślnej strefy i domyślnych ustawień regionalnych.
Powiązane lekcje
- Java · Lekcja 59 · Średniozaawansowany · Wersja: 2
Źródła
- 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