Introduction to Date and Time API (2012-11-10)

1. Introduction to
Date and Time API
HASUNUMA Kenji
Vice president, GlassFish Users Group Japan
k.hasunuma@coppermine.jp
Twitter: @btnrouge
November 10, 2012

2. Javaにおける日付・時刻の扱い
JDK 1.1 以降、本質的には変化なし

3. java.util.Date (JDK 1.0)
•ANSI/ISO Cと機能的に同等
•UTC or ローカルタイムゾーン
•年/月/日/時/分/秒を取得・設定可
•日付と時刻を同じクラスで表す

4. java.util.Date (JDK 1.1)
•国際化対応…実装をCalendarベースに置
き換え
•年/月/日/時/分/秒を操作するメソッド
はすべて非推奨→Calendarで代替
•日付操作はCalendarに移行、Dateは日
時を指し示すだけ

5. java.util.Dateの課題
•フィールド操作が面倒
• 年フィールド+1900が実際の年
• 月が0から始まる(1月→0、12月→11)
•日付部と時刻部が混在している
•日付演算とフォーマット機能が貧弱

6. JSR 310
Date and Time API

7. Michael Nascimento Santos
Stephen Colebourne
Roger Riggs

8. JSR 310 : Date and Time API
•Date、Calendar、DateFormat等を置き
換えることが目的
•ISO 8601形式の日付・時刻表現
•ImmutableかつスレッドセーフなAPI
•設計思想はJoda-Timeに酷似

9. Joda-Time JSR 310

10. Second System Syndrome

11. More simply

12. JSR 310 : Date and Time API
2007年2月 - JSR 310承認、EG発足
2008年5月 - JavaOne 2008で発表
2010年3月 - Early Draft Review (1回目)
2012年10月 - Early Draft Review (2回目)
2013年10月? - Java SE 8リリース

13. java.util.Date JSR 310
オブジェクト Mutable Immutable
精度 ミリ秒 ナノ秒
フィールドR/W Calendar経由 直接サポート
タイムゾーン サポート サポート
toString戻り値 Unix形式 ISO 8601形式
日付と時刻の分離 不可 可能
日付演算 比較のみ 様々な日付演算
関連クラス数 数個 たくさん

14. メリット
•月:1∼12 (Date, Calendarは0∼11)
•toStringでISO 8601形式を返す
•日付と時刻を分離することができる
•多様な日付演算機能を持つ
•スレッドセーフである

15. デメリット
• サイズが大きい (クラス数が多い)
→ Java SE APIの中でも最大級
• 既存APIとの互換性に乏しい
• 今後の展開(JPAやJAXBへの対応)が不明瞭
• Early Draft Review後も頻繁な仕様変更

16. 参考: ISO 8601形式
• 日付: yyyy-MM-dd
• 2012-11-10
• 時刻: hh:mm:ss.SSSZ
• 07:30:00.000Z
• 日時: yyyy-MM-dd’T’HH:mm:ss.SSSZ
• 2012-11-10T07:30:00.000Z

17. JSR 310 Essentials

18. マシン向けの表現(内部表現)
• Instant
• Duration
• Clock
人間向けの表現(外部表現)
• DateTime
• Period
• Chronology

19. Instant

20. Duration

21. Clock

22. DateTime : 日付・時刻クラス
• DateTimeインタフェースの実装
• 現在日時または任意の日時から生成
• DateTimeの演算(plus/minus)および他の
DateTimeからの変換をサポート
• Instantに対応する人間向け表現

23. DateTimeインタフェースの実装
• LocalDate, LocalTime, LocalDateTime
• OffsetDate, OffsetTime, OffsetDateTime
• ZonedDateTime
• 不足情報の追加または余剰情報の切り捨
てにより相互に変換可

24. Date Time DateTime
Local
年/月/日
!
時差情報なし
!
時/分/秒/未満
時差情報なし
年/月/日
時/分/秒/未満
時差情報なし
Offset
年/月/日
!
UTCからの時差
!
時/分/秒/未満
UTCからの時差
年/月/日
時/分/秒/未満
UTCからの時差
Zoned N/A N/A
年/月/日
時/分/秒/未満
タイムゾーン

