LocalDateTimeで日付を解析/フォーマットする方法は？（Java 8）

Java 8は、日付と時刻を操作するための新しいjava.time APIを追加しました（JSR 310）。

文字列として日付と時刻があります（例：）"2014-04-08 12:30"。LocalDateTime指定された文字列からインスタンスを取得するにはどうすればよいですか？

LocalDateTimeオブジェクトの操作が完了した後：次に、LocalDateTimeインスタンスを上記と同じ形式の文字列に変換するにはどうすればよいですか？

解析日時

LocalDateTime文字列からオブジェクトを作成するには、静的LocalDateTime.parse()メソッドを使用できます。文字列とDateTimeFormatterasパラメータを受け取ります。DateTimeFormatter日付/時刻のパターンを指定するために使用されます。

String str = "1986-04-08 12:30";
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm");
LocalDateTime dateTime = LocalDateTime.parse(str, formatter);

日付と時刻のフォーマット

LocalDateTimeオブジェクトからフォーマットされた文字列を作成するには、format()メソッドを使用できます。

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm");
LocalDateTime dateTime = LocalDateTime.of(1986, Month.APRIL, 8, 12, 30);
String formattedDateTime = dateTime.format(formatter); // "1986-04-08 12:30"

で定数として事前定義されている一般的に使用される日付/時刻形式がいくつかあることに注意してくださいDateTimeFormatter。例：上からインスタンスDateTimeFormatter.ISO_DATE_TIMEをフォーマットするために使用するLocalDateTimeと、文字列になります"1986-04-08T12:30:00"。

parse()およびformat()方法は、すべての日付/時間関連オブジェクト（例えばのために用意されていLocalDateたりZonedDateTime）

また、使用することができるLocalDate.parse()かLocalDateTime.parse()でStringあれば、パターンとそれを提供することなくStringであるISO-8601形式。

例えば、

String strDate = "2015-08-04";
LocalDate aLD = LocalDate.parse(strDate);
System.out.println("Date: " + aLD);

String strDatewithTime = "2015-08-04T10:11:30";
LocalDateTime aLDT = LocalDateTime.parse(strDatewithTime);
System.out.println("Date with Time: " + aLDT);

出力、

Date: 2015-08-04
Date with Time: 2015-08-04T10:11:30

DateTimeFormatter他の日付パターンを処理する必要がある場合にのみ使用してください。

たとえば、次の例では、dd MMM uuuuは日（2桁）、月の名前の3文字（Jan、Feb、Mar、...）、および4桁の年を表します。

DateTimeFormatter dTF = DateTimeFormatter.ofPattern("dd MMM uuuu");
String anotherDate = "04 Aug 2015";
LocalDate lds = LocalDate.parse(anotherDate, dTF);
System.out.println(anotherDate + " parses to " + lds);

出力

04 Aug 2015 parses to 2015-08-04

また、DateTimeFormatterオブジェクトが双方向であることも忘れないでください。入力の解析と出力のフォーマットの両方を行うことができます。

String strDate = "2015-08-04";
LocalDate aLD = LocalDate.parse(strDate);
DateTimeFormatter dTF = DateTimeFormatter.ofPattern("dd MMM uuuu");
System.out.println(aLD + " formats as " + dTF.format(aLD));

出力

2015-08-04 formats as 04 Aug 2015

（DateFormatterのフォーマットと解析のパターンの完全なリストを参照してください）

  Symbol  Meaning                     Presentation      Examples
  ------  -------                     ------------      -------
   G       era                         text              AD; Anno Domini; A
   u       year                        year              2004; 04
   y       year-of-era                 year              2004; 04
   D       day-of-year                 number            189
   M/L     month-of-year               number/text       7; 07; Jul; July; J
   d       day-of-month                number            10

   Q/q     quarter-of-year             number/text       3; 03; Q3; 3rd quarter
   Y       week-based-year             year              1996; 96
   w       week-of-week-based-year     number            27
   W       week-of-month               number            4
   E       day-of-week                 text              Tue; Tuesday; T
   e/c     localized day-of-week       number/text       2; 02; Tue; Tuesday; T
   F       week-of-month               number            3

   a       am-pm-of-day                text              PM
   h       clock-hour-of-am-pm (1-12)  number            12
   K       hour-of-am-pm (0-11)        number            0
   k       clock-hour-of-am-pm (1-24)  number            0

   H       hour-of-day (0-23)          number            0
   m       minute-of-hour              number            30
   s       second-of-minute            number            55
   S       fraction-of-second          fraction          978
   A       milli-of-day                number            1234
   n       nano-of-second              number            987654321
   N       nano-of-day                 number            1234000000

   V       time-zone ID                zone-id           America/Los_Angeles; Z; -08:30
   z       time-zone name              zone-name         Pacific Standard Time; PST
   O       localized zone-offset       offset-O          GMT+8; GMT+08:00; UTC-08:00;
   X       zone-offset 'Z' for zero    offset-X          Z; -08; -0830; -08:30; -083015; -08:30:15;
   x       zone-offset                 offset-x          +0000; -08; -0830; -08:30; -083015; -08:30:15;
   Z       zone-offset                 offset-Z          +0000; -0800; -08:00;

   p       pad next                    pad modifier      1

   '       escape for text             delimiter
   ''      single quote                literal           '
   [       optional section start
   ]       optional section end
   #       reserved for future use
   {       reserved for future use
   }       reserved for future use

