How to handle full period in java.time?

by

In Java SE 8, it is the responsibility of the application to create a class linking Period and Duration if that is needed.

Note that a Duration contains an amount of seconds, not separate amounts of seconds, minutes and hours. The amount of seconds can exceed 24 hours, thus a Duration can represent a “day”. But it is a fixed 24 hours day. By contrast, the representation of a “day in Period is descriptive and takes into account DST. The state of a Period is formed from three separate fields – days, months and years.

Bear in mind that “The customer occupied the hotel room for 2 days and seventeen and a half hours, P2DT17H30M” has the possibility to be complicated by DST cutovers. Using Period and Duration separately things are clear – Period is affected by DST cutovers and Duration is not.

In design terms, the original java.time Period did include hours, minutes and seconds. However, this resulted in the need for many methods and complicated Javadoc to describe all the possibilities around normalization and DST. By separating the concepts, the interaction of each with the timeline is a lot clearer. Note that the two classes also relate to the SQL design (“year to month” and “day to second” concepts).

There are no current plans to add a new class for Java SE 9in this area, however it cannot be completely ruled out because XML/ISO-8601 allows a single combined representation.

More Related Contents:

  1. Convert java.util.Date to java.time.LocalDate
  2. Converting between java.time.LocalDateTime and java.util.Date
  3. JSON Java 8 LocalDateTime format in Spring Boot
  4. Convert java.util.Date to what “java.time” type?
  5. Calculate days between two Dates in Java 8
  6. Convert java.time.LocalDate into java.util.Date type
  7. Period to string [duplicate]
  8. How to get milliseconds from LocalDateTime in Java 8
  9. cannot resolve symbol ‘java.time.LocalDate’ error in android studio
  10. JDK dateformatter parsing DayOfWeek in German locale, java8 vs java9
  11. How can I create a Java 8 LocalDate from a long Epoch time in Milliseconds?
  12. How to check if a date Object equals yesterday?
  13. How can I mock java.time.LocalDate.now()
  14. Why does the new Java 8 Date Time API not have nanosecond precision? [duplicate]
  15. Can’t parse String to LocalDate (Java 8)
  16. DateTimeFormatter month pattern letter “L” fails
  17. Writing and testing convenience methods using Java 8 Date/Time classes
  18. Why can’t I get a duration in minutes or hours in java.time?
  19. Unable to obtain OffsetDateTime from TemporalAccessor
  20. LocalDate to java.util.Date and vice versa simplest conversion? [duplicate]
  21. How to convert LocalDate to SQL Date Java?
  22. String to ZonedDateTime is changing format
  23. Format a date using the new date time API
  24. DateTimeFormatter Support for Single Digit Day of Month and Month of Year
  25. Get first and last day of month using threeten, LocalDate
  26. How to get last month/year in java?
  27. Force 4-digit-year in localized strings generated from `DateTimeFormatter.ofLocalized…` in java.time
  28. Create Java DateTime Instant from microseconds
  29. Jackson Serialize Instant to Nanosecond Issue
  30. What’s the difference between ZonedDateTime and OffsetDateTime?

Leave a Comment