Jsr310

Jsr310

1. 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. 2. Javaにおける日付・時刻の扱い JDK 1.1 以降、本質的には変化なし
3. 3. java.util.Date (JDK 1.0) •ANSI/ISO Cと機能的に同等 •UTC or ローカルタイムゾーン •年/月/日/時/分/秒を取得・設定可 •日付と時刻を同じクラスで表す
4. 4. java.util.Date (JDK 1.1) •国際化対応…実装をCalendarベースに置 き換え •年/月/日/時/分/秒を操作するメソッド はすべて非推奨→Calendarで代替 •日付操作はCalendarに移行、Dateは日 時を指し示すだけ
5. 5. java.util.Dateの課題 •フィールド操作が面倒 • 年フィールド+1900が実際の年 • 月が0から始まる(1月→0、12月→11) •日付部と時刻部が混在している •日付演算とフォーマット機能が貧弱
6. 6. JSR 310 Date and Time API
7. 7. Michael Nascimento Santos Stephen Colebourne Roger Riggs
8. 8. JSR 310 : Date and Time API •Date、Calendar、DateFormat等を置き 換えることが目的 •ISO 8601形式の日付・時刻表現 •ImmutableかつスレッドセーフなAPI •設計思想はJoda-Timeに酷似
9. 9. Joda-Time JSR 310
10. 10. Second System Syndrome
11. 11. More simply
12. 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. 13. java.util.Date JSR 310 オブジェクト Mutable Immutable 精度 ミリ秒 ナノ秒 フィールドR/W Calendar経由 直接サポート タイムゾーン サポート サポート toString戻り値 Unix形式 ISO 8601形式 日付と時刻の分離 不可 可能 日付演算 比較のみ 様々な日付演算 関連クラス数 数個 たくさん
14. 14. メリット •月:1∼12 (Date, Calendarは0∼11) •toStringでISO 8601形式を返す •日付と時刻を分離することができる •多様な日付演算機能を持つ •スレッドセーフである
15. 15. デメリット • サイズが大きい (クラス数が多い)
 → Java SE APIの中でも最大級 • 既存APIとの互換性に乏しい • 今後の展開(JPAやJAXBへの対応)が不明瞭 • Early Draft Review後も頻繁な仕様変更
16. 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. 17. JSR 310 Essentials
18. 18. マシン向けの表現(内部表現) • Instant • Duration • Clock 人間向けの表現(外部表現) • DateTime • Period • Chronology
19. 19. Instant
20. 20. Duration
21. 21. Clock
22. 22. DateTime : 日付・時刻クラス • DateTimeインタフェースの実装 • 現在日時または任意の日時から生成 • DateTimeの演算(plus/minus)および他の DateTimeからの変換をサポート • Instantに対応する人間向け表現
23. 23. DateTimeインタフェースの実装 • LocalDate, LocalTime, LocalDateTime • OffsetDate, OffsetTime, OffsetDateTime • ZonedDateTime • 不足情報の追加または余剰情報の切り捨 てにより相互に変換可
24. 24. Date Time DateTime Local 年/月/日 ! 時差情報なし ! 時/分/秒/未満 時差情報なし 年/月/日 時/分/秒/未満 時差情報なし Offset 年/月/日 ! UTCからの時差 ! 時/分/秒/未満 UTCからの時差 年/月/日 時/分/秒/未満 UTCからの時差 Zoned N/A N/A 年/月/日 時/分/秒/未満 タイムゾーン
25. 25. OffsetDateTime vs. ZonedDateTime •OffsetDateTime - UTCからの時差 •ZonedDateTime - 実際のタイムゾーン ※タイムゾーンによっては時差が変動する •夏時間 - 導入国では毎年発生 •タイムゾーンの時差の変更
26. 26. Period : 期間クラス •期間を表す (例: 3ヶ月と4日と7時間) •フィールド直接指定、2つのDateTime、 Durationから生成 •フィールド取得、Periodのplus/minus、 Durationへの変換などをサポート •Durationに対応する人間向け表現
27. 27. Chronology : 暦クラス • Chronologyクラス:
 暦の情報を保持、ChronoDateを生成 • ChronoDateクラス:
 DateTimeをラップして各々の暦に変換
 ※最新の実装では複数クラスに分割: ChronoLocalDate、ChronoOffsetDateTime等
28. 28. Chronologyのサブクラス • ISOChronology - ISO 8601(標準) • JapaneseChronology - 和暦(日本) • ThaiBuddhistChronology - 仏暦(タイ) • MinguoChronology - 民国紀元(台湾) • HijrahChronology - イスラム暦
29. 29. 日付・時刻演算 •DateTime、Period、Instant、Durationは それ自身が加算・減算機能を持つ •フィールドを表すクラス・列挙型が各種 演算を提供: • Year → うるう年判定 • Month → 月の日数取得 • DayOfWeek → 曜日取得
30. 30. フォーマット機能 •DateTimeFormatter: 
 出力形式をカスタマイズする •DateTimeFormatterBuilderから比較的簡 単にDateTimeFormatterを生成可能 •java.text.DateFormatはJSR 310では使用 できない
31. 31. Examples
32. 32. // 今日の日付を取得→date LocalDate date = LocalDate.now();
33. 33. // 2012年11月10日→date LocalDate date = 
 LocalDate.of(2012, 11, 10);
34. 34. // 今日の日付→d1 // 3日後の日付→d2 LocalDate d1 = LocalDate.now(); LocalDate d2 = d1.plusDays(3);
35. 35. // 今日の日付→date // 今日の16時30分→dateTime LocalDate date = LocalDate.now(); LocalDateTime dateTime = 
 date.atTime(16, 30);
36. 36. // 今日の日時→dateTime // 今日の日付→date LocalDateTime dateTime = 
 LocalDateTime.now(); LocalDate date =
 LocalDate.from(dateTime);
37. 37. // date: 1992年10月8日 (うるう年) // → leap = true LocalDate date = LocalDate.of(1992, 10, 8); boolean leap = Year.from(date).isLeap();
38. 38. // 今日の日付→date // dateを標準出力へ LocalDate date = LocalDate.now(); System.out.println(date.toString()); 2012-11-10 出力結果
39. 39. // 今日の日付(和暦)→date JapaneseChronology chrono = JapaneseChronology.INSTANCE; ChronoLocalDate<JapaneseChronology> jdate = chrono.date(LocalDate.now()); System.out.println(jdate); H24-11-10 出力結果
40. 40. Compatibility
41. 41. java.util.Dateを改修(OpenJDK8) •コンストラクタ Date(Instant instant)
 コンストラクタ Date(long date) •Instant toInstant() メソッド
 long getTime() メソッド ※java.util.Calendarにも同様の改修
42. 42. // OffsetDateTimeからInstantを取得 // 取得したInstantからDateを生成 OffsetDateTime dateTime =
 OffsetDateTime.now(); Instant instant = 
 dateTime.toInstant(); Date date = new Date(instant);
43. 43. 他のAPIとの連携 •将来的にはJPA、JAXB等へ展開予定 •ただし現時点では具体的アクションなし •JPA連携は早期実現を目指して計画中、 とのこと(いつになることやら…)
44. 44. Conclusion
45. 45. JSR 310とは何なのか? •JSR 310はjava.util.Dateの欠点をすべて 解決しようとする野心的試み •過去との互換性を断ち切ることで、日 付・時刻APIの理想を追求した •正直やり過ぎ感も否めないが、既存API の問題点の多くを解決した点は評価
46. 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. 47. Introduction to Date and Time API HASUNUMA Kenji k.hasunuma@coppermine.jp Twitter: @btnrouge