Java 8 Date/Time API
Vaidas Pilkauskas
aš
• programuotojas
• pagrindinė kalba - Java
• domiuosi kitomis kalbomis - Scala,
JavaScript, Python, Ruby
• Kai neprogra...
Legal
This work is licensed under the Creative Commons
Attribution 3.0 Unported License. To view a copy of this
license, v...
Iki JDK8
Kodėl reikalingas naujas Date/Time
API?
java.util.Date is a testament to the fact that
even brilliant programmers can scre...
java.util.Date
• Mutuojamas - galima keisti reikšmę
• Milisekundžių tikslumas nepakankamas
• new Date().getYear() //114
• ...
Nesilaikoma equals kontrakto
Date date = new Date();
Timestamp timeStamp = new
Timestamp(date.getTime());
date.equals(time...
java.util.Calendar
• Taip pat mutuojamas
• Nepatogus API
• Sunku pridėti naujus kalendorius
• Trūksta getterių paprastai d...
Joda-Time
Java ekosistemoje suvokiama kaip
“Kokybiška datos ir laiko biblioteka”
Tai kodėl ne Joda-Time yra Java 8
Date/Ti...
Nuo JDK8
JSR 310
• Nauja datos ir laiko biblioteka
• Sukurta visiškai nuo pradžių
• Įtakota Joda-Time, speco vienas iš vadovų -
Ste...
Tikslai
• Išsamus datos/laiko modelis
• Dažnai sutinkamų kalendorių palaikymas
• Tipizavimas
o vengti primityvų, kai yra p...
Projektavimo principai
• Nekeičiamumas (Immutability)
o thread-safe, tinka kešuoti, funkcinis programavimas
• Fluent API
o...
Kuo daugiau galvojame apie laiką...
Per daug savokų
• Tiek daug laiko savokų
• Pats “laikas” turi daug reikšmių
• Reikia apibrėžti nuoseklią srities kalbą!
Du pagrindiniai reikalavimai
• Tęstinis kompiuterio laikas
o vienas didėjantis skaičius
o suprojektuotas kompiuteriui
• Žm...
Mašinos skalė
Momentas - Instant
• Vienas momentinis taškas laiko linijoje
• Įvykio Timestampas
• Java class - Instant
o matuojamas nano...
Trukmė - Duration
• Laiko “kiekis” (amount)
• Nepriklauso nuo laiko linijos
• Java class - Duration
o matuojamas nanosekun...
// instant
Instant start =
Instant.ofEpochMilli(123450L);
Instant end = Instant.now();
assert start.isBefore(end);
assert ...
Tikslumas & keliamosios sekundės
Realybė
• SI sekundė fiksuoto ilgio
• Diena ilgiai gali būti skirtingi
• Astronomai sako, kad Žemė lėtėja
• Diena != (24 v...
Java milisekundės
• Java skaičiuoja milisekundes nuo 1970-01-
01
• Ką tai reiškia?
• Apibrėžimas netikslus, nes
• UTC prad...
Pasirinktas būdas
• Apibrėžta Java laiko skalė, ir susieta su
civiliniu laiku
• Vidurdienis tiksliai atitinka civilinį lai...
Žmogaus skalė
Žmogaus skalė
• Žmogaus data/laikas
o paremtas laukeliais
o metai, mėnuo, diena, minutė, sekundė
o 7 dienų savaitė, diena ...
Vietos data - Local date
• Data be laiko ir laiko zonos
• pvz., gimtadienis
• pvz., šventinė diena, atostogų pradžia
• Jav...
Vietos laikas - Local time
• Laikas be datos ir laiko zonos
• pvz., parduotuvės atidarymo laikas
• pvz., laikas sieniniame...
Vietos data su laiku - Local date-time
• Data su laiku be laiko zonos
• pvz., vietinis laikas, kada kyla lėktuvas
• Java k...
Zonos poslinkis - Zone-offset
• Poslinkis valandomis ir minutėmis nuo UTC
• Lietuva priekyje UTC - teigiama reikšmė
• JAV ...
Data ir laikas su poslinkiu - Offset
date-time
• Data ir laikas su zonos poslinkiu
• pvz., audito įrašo timestampas su lai...
Kitos klasės
• Year
• YearMonth
• MonthDay
• Month - enum
• DayOfWeek - enum
• OffsetTime - local time + zone-offset
Užklausos
• Getteriai
• Metodai grąžina geriausią tipą tam laukui
o daugumai laukų - primityvai
o enumai savaitės dienai, ...
Atnaujinimai
• Beveik viskas - nekintama (nemutuojama)
• Naudojamas 'with' metodas vietoje ‘set’
o nekeičiamas originalus ...
Derintojai - Adjusters
• Sudėtingesni pakeitimai gali būti atliekami Adjusterių
pagalba, pvz.:
o iš turimos datos gauti pa...
Laiko zonos
Laiko zonų apžvalga
• Pasaulis padalintas įvairias laiko zonas
• Vietovės laikas apibrėžiamas politinių taisyklių
o Sirija...
Laiko zonų analizė
• Keletas grupių renka ir teikia informaciją apie
TZ taisykles
o IANA "Timezone database" (TZDB)
o Wind...
Laiko zonų dizainas
• JDK javadoc:
o “TimeZone represents a time zone offset, and also
figures out daylight savings”
• JSR...
Zonų laiko tarpai ir persidengimai
• Pavasario DST “tarpas”
• Rudens DST “persidengimas”
• JSR-310 nemeta exceptionų, o Jo...
Galima pasitikrinti
ZoneId zone = ZoneId.of("Europe/London");
LocalDateTime ldt =
LocalDateTime.of(2010,10,27,1,30);
ZoneO...
Klasių santrauka
• LocalDate 2010-12-03
• LocalTime 11:05:30
• LocalDateTime 2010-12-03T11:05:30
• OffsetTime 11:05:30+01:...
Integracija
Egzistuojančios JDK klasės
• Date, Calendar, SQL kalsės ir TimeZone
o konvertavimo metodai į ir iš JSR-310 tipus
o ne depr...
ISO-8601
• Visos klasės ir toString() paremtos ISO-8601
• Pagrįstas Grigaliaus kalendoriumi
• Nusako, kaip skaičiais atvai...
SQL duomenų bazės
•
• Klasės atitinka SQL
o LocalDate DATE
o LocalTime TIME WITHOUT TIME ZONE
o LocalDateTime TIMESTAMP WI...
Kalendoriai
Calendar systems
• Bazinis kalendorius paremtas ISO-8601
o dabartinis civilinis kalendorius
o istoriškai netikslus
 katal...
Regioninės kalendorių sistemos
• Dažniausiai naudojami ne ISO kalendoriai
o Islamo, Japonų, Kinų, Budizmo ir kiti
• Pasiek...
Kalendorių chronologijos
• Chronology apibrėžia kalendoriaus sistemą
o factory’is kurti datoms
• ChronoLocalDate
• ChronoL...
Here be dragons!
• Dirbti su kitais kalendoriais sudėtinga
• Daug ISO prielaidų negalioja
• Lengva suklysti
• Būtina daryt...
Here be dragons!
• Naudokite ISO, ne Chrono klases
• See ChronoLocalDate Javadoc paaiškinimą
• Nesaugokite kalendoriaus vi...
Kas liko
Elementų kombinavimas
• Lengva apjungti datos ir laiko objektus
• Naudojant ‘at’
• taip vadinamas Fluent API
LocalDate dat...
Periodai - Periods
• Datos pagrindo laiko “kiekis” pasiekiamas žmogiškais
laukais
o 6 metai, 2 mėnesiai ir 12 dienų
• Pana...
Dabartinis laikas - Current time
• Priklauso nuo laiko zonos
o dažnai tai pamirštame
• Reikalavimai
o sustabdyti laiką tes...
Dabartinis laikas - Current time
• Pasiekti esamą laiką naudojant objektą
o vengti Singleton
o Inversion of Control
• Gali...
Dabartinis laikas - Current time
• Palaiko Inversion of Control
o inject Clock
o galima turėti 'stop time' subklasę testav...
Formatting and Parsing
• toString() grąžina ISO-8601
• Formatavimas/parsinimas palaiko šablonus
o kaip kad SimpleDateForma...
Amount between
• Lengva suskaičiuoti laikotarpį tarp dviejų datų/laikų
• Pagal vienetus
• Arba visą periodą/trukmę (Period...
Plėtimo galimybės
• Plečiama 5 būdais, parašant savo
o datos/laiko klasę
o kiekio (amount) klasę
o datos/laiko laukelius
o...
Summary
• JSR-310 naujas JDK8 Date/Time API
• Išbandykite JDK 8 buildą arba JDK 7
backportą
• http://threeten.github.com
Upcoming SlideShare
Loading in …5
×

Java 8 Date/Time API (Lithuanian)

569 views

Published on

Presentation of Old/New Date/Time APIs in JDK8

Published in: Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
569
On SlideShare
0
From Embeds
0
Number of Embeds
12
Actions
Shares
0
Downloads
8
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Java 8 Date/Time API (Lithuanian)

  1. 1. Java 8 Date/Time API Vaidas Pilkauskas
  2. 2. aš • programuotojas • pagrindinė kalba - Java • domiuosi kitomis kalbomis - Scala, JavaScript, Python, Ruby • Kai neprogramuoju - dviračiai, snieglentė, roko muzika, šiuolaikinis menas, Vilnius JUG https://www.google.com/+VaidasPilkauskas
  3. 3. Legal This work is licensed under the Creative Commons Attribution 3.0 Unported License. To view a copy of this license, visit http://creativecommons.org/licenses/by/3.0/ or send a letter to Creative Commons, 444 Castro Street, Suite 900, Mountain View, California, 94041, USA. Slides 10-62 are derived from The new JDK 1.8 Date and Time API – JSR-310 by Stephen Colebourne given at JAX 2013. All the other slides are based on various publicly available internet resources listed at the end in the reference list.
  4. 4. Iki JDK8
  5. 5. Kodėl reikalingas naujas Date/Time API? java.util.Date is a testament to the fact that even brilliant programmers can screw up. java.util.Calendar, which Sun licensed to rectify the Date mess, is a testament to the fact that average programmers can screw up, too. http://stackoverflow.com/questions/1571265/why-is-the-java-date-api-java- util-date-calendar-such-a-mess
  6. 6. java.util.Date • Mutuojamas - galima keisti reikšmę • Milisekundžių tikslumas nepakankamas • new Date().getYear() //114 • Tinkamai nepalaiko laiko juostų • Nėra patogių priemonių dirbti su intervalais • Metai prasideda nuo 1900, mėnesio diena nuo 1, visa kita nuo 0) Date date = new Date(1L); date.toString(); //Thu Jan 01 02:00:00 EET 1970
  7. 7. Nesilaikoma equals kontrakto Date date = new Date(); Timestamp timeStamp = new Timestamp(date.getTime()); date.equals(timeStamp); // true timeStamp.equals(date); // false
  8. 8. java.util.Calendar • Taip pat mutuojamas • Nepatogus API • Sunku pridėti naujus kalendorius • Trūksta getterių paprastai datų informacijai Calendar c = Calendar.getInstance(); int weekday = c.get(DAY_OF_WEEK); Date d = c.getTime();
  9. 9. Joda-Time Java ekosistemoje suvokiama kaip “Kokybiška datos ir laiko biblioteka” Tai kodėl ne Joda-Time yra Java 8 Date/Time API? Nes nepakankamai tobula. “Well, there is one key reason - Joda-Time has design flaws.“ - Stephen Colebourne http://blog.joda.org/2009/11/why-jsr-310-isn-joda-time_4941.html
  10. 10. Nuo JDK8
  11. 11. JSR 310 • Nauja datos ir laiko biblioteka • Sukurta visiškai nuo pradžių • Įtakota Joda-Time, speco vienas iš vadovų - Stephen Colebourne • Tai atviro kodo JSR projektas (palyginimui Joda-Time - atviro kodo biblioteka) o http://threeten.github.com/ o Originalus kodas BSD (3 clause) licencija o OpenJDK kodas GPL o virš 20000 testų • Yra nuportintas JDK7
  12. 12. Tikslai • Išsamus datos/laiko modelis • Dažnai sutinkamų kalendorių palaikymas • Tipizavimas o vengti primityvų, kai yra prasmė o save dokumentuojantis o draugiškas IDE • “Sutariantis” su egzistuojančiomis JDK datų/laiko klasėmis • Atsižvelgti į XML ir SQL poreikius
  13. 13. Projektavimo principai • Nekeičiamumas (Immutability) o thread-safe, tinka kešuoti, funkcinis programavimas • Fluent API o lengvai skaitomas, tarsi įprastas sakinys • Švarus, aiškus, tikėtinas o gerai apibrėžti metodai, paprastas JavaDoc o stipri būsenos kontrolė • Plečiamas o JSR/JDK autoriai visko nežino
  14. 14. Kuo daugiau galvojame apie laiką...
  15. 15. Per daug savokų • Tiek daug laiko savokų • Pats “laikas” turi daug reikšmių • Reikia apibrėžti nuoseklią srities kalbą!
  16. 16. Du pagrindiniai reikalavimai • Tęstinis kompiuterio laikas o vienas didėjantis skaičius o suprojektuotas kompiuteriui • Žmogaus o paremtas laukeliais o metai, mėnuo, diena, valanda, minutė, sekundė
  17. 17. Mašinos skalė
  18. 18. Momentas - Instant • Vienas momentinis taškas laiko linijoje • Įvykio Timestampas • Java class - Instant o matuojamas nanosekundėmis nuo 1970-01-01 o apima visatos amžiaus įvykius o problema - nėra tinkamo primityvo - 96 bitų
  19. 19. Trukmė - Duration • Laiko “kiekis” (amount) • Nepriklauso nuo laiko linijos • Java class - Duration o matuojamas nanosekundėmis o reikia 96 bitų
  20. 20. // instant Instant start = Instant.ofEpochMilli(123450L); Instant end = Instant.now(); assert start.isBefore(end); assert end.isAfter(start); // duration Duration duration = Duration.ofSeconds(12); Duration bigger = duration.multipliedBy(4); Duration biggest = bigger.plus(duration); // combination Instant later = start.plus(duration); Instant earlier = start.minus(duration);
  21. 21. Tikslumas & keliamosios sekundės
  22. 22. Realybė • SI sekundė fiksuoto ilgio • Diena ilgiai gali būti skirtingi • Astronomai sako, kad Žemė lėtėja • Diena != (24 valandos * 60 minutės * 60 SI sekundės) • Realiai dienos ilgesnės nei 86400 SI sekundės • UTC įterpia keliamąją sekundę, kad pataisytų dienos ilgį • Kompiuteriai prastai palaiko keliamąsias sekundes
  23. 23. Java milisekundės • Java skaičiuoja milisekundes nuo 1970-01- 01 • Ką tai reiškia? • Apibrėžimas netikslus, nes • UTC pradėtas tik 1972-01-01 o 1970-01-01 taigi, pradžios taškas labai nepatogus • Apibrėžimas - 86400 sekundės per dieną o kas atsitinka toje vietoje, kur įterpiama keliamoji sekundė?
  24. 24. Pasirinktas būdas • Apibrėžta Java laiko skalė, ir susieta su civiliniu laiku • Vidurdienis tiksliai atitinka civilinį laiką • Visas kitas laikas kiek įmanoma tiksliau • Diena padalinta į 86400 daleles - “sekundes” • Java epocha prasideda 1970-01-01 • Tai reiškia, kad programuotojai gali ignoruoti keliamąsias sekundes • Nieko naujo, tai UTC-SLS • Tai tik apibrėžimas, viskas priklauso nuo OS
  25. 25. Žmogaus skalė
  26. 26. Žmogaus skalė • Žmogaus data/laikas o paremtas laukeliais o metai, mėnuo, diena, minutė, sekundė o 7 dienų savaitė, diena - 24 valandos • Reikalavimai o Data ir laikas o Data be laiko o Laikas be datos o Laiko juostos skirtumas nuo UTC o Laiko zona
  27. 27. Vietos data - Local date • Data be laiko ir laiko zonos • pvz., gimtadienis • pvz., šventinė diena, atostogų pradžia • Java klasė - LocalDate o saugomi metai-mėnuo-diena // 2014-03-12
  28. 28. Vietos laikas - Local time • Laikas be datos ir laiko zonos • pvz., parduotuvės atidarymo laikas • pvz., laikas sieniniame laikrodyje • Java klasė - LocalTime o saugoma valanda-minutė-sekundė-nanosekundė // 20:30
  29. 29. Vietos data su laiku - Local date-time • Data su laiku be laiko zonos • pvz., vietinis laikas, kada kyla lėktuvas • Java klasė - LocalDateTime o apjungia LocalDate & LocalTime // 2014-03-12T20:30
  30. 30. Zonos poslinkis - Zone-offset • Poslinkis valandomis ir minutėmis nuo UTC • Lietuva priekyje UTC - teigiama reikšmė • JAV atsilieka nuo UTC - neigiama reikšmė • Java klasė - ZoneOffset o saugo sekundes -18:00 to +18:00 diapazone // +01:00
  31. 31. Data ir laikas su poslinkiu - Offset date-time • Data ir laikas su zonos poslinkiu • pvz., audito įrašo timestampas su laiko zona • Tas pats momentas - Instant, tik su papildoma poslinkio informacija • Java class - OffsetDateTime o apjungia LocalDateTime & ZoneOffset // 2014-03-12T20:30+02:00
  32. 32. Kitos klasės • Year • YearMonth • MonthDay • Month - enum • DayOfWeek - enum • OffsetTime - local time + zone-offset
  33. 33. Užklausos • Getteriai • Metodai grąžina geriausią tipą tam laukui o daugumai laukų - primityvai o enumai savaitės dienai, mėnesiui LocalDate date = LocalDate.of(2010, 12, 3); int year = date.getYear(); Month month = date.getMonth(); int dom = date.getDayOfMonth(); boolean leap = date.isLeapYear(); int monthLen = date.lengthOfMonth();
  34. 34. Atnaujinimai • Beveik viskas - nekintama (nemutuojama) • Naudojamas 'with' metodas vietoje ‘set’ o nekeičiamas originalus objektas o grąžinama nauja, patobulinta kopija o norint toliau naudoti, reikia išsisaugoti LocalDate date = LocalDate.of(2010,Month.DECEMBER,3); LocalDate later = date.withYear(2011); LocalDate between = date.with(Month.MAY);
  35. 35. Derintojai - Adjusters • Sudėtingesni pakeitimai gali būti atliekami Adjusterių pagalba, pvz.: o iš turimos datos gauti paskutinę mėnesio dieną o iš turimos datos gauti kitą antrą trečiadienį (kada kitas JUGas?) public interface TemporalAdjuster { Temporal adjustInto(Temporal input); } LocalDate adjusted = date.with(lastDayOfMonth()); LocalDate adjusted = date.with(next2ndWednesday());
  36. 36. Laiko zonos
  37. 37. Laiko zonų apžvalga • Pasaulis padalintas įvairias laiko zonas • Vietovės laikas apibrėžiamas politinių taisyklių o Sirija pakeičia vasaros laiką (DST) su 3 dienų perspėjimu o Vakarų Australija turėjo 3 metų DST eksperimentą o Brazilija keičia DST kasmet o Egiptas turėjo du DST periodus 2010 • Taisyklės apibrėžia laiko zonos poslinkio pasikeitimą o "Žiemą Lietuva bus 2 valandomis priekyje nuo UTC, o vasarą jau 3. Laikas persukamas viena valanda į priekį paskutinį kovo sekmadienį ir atsukamas atgal paskutinį spalio sekmadienį."
  38. 38. Laiko zonų analizė • Keletas grupių renka ir teikia informaciją apie TZ taisykles o IANA "Timezone database" (TZDB) o Windows o IATA - Tarptautinė oro transporto asociacija • Kiekviena grupė apibrėžia savo identifikatorių • TZDB naudoja 'Europe/Vilnius' Lietuvai • Taisyklės apibrėžia ilgalaikius DST pakeitimus • bei kada keičiasi poslinkis
  39. 39. Laiko zonų dizainas • JDK javadoc: o “TimeZone represents a time zone offset, and also figures out daylight savings” • JSR-310 atskiria atsakomybes o ZoneOffset – nuo +14:00 iki -12:00 o ZoneRules – poslinkių keitimo taisyklės o ZoneId – zonos identifikatorius, identifikuoja vietą/valdžią • Tik viena papildoma datos/laiko klasė o ZonedDateTime
  40. 40. Zonų laiko tarpai ir persidengimai • Pavasario DST “tarpas” • Rudens DST “persidengimas” • JSR-310 nemeta exceptionų, o Joda-Time meta o prasmingas datos interpretavimas o Pagal nutylėjimą - vasaros laikas // one day before DST ends (overlap of one hour) ZoneId zone = ZoneId.of("Europe/London"); ZonedDateTime dt = ZonedDateTime.of(2010, 10, 27, 1, 30, 0, 0, zone); // dt = 2010-10-27 01:30 +01:00 dt = dt.plusDays(1); // dt = 2010-10-28 01:30 +01:00 // retains the offset where possible dt = dt.plusHours(1); // dt = 2010-10-28 01:30 +00:00 // offset changes, same time
  41. 41. Galima pasitikrinti ZoneId zone = ZoneId.of("Europe/London"); LocalDateTime ldt = LocalDateTime.of(2010,10,27,1,30); ZoneOffsetTransition trn = zone.getRules().getTransition(ldt); if (trn != null) { if (trn.isGap()) { ... } if (trn.isOverlap()) { ... } }
  42. 42. Klasių santrauka • LocalDate 2010-12-03 • LocalTime 11:05:30 • LocalDateTime 2010-12-03T11:05:30 • OffsetTime 11:05:30+01:00 • OffsetDateTime 2010-12-03T11:05:30+01:00 • ZonedDateTime 2010-12-03T11:05:30+01:00 Europe/Paris • Year 2010 • YearMonth 2010-12 • MonthDay 12-03 • Instant 2576458258.266 epoch- seconds
  43. 43. Integracija
  44. 44. Egzistuojančios JDK klasės • Date, Calendar, SQL kalsės ir TimeZone o konvertavimo metodai į ir iš JSR-310 tipus o ne deprecated :( • JSR-310 nepriklauso nuo senųjų klasių (teoriškai reiškia, kad kažkada galima bus išmesti senąsias klases)
  45. 45. ISO-8601 • Visos klasės ir toString() paremtos ISO-8601 • Pagrįstas Grigaliaus kalendoriumi • Nusako, kaip skaičiais atvaizduoti datas/laikus • Kitų internetinių standartų bazė, tokių kaip XML o XML schema gerai atitinka JSR-310 klases
  46. 46. SQL duomenų bazės • • Klasės atitinka SQL o LocalDate DATE o LocalTime TIME WITHOUT TIME ZONE o LocalDateTime TIMESTAMP WITHOUT TIMEZONE o OffsetTime TIME WITH TIME ZONE o OffsetDateTime TIMESTAMP WITH TIME ZONE • JDBC atnaujintas, kad atitiktų JSR-310
  47. 47. Kalendoriai
  48. 48. Calendar systems • Bazinis kalendorius paremtas ISO-8601 o dabartinis civilinis kalendorius o istoriškai netikslus  katalikai - 1582  britai - 1752  rusai - 1917? • Reikalavimai o JDK turi palaikyti įprastus kalendorius o kalendorių palaikymas neturi pasunkinti API naudojimo o nedviprasmiškas API
  49. 49. Regioninės kalendorių sistemos • Dažniausiai naudojami ne ISO kalendoriai o Islamo, Japonų, Kinų, Budizmo ir kiti • Pasiekiami pagal pavadinimą • Pasiekiami pagal BCP-47 lokalės išplėtimą o th-TH-u-ca-buddhist • Datos – era, metai, mėnuo, diena o mėnesių ilgiai & tvarka skiriasi • Leidžiamos tik datos variacijos o ignoruojami kalendoriai pradedantys dieną skirtingu metu (saulėtekis/saulėlydis)
  50. 50. Kalendorių chronologijos • Chronology apibrėžia kalendoriaus sistemą o factory’is kurti datoms • ChronoLocalDate • ChronoLocalDateTime • ChronoZonedDateTime o laikas yra standartinis LocalTime
  51. 51. Here be dragons! • Dirbti su kitais kalendoriais sudėtinga • Daug ISO prielaidų negalioja • Lengva suklysti • Būtina daryti kodo peržiūras! • Taigi...
  52. 52. Here be dragons! • Naudokite ISO, ne Chrono klases • See ChronoLocalDate Javadoc paaiškinimą • Nesaugokite kalendoriaus visoje sistemoje • Kalendorius naudotojo profilio dalis • Konvertuokite atvaizduodami UI
  53. 53. Kas liko
  54. 54. Elementų kombinavimas • Lengva apjungti datos ir laiko objektus • Naudojant ‘at’ • taip vadinamas Fluent API LocalDate date = Year.of(2013).atMonth(MARCH).atDay(27); LocalDateTime dt = date.atTime(12, 30); OffsetDateTime odt = dt.atOffset(ZoneOffset.ofHours(2)); ZoneId london = ZoneId.of("Europe/London"); ZonedDateTime zdt1 = date.atStartOfDay(london); ZonedDateTime zdt2 = Instant.now().atZone(london);
  55. 55. Periodai - Periods • Datos pagrindo laiko “kiekis” pasiekiamas žmogiškais laukais o 6 metai, 2 mėnesiai ir 12 dienų • Panaudojimo pvz.: o konferencijos ilgis – 5 dienos o nėštumas – 9 mėnesiai • Java klasė - Period o laukeliai metams, mėnesiams, dienoms • galima atimti/pridėti prie datos/laiko • Duration klasė - laiko ekvivalentas
  56. 56. Dabartinis laikas - Current time • Priklauso nuo laiko zonos o dažnai tai pamirštame • Reikalavimai o sustabdyti laiką testuose o pakeisti laiką į praeitį/ateitį o pristabdyti/paspartinti
  57. 57. Dabartinis laikas - Current time • Pasiekti esamą laiką naudojant objektą o vengti Singleton o Inversion of Control • Galima implementuoti subklasę o taigi - kontroliuoti laiką :) // system millis, default time zone Instant instant = Instant.now(Clock.system()); LocalDate date = LocalDate.now(Clock.system()); // system millis, specified time zone ZoneId zone = ZoneId.of("Europe/Moscow"); LocalDate date = LocalDate.now(Clock.system(zone));
  58. 58. Dabartinis laikas - Current time • Palaiko Inversion of Control o inject Clock o galima turėti 'stop time' subklasę testavimui public class MyForm { @Inject private Clock clock; // inject with Spring/Guice public void validate(LocalDate date) { if (date.isBefore(LocalDate.now(clock))) { // error } } }
  59. 59. Formatting and Parsing • toString() grąžina ISO-8601 • Formatavimas/parsinimas palaiko šablonus o kaip kad SimpleDateFormat o taip pat sudėtingesnius formatus • pagrindinė formatavimo klasė - DateTimeFormatter • Pateikia daug įprastų formaterių
  60. 60. Amount between • Lengva suskaičiuoti laikotarpį tarp dviejų datų/laikų • Pagal vienetus • Arba visą periodą/trukmę (Period/Duration) LocalDate date1 = LocalDate.of(2012, 3, 4); LocalDate date2 = LocalDate.of(2013, 1, 26); // Duration long days = DAYS.between(date1, date2); // Period Period period = Period.between(date1, date2);
  61. 61. Plėtimo galimybės • Plečiama 5 būdais, parašant savo o datos/laiko klasę o kiekio (amount) klasę o datos/laiko laukelius o datos/laiko vienetus o kalendorių • Nepamiršti apie Javadoc kontraktus!
  62. 62. Summary • JSR-310 naujas JDK8 Date/Time API • Išbandykite JDK 8 buildą arba JDK 7 backportą • http://threeten.github.com

×