上記の両方の回答は、文字列パターンに関する質問を非常によく説明しています。ただし、ISO 8601を使用している場合にDateTimeFormatter備えて、LocalDateTimeはすでに準備されているため、適用する必要はありません。

LocalDateTimeをタイムゾーンISO8601文字列に変換

LocalDateTime ldt = LocalDateTime.now(); 
ZonedDateTime zdt = ldt.atZone(ZoneOffset.UTC); //you might use a different zone
String iso8601 = zdt.toString();

ISO8601文字列からLocalDateTimeに変換して戻す

String iso8601 = "2016-02-14T18:32:04.150Z";
ZonedDateTime zdt = ZonedDateTime.parse(iso8601);
LocalDateTime ldt = zdt.toLocalDateTime();

日付と時刻を含む文字列を特定の時点（Javaでは「Instant」と呼びます）に解析するのは非常に複雑です。Javaはこれに何度も取り組んでいます。最新のもの、java.timeおよびはjava.time.chrono、ほぼすべてのニーズをカバーします（時間拡張 :) を除く）。

ただし、その複雑さは多くの混乱をもたらします。

日付の解析を理解するための鍵は次のとおりです。

なぜJavaには日付を解析するための非常に多くの方法があるのですか

1. 時間を測定するシステムはいくつかあります。たとえば、歴史的な日本の暦は、それぞれの皇帝または王朝の治世の時間範囲から導き出されました。次に、UNIXタイムスタンプなどがあります。幸いなことに、（ビジネス）世界全体で同じように使用することができました。
2. 歴史的に、システムはさまざまな理由で切り替えられていました。たとえば、1582年のユリウス暦からグレゴリオ暦までです。そのため、それより前の「西洋」の日付は異なる方法で処理する必要があります。
3. そしてもちろん、変化はすぐには起こりませんでした。一部の宗教の本部や他の食生活を信じるヨーロッパの他の地域からカレンダーが来たため、たとえばドイツは1700年まで切り替わりませんでした。

...そしてなぜLocalDateTime、ZonedDateTime他は とても複雑

4. タイムゾーンがあります。タイムゾーンは基本的には、地球の表面の「ストライプ」* [1]であり、その当局は、どの時間オフセットがあるかについて同じ規則に従います。これには夏時間のルールが含まれます。
   時間帯は、主に誰が誰を征服したかに基づいて、さまざまな地域で時間とともに変化します。また、1つのタイムゾーンのルールも時間とともに変化します。

5. 時間オフセットがあります。タイムゾーンはたとえば「プラハ」の可能性があるため、これはタイムゾーンと同じではありませんが、夏時間のオフセットと冬時間のオフセットがあります。
   タイムゾーン付きのタイムスタンプを取得する場合、オフセットは年のどの部分にあるかによって異なります。うるう時の間、タイムスタンプは2つの異なる時間を意味する可能性があるため、追加の情報がないと確実に信頼できません。変換されました。
   注：タイムスタンプとは、「オプションでタイムゾーンやタイムオフセットを含む、日付や時刻を含む文字列」を意味します。

6. いくつかのタイムゾーンは、特定の期間の同じ時間オフセットを共有する場合があります。たとえば、サマータイムオフセットが有効でない場合、GMT / UTCタイムゾーンは「ロンドン」タイムゾーンと同じです。

もう少し複雑にするには（ただし、ユースケースではそれほど重要ではありません）。

