Introduction to Date and Time API

Transcript

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) wANSI/ISO Cͱػೳతʹಉ౳
   wUTC
   PS
   ϩʔΧϧλΠϜκʔϯ
   w೥݄೔࣌෼ඵΛऔಘɾઃఆՄ
   w೔෇ͱ࣌ࠁΛಉ͡ΫϥεͰද͢
4. java.util.Date (JDK 1.1) wࠃࡍԽରԠʜ࣮૷ΛCalendarϕʔεʹஔ ͖׵͑
   w೥݄೔࣌෼ඵΛૢ࡞͢Δϝιου ͸͢΂ͯඇਪ঑ˠCalendarͰ୅ସ
   w೔෇ૢ࡞͸CalendarʹҠߦɺ%BUF͸೔ ࣌Λࢦ͚ࣔͩ͢͠
5. java.util.Dateͷ՝୊ wϑΟʔϧυૢ࡞͕໘౗
   w ೥ϑΟʔϧυ ͕࣮ࡍͷ೥
   w ݄͕0͔Β࢝·Δ ݄ˠɺ݄ˠ
   w೔෇෦ͱ࣌ࠁ෦͕ࠞࡏ͍ͯ͠Δ
   w೔෇ԋࢉͱϑΥʔϚοτػೳ͕ශऑ
6. JSR 310
   Date and Time API
7. Michael Nascimento Santos Stephen Colebourne Roger Riggs
8. JSR 310 : Date and Time API wDateɺCalendarɺDateFormat౳Λஔ͖ ׵͑Δ͜ͱ͕໨త
   wISO 8601ܗࣜͷ೔෇ɾ࣌ࠁදݱ
   wImmutable͔ͭεϨουηʔϑͳAPI
   wઃܭࢥ૝͸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. ϝϦοτ
    w݄1ʙ12
    Date, Calendar͸0ʙ11
    wtoStringͰISO 8601ܗࣜΛฦ͢
    w೔෇ͱ࣌ࠁΛ෼཭͢Δ͜ͱ͕Ͱ͖Δ
    wଟ༷ͳ೔෇ԋࢉػೳΛ࣋ͭ
    wεϨουηʔϑͰ͋Δ
15. σϝϦοτ
    w αΠζ͕େ͖͍
    Ϋϥε਺͕ଟ͍ 
 ˠ
    Java SE APIͷதͰ΋࠷େڃ
    w طଘAPIͱͷޓ׵ੑʹ๡͍͠
    w ࠓޙͷల։ JPA΍JAXB΁ͷରԠ ͕ෆ໌ྎ w Early Draft Reviewޙ΋සൟͳ࢓༷มߋ
16. ࢀߟ: ISO 8601ܗࣜ w ೔෇
    yyyy-MM-dd • 2012-11-10 w ࣌ࠁ
    hh:mm:ss.SSSZ
    • 07:30:00.000Z w ೔࣌
    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. %BUF 5JNF %BUF5JNF -PDBM ೥݄೔
    ! ࣌ࠩ৘ใͳ͠ ! ࣌෼ඵະຬ
    ࣌ࠩ৘ใͳ͠ ೥݄೔
    ࣌෼ඵະຬ
    ࣌ࠩ৘ใͳ͠ 0⒎TFU ೥݄೔
    ! 65$͔Βͷ࣌ࠩ ! ࣌෼ඵະຬ
    65$͔Βͷ࣌ࠩ ೥݄೔
    ࣌෼ඵະຬ
    65$͔Βͷ࣌ࠩ ;POFE /" /" ೥݄೔
    ࣌෼ඵະຬ
    λΠϜκʔϯ
25. OffsetDateTime vs. ZonedDateTime wOffsetDateTime
    
    UTC͔Βͷ࣌ࠩ
    wZonedDateTime
    
    ࣮ࡍͷλΠϜκʔϯ
    ˞λΠϜκʔϯʹΑͬͯ͸͕࣌ࠩมಈ͢Δ
    wՆ࣌ؒ
    
    ಋೖࠃͰ͸ຖ೥ൃੜ
    wλΠϜκʔϯͷ࣌ࠩͷมߋ
26. Period : ظؒΫϥε wظؒΛද͢
    ྫ
    ϲ݄ͱ೔ͱ࣌ؒ
    wϑΟʔϧυ௚઀ࢦఆɺͭͷDateTimeɺ Duration͔Βੜ੒
    wϑΟʔϧυऔಘɺPeriodͷplus/minusɺ Duration΁ͷม׵ͳͲΛαϙʔτ
    wDurationʹରԠ͢Δਓؒ޲͚දݱ
27. Chronology : ྐྵΫϥε • ChronologyΫϥε:
 ྐྵͷ৘ใΛอ࣋ɺChronoDateΛੜ੒ • ChronoDateΫϥε:
 DateTimeΛϥοϓ֤ͯ͠ʑͷྐྵʹม׵
 ˞࠷৽ͷ࣮૷Ͱ͸ෳ਺Ϋϥεʹ෼ׂ
    ChronoLocalDateɺChronoOffsetDateTime౳
