その日時は Instant？LocalDateTime？

2026/05/29 開催の DroidKaigi.collect { #30@Tokyo } にて、『その日時は Instant？LocalDateTime？』 というテーマで発表しました。

Transcript

1. その⽇時は Instant？ LocalDateTime？ 2026/05/29 DroidKaigi.collect { #30@Tokyo }
2. 自己紹介 @Kaito_Dogi @Kaito-Dogi ❏ どぎー ❏ 元？ゆめみ ❏ Android App Developer ❏ フジロックが楽しみ！7⽉末！
3. Instant と LocalDateTime どう使い分けていますか？
4. 本 LT のゴール： Instant と LocalDateTime の 使い分けを整理する
5. kotlinx.datetime とは ❏ KMP 対応の⽇時を扱うライブラリ ❏ ISO 8601（国際規格）に準拠 ❏ ⽇時を表現する型や、 ⽇時の変換操作や計算操作を提供 https://github.com/Kotlin/kotlinx-datetime
6. ❏ 時間軸上の1点 ❏ v0.7.0 以降では kotlin.time に移⾏（Kotlin v2.3 以降で Stable）* // 端末の現在時刻から Instant を取得 val instantFromSystemClock = Clock.System.now() // ISO 8601 準拠の文字列を Instant にパース val instantFromUtcOffset = Instant.parse("2026-05-29T19:00:00+09:00") Instant とは * https://kotlinlang.org/docs/whatsnew23.html#standard-library
7. Use kotlin.time.Instant to represent a timestamp of the event that had already happened in the past (like a timestamp of a log entry) or will definitely happen in a well-defined instant of time in the future not far away from now (like an order confirmation deadline in 1 hour from now). Instant とは https://github.com/Kotlin/kotlinx-datetime#type-use-cases
8. Use kotlin.time.Instant to represent a timestamp of the event that had already happened in the past (like a timestamp of a log entry) or will definitely happen in a well-defined instant of time in the future not far away from now (like an order confirmation deadline in 1 hour from now). Instant とは https://github.com/Kotlin/kotlinx-datetime#type-use-cases ログのタイムスタンプ 1時間後の締め切り
9. ❏ 未来の⽇時を扱うにはリスクが伴う Instant の罠 https://codeblog.jonskeet.uk/2019/03/27/storing-utc-is-not-a-silver-bullet/
10. ❏ 未来の⽇時を扱うにはリスクが伴う ❏ タイムゾーンが変わる可能性がある（サマータイムの導⼊など） ❏ あらかじめ Instant で表現していると、⽇時への変換時にズレる ❏ 例：元々の⽇本時刻の「2026/05/29 19:00」が「20:00」に Instant の罠 xx 秒 ⽇本時刻の19:00 https://codeblog.jonskeet.uk/2019/03/27/storing-utc-is-not-a-silver-bullet/
11. ❏ 未来の⽇時を扱うにはリスクが伴う ❏ タイムゾーンが変わる可能性がある（サマータイムの導⼊など） ❏ あらかじめ Instant で表現していると、⽇時への変換時にズレる ❏ 例：元々の⽇本時刻の「2026/05/29 19:00」が「20:00」に Instant の罠 xx 秒 ⽇本時刻の20:00 (xx - yy) 秒 ⽇本時刻の19:00 https://codeblog.jonskeet.uk/2019/03/27/storing-utc-is-not-a-silver-bullet/
12. Instant で未来の⽇時を扱うには リスクが伴う
13. ❏ 壁掛け時計 ❏ どこかの⽇付と時刻を表現する ❏ タイムゾーンをもたない LocalDateTime とは val localDateTime = LocalDateTime(2026, 5, 29, 19, 0)
14. ❏ 「2026/05/29 19:00」はいつ？ LocalDateTime の罠
15. ❏ 「2026/05/29 19:00」はいつ？ ❏ タイムゾーンがないと、どこの⽇時か分からない ❏ LocalDateTime で時間軸上の1点を定めるには、タイムゾーンが必要 LocalDateTime の罠 https://sessionize.com/droidkaigi2026/
16. Use LocalDateTime to represent a time of the event that is scheduled to happen in the far future at a certain local time (like a scheduled meeting in a few months from now). You'll have to keep track of the TimeZone of the scheduled event separately. Try to avoid converting future events to Instant in advance, because time zone rules might change unexpectedly in the future. LocalDateTime とは https://github.com/Kotlin/kotlinx-datetime#type-use-cases
17. Use LocalDateTime to represent a time of the event that is scheduled to happen in the far future at a certain local time (like a scheduled meeting in a few months from now). You'll have to keep track of the TimeZone of the scheduled event separately. Try to avoid converting future events to Instant in advance, because time zone rules might change unexpectedly in the future. LocalDateTime とは https://github.com/Kotlin/kotlinx-datetime#type-use-cases 数ヶ⽉後の予定
18. LocalDateTime はタイムゾーンをもたない
19. Instant と LocalDateTime の使い分け 表現する情報 ユースケース Instant 時間軸上の1点 過去の瞬間や近い将来 ログや登録⽇時、 数分後、数時間後の 締め切り LocalDateTime どこかの⽇時 未来の予定 イベントの開始時刻
20. Instant ↔ LocalDateTime の変換 ❏ いずれもタイムゾーンが必要 ❏ Instant → LocalDateTime：どこの⽇時かを決めるため ❏ LocalDateTime → Instant：どこの⽇時かを知るため val timeZone = TimeZone.of("Asia/Tokyo") val instant = Clock.System.now() val localDateTimeFromInstant = instant.toLocalDateTime(timeZone) val localDateTime = LocalDateTime(2026, 5, 29, 19, 0) val instantFromLocalDateTime = localDateTime.toInstant(timeZone)
21. kotlinx.datetime の設計思想 https://github.com/Kotlin/kotlinx-datetime#design-overview However, there are convenience operations that take, for example, a physical instant and perform a calendar-based adjustment (such as adding a month); all such operations explicitly take time-zone information as a parameter to clearly state that their result depends on the civil time zone rules which are subject to change at any time.
22. kotlinx.datetime の設計思想 https://github.com/Kotlin/kotlinx-datetime#design-overview However, there are convenience operations that take, for example, a physical instant and perform a calendar-based adjustment (such as adding a month); all such operations explicitly take time-zone information as a parameter to clearly state that their result depends on the civil time zone rules which are subject to change at any time. すべての操作でタイムゾーンが必要
23. まとめ ❏ Instant ❏ 時間軸上の1点 ❏ 過去の瞬間や近い将来を表すのに適している ❏ LocalDateTime ❏ どこかの⽇時（タイムゾーンをもたない） ❏ 未来の予定を表すのに適している ❏ Instant ↔ LocalDateTime の変換ではタイムゾーンが必要
24. 参考資料 ❏ https://github.com/Kotlin/kotlinx-datetime ❏ https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.time/-instant/ ❏ https://kotlinlang.org/docs/whatsnew23.html#standard-library ❏ https://codeblog.jonskeet.uk/2019/03/27/storing-utc-is-not-a-silver-bullet/