[API] java.time.format.DateTimeFormatterクラス

DateTimeFormatterは日付と時刻のフォーマットとパースを行うためのクラスです。

DateTimeFormatterの特徴

  • Java SE8で導入された
  • イミュータブルオブジェクトなので値を安全に扱える

DateTimeFormatterの継承・実装

継承クラス

java.lang.Object
 ・java.time.format.DateTimeFormatter

実装インターフェース

・なし

導入バージョン

・JDK1.8

DateTimeFormatterのAPI

【主要定数】
定数説明
DateTimeFormatterBASIC_ISO_DATE基本的なISO日付
(例)’20230831′
DateTimeFormatterISO_LOCAL_DATEISOローカル日付
(例)’2023-12-31′
DateTimeFormatterISO_ZONED_DATE_TIMEゾーン指定の日付時間
(例)’2023-08-31T10:20:30+09:00[Asia/Tokyo]’
DateTimeFormatterISO_INSTANTインスタントの日付および時間
(例)’2023-12-03T08:35:58Z’
※ZonedDateTimeクラスでのみ使用可
DateTimeFormatterISO_DATEISO日付フォーマット
(オフセットあり/なし)
(例)’2023-12-03′
‘2023-12-03+09:00’
DateTimeFormatterISO_TIMEISO時間フォーマット
(オフセットあり/なし)
(例)’10:20:30′
’10:20:30+09:00′
DateTimeFormatterISO_DATE_TIMEISO日付時間フォーマット
(オフセットあり/なし)
(例)’2023-12-03T10:20:30′
‘2023-12-03T10:20:30+09:00’
【主要メソッド】
戻値型メソッド静的説明
DateTimeFormatterofPattern(String pattern)指定したパターンでフォーマッタを生成する
LocalegetLocale()ロケール情報を取得する
ZoneIdgetZone()タイムゾーン情報を取得する
FormattoFormat()java.text.Formatインスタンスとして返す

DateTimeFormatterサンプルソース

(LocalDateTime型の現在日時をフォーマットする)

LocalDateTime now = LocalDateTime.now();
DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
String dateStr = now.format(dtf);
System.out.println(dateStr);
例 → 2023-09-02 14:06:43
(日付文字列をLocalDateTime型に変換する)

String dateTimeString = "2023-09-02 14:30:01";
LocalDateTime ldt = LocalDateTime.parse(dateTimeString, dtf);
System.out.println(ldt);
→ 2023-09-02T14:30:01

コメント

タイトルとURLをコピーしました