25. OffsetDateTime vs. ZonedDateTime
•OffsetDateTime - UTCからの時差
•ZonedDateTime - 実際のタイムゾーン
※タイムゾーンによっては時差が変動する
•夏時間 - 導入国では毎年発生
•タイムゾーンの時差の変更

26. Period : 期間クラス
•期間を表す (例: 3ヶ月と4日と7時間)
•フィールド直接指定、2つのDateTime、
Durationから生成
•フィールド取得、Periodのplus/minus、
Durationへの変換などをサポート
•Durationに対応する人間向け表現

27. Chronology : 暦クラス
• Chronologyクラス:
暦の情報を保持、ChronoDateを生成
• ChronoDateクラス:
DateTimeをラップして各々の暦に変換
※最新の実装では複数クラスに分割:
ChronoLocalDate、ChronoOffsetDateTime等

28. Chronologyのサブクラス
• ISOChronology - ISO 8601(標準)
• JapaneseChronology - 和暦(日本)
• ThaiBuddhistChronology - 仏暦(タイ)
• MinguoChronology - 民国紀元(台湾)
• HijrahChronology - イスラム暦

29. 日付・時刻演算
•DateTime、Period、Instant、Durationは
それ自身が加算・減算機能を持つ
•フィールドを表すクラス・列挙型が各種
演算を提供:
• Year → うるう年判定
• Month → 月の日数取得
• DayOfWeek → 曜日取得

30. フォーマット機能
•DateTimeFormatter:
出力形式をカスタマイズする
•DateTimeFormatterBuilderから比較的簡
単にDateTimeFormatterを生成可能
•java.text.DateFormatはJSR 310では使用
できない

31. Examples

32. // 今日の日付を取得→date
LocalDate date = LocalDate.now();

33. // 2012年11月10日→date
LocalDate date =
LocalDate.of(2012, 11, 10);

34. // 今日の日付→d1
// 3日後の日付→d2
LocalDate d1 = LocalDate.now();
LocalDate d2 = d1.plusDays(3);

35. // 今日の日付→date
// 今日の16時30分→dateTime
LocalDate date = LocalDate.now();
LocalDateTime dateTime =
date.atTime(16, 30);

36. // 今日の日時→dateTime
// 今日の日付→date
LocalDateTime dateTime =
LocalDateTime.now();
LocalDate date =
LocalDate.from(dateTime);

37. // date: 1992年10月8日 (うるう年)
// → leap = true
LocalDate date =
LocalDate.of(1992, 10, 8);
boolean leap =
Year.from(date).isLeap();

38. // 今日の日付→date
// dateを標準出力へ
LocalDate date = LocalDate.now();
System.out.println(date.toString());
2012-11-10
出力結果

39. // 今日の日付(和暦)→date
JapaneseChronology chrono =
JapaneseChronology.INSTANCE;
ChronoLocalDate<JapaneseChronology>
jdate = chrono.date(LocalDate.now());
System.out.println(jdate);
H24-11-10
出力結果

40. Compatibility

41. java.util.Dateを改修(OpenJDK8)
•コンストラクタ Date(Instant instant)
コンストラクタ Date(long date)
•Instant toInstant() メソッド
long getTime() メソッド
※java.util.Calendarにも同様の改修

42. // OffsetDateTimeからInstantを取得
// 取得したInstantからDateを生成
OffsetDateTime dateTime =
OffsetDateTime.now();
Instant instant =
dateTime.toInstant();
Date date = new Date(instant);

43. 他のAPIとの連携
•将来的にはJPA、JAXB等へ展開予定
•ただし現時点では具体的アクションなし
•JPA連携は早期実現を目指して計画中、
とのこと(いつになることやら…)

44. Conclusion

45. JSR 310とは何なのか?
•JSR 310はjava.util.Dateの欠点をすべて
解決しようとする野心的試み
•過去との互換性を断ち切ることで、日
付・時刻APIの理想を追求した
•正直やり過ぎ感も否めないが、既存API
の問題点の多くを解決した点は評価

46. JSR 310のリソース
JSR 310 Specification
http://jcp.org/en/jsr/detail?id=310
JSR 310 RI “ThreeTen”
http://threeten.sourceforge.net
https://github.com/ThreeTen/threeten

47. Introduction to Date and Time API
HASUNUMA Kenji
k.hasunuma@coppermine.jp
Twitter: @btnrouge