7. 科学者たちは、時間とともに変化する地球のダイナミックを観察します。それに基づいて、彼らは個々の年の終わりに秒を追加します。（したがって2040-12-31 24:00:00、有効な日時である可能性があります。）これには、日付変換を正しく行うためにシステムが使用するメタデータの定期的な更新が必要です。たとえばLinuxでは、これらの新しいデータを含むJavaパッケージが定期的に更新されます。

8. 更新では、履歴と将来の両方のタイムスタンプの以前の動作が常に維持されるわけではありません。そのため、いくつかのタイムゾーンの変更の前後の2つのタイムスタンプを比較すると、異なるバージョンのソフトウェアで実行すると、異なる結果が得られる場合があります。これは、影響を受けるタイムゾーンと他のタイムゾーンとの比較にも適用されます。

   これによりソフトウェアにバグが発生する場合は、UNIXタイムスタンプのような複雑なルールがないタイムスタンプの使用を検討してください。

9. 7のため、将来の日付については、確実に日付を正確に変換することはできません。したがって、たとえば、の現在の解析は8524-02-17 12:00:00、将来の解析から数秒ずれる可能性があります。

このためのJDKのAPIは、現代のニーズとともに進化しました

• 初期のJavaリリースにはjava.util.Date、年、月、日、時間しかないという前提で、どちらかというと単純な方法がありました。これはすぐには不十分でした。
• また、データベースのニーズは異なっていたため、かなり早い段階でjava.sql.Date導入されましたが、独自の制限があります。
• どちらも異なるカレンダーとタイムゾーンをうまくカバーしていないため、CalendarAPIが導入されました。
• これはまだタイムゾーンの複雑さをカバーしていませんでした。それでも、上記のAPIを組み合わせるのは本当に大変な作業でした。そのため、Java開発者がグローバルなWebアプリケーションに取り組み始めたとき、JodaTimeなどのほとんどのユースケースを対象としたライブラリが急速に普及しました。JodaTimeは、約10年間、事実上の標準でした。
• しかし、JDKはJodaTimeと統合していなかったため、JDKでの作業は少し面倒でした。したがって、この問題への取り組み方について非常に長い議論の末、JSR-310は主にJodaTimeに基づいて作成されました。

Javaでそれを処理する方法 java.time

タイムスタンプを解析するタイプを決定します

タイムスタンプ文字列を使用する場合は、それに含まれる情報を知る必要があります。これが決定的なポイントです。これを正しく行わないと、「インスタントを作成できません」、「ゾーンオフセットが見つかりません」、「不明なゾーンID」などの不可解な例外が発生します。

• TemporalAccessorからOffsetDateTimeを取得できません
• TemporalAccessorからZonedDateTimeを取得できません
• TemporalAccessorからLocalDateTimeを取得できません
• TemporalAccessorからインスタントを取得できません

日付と時刻が含まれていますか？

1. 時間オフセットはありますか？
   時間オフセットは+hh:mm部品です。時には、「ズールー時間」、協定世界時、またはグリニッジ標準時として+00:00置き換えられる場合があります。これらはタイムゾーンも設定します。 これらのタイムスタンプには、を使用します。ZUTCGMT
OffsetDateTime

2. タイムゾーンはありますか？
   これらのタイムスタンプには、を使用しますZonedDateTime。
   ゾーンは、

   • 名前（「プラハ」、「太平洋標準時」、「PST」）、または
   • で表される"ゾーンID"（ "アメリカ/ Los_Angeles"、 "ヨーロッパ/ロンドン"）、java.time.ZoneId。

   タイムゾーンのリストは、ICAANが支援する「TZデータベース」によって編集されます。

   ZoneIdのjavadocによると、ゾーンIDもZオフセットとして指定できます。これが実際のゾーンにどのようにマッピングされるかはわかりません。TZしかないタイムスタンプがうるう時の時間オフセット変更に該当する場合は、あいまいであり、解釈の対象となりResolverStyleます。以下を参照してください。

3. どちらもない場合、不足しているコンテキストが想定されるか無視されます。そして消費者は決定しなければなりません。したがって、それを解析し、不足している情報を追加してLocalDateTime変換する必要がありますOffsetDateTime。

   • UTC時間であると想定できます。0時間のUTCオフセットを追加します。
   • それは変換が起こっている場所の時であると想定することができます。システムのタイムゾーンを追加して変換します。
   • 無視してそのまま使用できます。これは、たとえば2回比較または減算する場合（参考文献を参照Duration）、または知らない場合に本当に重要ではない場合（ローカルバスのスケジュールなど）に役立ちます。

