要約

InstantこれらはLocalDateTime全く異なる 2 つの動物です。一方は瞬間を表し、もう一方はそうではありません。

• Instant瞬間、タイムライン内の特定のポイントを表します。
• LocalDateTime日付と時刻を表します。ただし、タイムゾーンまたは UTC からのオフセットがないため、このクラスは瞬間を表すことができません。これは、世界中のすべてのタイムゾーンの範囲である約 26 ～ 27 時間の範囲に沿った潜在的な瞬間を表します。LocalDateTime値は本質的に曖昧です。

誤った推定

LocalDateTimeむしろ、人間のためのタイムゾーンを含む日付/時刻の表現です。

あなたの記述は間違っています: ALocalDateTimeタイムゾーンがありません。タイムゾーンがないのがそのクラスのポイントです。

そのクラスのドキュメントを引用すると:

このクラスは、タイムゾーンを保存または表すものではありません。代わりに、誕生日に使用される日付の説明と、壁掛け時計に表示される現地時間を組み合わせたものです。オフセットやタイムゾーンなどの追加情報なしでは、タイムライン上の瞬間を表すことはできません。

つまり、Local…「ゾーン分けなし、オフセットなし」という意味です。

Instant

アンInstantタイムライン上の瞬間UTC、カウントナノ秒1970 UTC の最初の瞬間のエポックから (基本的に、詳細についてはクラス ドキュメントを参照してください)。ビジネス ロジック、データ ストレージ、およびデータ交換のほとんどは UTC で行う必要があるため、これは頻繁に使用する便利なクラスです。

Instant instant = Instant.now() ;  // Capture the current moment in UTC.

OffsetDateTime

クラスOffsetDateTimeクラスは、UTCより何時間・分・秒進んでいるか遅れているかのコンテキストを持つ日付と時刻として瞬間を表します。オフセットの量、つまり何時間・分・秒の数は、ZoneOffsetクラス。

時間・分・秒の数がゼロの場合、OffsetDateTimeUTCの瞬間を表す。Instant。

ZoneOffset

のZoneOffsetクラスはUTCからのオフセットUTC より進んでいる、または遅れている時間・分・秒数。

AZoneOffsetは単なる時間、分、秒の数値であり、それ以上のものではありません。ゾーンはそれ以上のものであり、名前とオフセットの変更履歴を持ちます。したがって、ゾーンを使用する方が、単なるオフセットを使用するよりも常に望ましいです。

ZoneId

あタイムゾーンは、ZoneIdクラス。

新しい一日が早く明けるパリよりもモントリオール例えば、時計の針を動かして、よりよく反映させる必要があります。正午(太陽が真上にあるとき) 特定の地域におけるオフセット。西ヨーロッパ/アフリカの UTC ラインから東/西に離れるほど、オフセットは大きくなります。

タイムゾーンとは、地域社会や地域で実践されている調整や異常に対処するための一連のルールです。最も一般的な異常は、あまりにも一般的な狂気として知られているものです。夏時間 (DST)。

タイムゾーンには、過去のルール、現在のルール、近い将来に確定するルールの履歴があります。

これらのルールは予想以上に頻繁に変更されます。日付時刻ライブラリのルールは必ず保存しておいてください。通常は「tz」データベース、最新の状態に保つ。OracleがリリースしたJava 8では、最新の状態を維持するのがこれまで以上に簡単になりました。タイムゾーン更新ツール。

指定する適切なタイムゾーン名、、Continent/Regionまたはなどの の形式で使用します。や などの 2 ～ 4 文字の略語は、実際のタイムゾーンではなく、標準化されておらず、一意でもありません(!)ので、使用しないでください。America/MontrealAfrica/CasablancaPacific/AucklandESTIST

タイムゾーン = オフセット + 調整ルール

ZoneId z = ZoneId.of( “Africa/Tunis” ) ; 

ZonedDateTime

のことを考えるZonedDateTime概念的には、 がInstant割り当てられたとしてZoneId。

ZonedDateTime = ( インスタント + ゾーン ID )

特定の地域 (タイムゾーン) の人々が使用する壁時計の時刻で現在の瞬間をキャプチャするには、次のようにします。

ZonedDateTime zdt = ZonedDateTime.now( z ) ;  // Pass a `ZoneId` object such as `ZoneId.of( "Europe/Paris" )`. 

バックエンド、データベース、ビジネスロジック、データ永続性、データ交換のほぼすべてはUTCでなければなりません。しかし、ユーザーへのプレゼンテーションでは、ユーザーが期待するタイムゾーンに調整する必要があります。これがクラスの目的でありZonedDateTime、フォーマッタクラスこれらの日付と時刻の値の文字列表現を生成するために使用されます。

ZonedDateTime zdt = instant.atZone( z ) ;
String output = zdt.toString() ;                 // Standard ISO 8601 format.

DateTimeFormatter f = DateTimeFormatter.ofLocalizedDateTime( FormatStyle.FULL ).withLocale( Locale.CANADA_FRENCH ) ; 
String outputFormatted = zdt.format( f ) ;

LocalDate ld = LocalDate.of( 2018 , Month.DECEMBER , 25 ) ;
LocalTime lt = LocalTime.MIN ;   // 00:00:00
LocalDateTime ldt = LocalDateTime.of( ld , lt ) ;  // Christmas morning anywhere. 

ZonedDateTime zdt = ldt.atZone( z ) ;  // Given a date, a time-of-day, and a time zone, determine a moment, a point on the timeline.

Instant instant = zdt.toInstant() ;  // Adjust from some zone to UTC. Same moment, same point on the timeline, different wall-clock time.

// Storing
OffsetDateTime odt = instant.atOffset( ZoneOffset.UTC ) ;
myPreparedStatement.setObject( … , odt ) ;

// Retrieving
OffsetDateTime odt = myResultSet.getObject( … , OffsetDateTime.class ) ;
Instant instant = odt.toInstant() ;

// Storing
OffsetDateTime odt = zdt.toOffsetDateTime() ;
myPreparedStatement.setObject( … , odt ) ;

// Retrieving
OffsetDateTime odt = myResultSet.getObject( … , OffsetDateTime.class ) ;
ZoneId z = ZoneId.of( "Asia/Kolkata" ) ;
ZonedDateTime zdt = odt.atZone( z ) ;