28. ChronologyͷαϒΫϥε
    • ISOChronology - ISO 8601 ඪ४
    • JapaneseChronology
    
    ࿨ྐྵ ೔ຊ
    • ThaiBuddhistChronology
    
    ෹ྐྵ λΠ
    • MinguoChronology
    
    ຽࠃلݩ ୆࿷
    • HijrahChronology
    
    ΠεϥϜྐྵ
29. ೔෇ɾ࣌ࠁԋࢉ
    wDateTimeɺPeriodɺInstantɺDuration͸ ͦΕࣗ਎͕ՃࢉɾݮࢉػೳΛ࣋ͭ
    wϑΟʔϧυΛද͢Ϋϥεɾྻڍܕ͕֤छ ԋࢉΛఏڙ
    w Year
    ˠ
    ͏Δ͏೥൑ఆ
    w Month
    ˠ
    ݄ͷ೔਺औಘ
    w DayOfWeek
    ˠ
    ༵೔औಘ
30. ϑΥʔϚοτػೳ
    wDateTimeFormatter:
    
 ग़ྗܗࣜΛΧελϚΠζ͢Δ
    wDateTimeFormatterBuilder͔Βൺֱత؆ ୯ʹDateTimeFormatterΛੜ੒Մೳ
    wjava.text.DateFormat͸JSR 310Ͱ͸࢖༻ Ͱ͖ͳ͍
31. Examples
32. 
    ࠓ೔ͷ೔෇ΛऔಘˠEBUF
    LocalDate date = LocalDate.now();
33. 
    ೥݄೔ˠEBUF
    LocalDate date = 
 LocalDate.of(2012, 11, 10);
34. 
    ࠓ೔ͷ೔෇ˠE
    
    ೔ޙͷ೔෇ˠE
    LocalDate d1 = LocalDate.now(); LocalDate d2 = d1.plusDays(3);
35. 
    ࠓ೔ͷ೔෇ˠEBUF
    
    ࠓ೔ͷ࣌෼ˠEBUF5JNF
    LocalDate date = LocalDate.now(); LocalDateTime dateTime = 
 date.atTime(16, 30);
36. 
    ࠓ೔ͷ೔࣌ˠEBUF5JNF
    
    ࠓ೔ͷ೔෇ˠEBUF
    LocalDateTime dateTime = 
 LocalDateTime.now(); LocalDate date =
 LocalDate.from(dateTime);
37. 
    EBUF
    ೥݄೔
    ͏Δ͏೥
    
    ˠ
    MFBQ
    
    USVF
    LocalDate date = LocalDate.of(1992, 10, 8); boolean leap = Year.from(date).isLeap();
38. 
    ࠓ೔ͷ೔෇ˠEBUF
    
    EBUFΛඪ४ग़ྗ΁
    LocalDate date = LocalDate.now(); System.out.println(date.toString()); 2012-11-10 ग़ྗ݁Ռ
39. 
    ࠓ೔ͷ೔෇ ࿨ྐྵ ˠEBUF
    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)
    wίϯετϥΫλ
    Date(Instant instant)
 㱻ίϯετϥΫλ
    Date(long date)
    wInstant toInstant()
    ϝιου
 㱻long getTime()
    ϝιου
    ˞java.util.Calendarʹ΋ಉ༷ͷվम
42. 
    0⒎TFU%BUF5JNF͔Β*OTUBOUΛऔಘ
    
    औಘͨ͠*OTUBOU͔Β%BUFΛੜ੒
    OffsetDateTime dateTime =
 OffsetDateTime.now(); Instant instant = 
 dateTime.toInstant(); Date date = new Date(instant);
43. ଞͷAPIͱͷ࿈ܞ
    wকདྷతʹ͸JPAɺJAXB౳΁ల։༧ఆ
    wͨͩ͠ݱ࣌఺Ͱ͸۩ମతΞΫγϣϯͳ͠
    wJPA࿈ܞ͸ૣظ࣮ݱΛ໨ࢦͯ͠ܭըதɺ ͱͷ͜ͱ ͍ͭʹͳΔ͜ͱ΍Βʜ
44. Conclusion
45. JSR 310ͱ͸Կͳͷ͔ wJSR 310͸java.util.Dateͷܽ఺Λ͢΂ͯ ղܾ͠Α͏ͱ͢Δ໺৺తࢼΈ
    wաڈͱͷޓ׵ੑΛஅͪ੾Δ͜ͱͰɺ೔ ෇ɾ࣌ࠁAPIͷཧ૝Λ௥ٻͨ͠
    wਖ਼௚΍Γա͗ײ΋൱Ίͳ͍͕ɺطଘ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