部分的な時間情報

• タイムスタンプが含まれているものに基づいて、あなたが取ることができLocalDate、LocalTime、OffsetTime、MonthDay、Year、またはYearMonthそれから。

完全な情報がある場合は、を取得できますjava.time.Instant。これは内部で使用され、OffsetDateTimeとのZonedDateTimeます。

それを解析する方法を理解する

に関する広範なドキュメントがあります DateTimeFormatterタイムスタンプ文字列の解析と文字列へのフォーマットの両方が可能あります。

事前に作成されたDateTimeFormatterのは、詳細表示を隠すすべての標準的なタイムスタンプのフォーマットをカバーする必要があります。たとえば、ISO_INSTANT解析できます2011-12-03T10:15:30.123457Z。

特別なフォーマットがある場合は、独自のDateTimeFormatter（これもパーサーです）を作成できます。

private static final DateTimeFormatter TIMESTAMP_PARSER = new DateTimeFormatterBuilder()
   .parseCaseInsensitive()
   .append(DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm:ss.SX"))
   .toFormatter();

のソースコードを見て、DateTimeFormatterを使用してビルドする方法を学ぶことをお勧めしますDateTimeFormatterBuilder。そこにいる間ResolverStyle、パーサーが形式とあいまいな情報に関してLENIENT、SMART、またはSTRICTのどれであるかを制御する方法も見てください。

TemporalAccessor

さて、よくある間違いは、の複雑さに陥ることですTemporalAccessor。これは、開発者がで作業する方法に由来しますSimpleDateFormatter.parse(String)。そう、DateTimeFormatter.parse("...")あなたに与えますTemporalAccessor。

// No need for this!
TemporalAccessor ta = TIMESTAMP_PARSER.parse("2011-... etc");

しかし、前のセクションの知識を備えていれば、必要なタイプに簡単に解析できます。

OffsetDateTime myTimestamp = OffsetDateTime.parse("2011-12-03T10:15:30.123457Z", TIMESTAMP_PARSER);

実際にはDateTimeFormatterどちらも必要ありません。解析する型にはparse(String)メソッドがあります。

OffsetDateTime myTimestamp = OffsetDateTime.parse("2011-12-03T10:15:30.123457Z");

に関してTemporalAccessorは、文字列にどのような情報が含まれているかが曖昧で、実行時に決定したい場合に使用できます。

私はあなたの魂にいくつかの理解の光を当てることを望みます:)

注：java.timeJava 6および7へのバックポート：ThreeTen-Backportがあります。Androidの場合、ThreeTenABPがあります。

[1]それらは縞模様ではないというだけでなく、いくつかの奇妙な極端なものもあります。たとえば、一部の隣接する太平洋諸島には、+ 14：00と-11：00のタイムゾーンがあります。つまり、ある島では5月1日の午後3時があり、別の島ではそれほど遠くない場合でも、4月30日は午後12時のままです（正しくカウントした場合:)）。

必要な形式で現在のUTC時間を取得する

// Current UTC time
        OffsetDateTime utc = OffsetDateTime.now(ZoneOffset.UTC);

        // GET LocalDateTime 
        LocalDateTime localDateTime = utc.toLocalDateTime();
        System.out.println("*************" + localDateTime);

        // formated UTC time
        DateTimeFormatter dTF = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm");
        System.out.println(" formats as " + dTF.format(localDateTime));

        //GET UTC time for current date
        Date now= new Date();
        LocalDateTime utcDateTimeForCurrentDateTime = Instant.ofEpochMilli(now.getTime()).atZone(ZoneId.of("UTC")).toLocalDateTime();
        DateTimeFormatter dTF2 = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm");
        System.out.println(" formats as " + dTF2.format(utcDateTimeForCurrentDateTime));

このような日付時刻形式の複数のバリアントをカバーするのは素晴らしいことです。

final DateTimeFormatterBuilder dtfb = new DateTimeFormatterBuilder();
dtfb.appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSSSS"))
.appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSSS"))
.appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSS"))
.appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSS"))
.appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSS"))
.appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSS"))
    .appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSS"))
    .appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SS"))
    .appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.S"))
    .parseDefaulting(ChronoField.HOUR_OF_DAY, 0)
    .parseDefaulting(ChronoField.MINUTE_OF_HOUR, 0)
    .parseDefaulting(ChronoField.SECOND_OF_MINUTE, 0);