ReviewRequest 8011172: JJSR 310: DateTime API Updates II, (original) (raw)

Xueming Shen xueming.shen at oracle.com
Mon Apr 8 19:51:50 UTC 2013

Hi,

JSR 310 has continued to refine and update the java.time API. Please help review the proposed changeset as showed in webrev:

In addition to general javadoc improvements, the changes include:

java.time

Duration - added a static from(temporalAmount) method to simplify conversions from other amounts
Renamed the toString(Formatter) method to format(Formatter) in all classes
Period - added a static from(temporalAmount) method to simplify conversions
ZoneId -
- Added getAvailableZoneIds method, a simpler mechanism than going to the provider
- Added normalized() method to ease conversion to a fixed offset
- renamed predefined static fields of timezone names

java.time.chrono

ChronoLocalDate, ChronoLocalDateTime, ChonoZonedDateTime
- changed xxx_COMPARATORs to static methods returning the Time Line Order comparators
- Added a from(TemporalAcessor) method to ease conversions
Chronology
- Added method to create a Date from EpochDay (And in each calendar subclass)
- Added resolveDate to allow resolving date components by the Chronology
- Serialization fixes
- Replaced raw return types with wildcard type
Era
- Removed factory methods and getChronology - they did not work correctly in all cases
- Declared Era as a functional interface
Hijrah calendar variations -
- Supporting the Umm alQura calendar
Added HijrahEra, IsoEra, JapaneseEra, MinguEra, ThaiBuddhistEra making the enums public
MinguoDate, ThaiBuddhistDate, HijrahDate - Added getEra method to return the concrete Era type.

java.time.format

DateTimeFormatter -
- Added fields for the predefined formatters (moved from DateTimeFormatters class)
- Updated patterns to be CLDR compatible
- Moved documentation for the pattern letters to the class javadoc
- Added support for Zone default and conversion
DateTimeFormatterBuilder
- Updated documentation of patterns and corresponding equivalents to builder methods.
- Added a method to append the localized offset.

java.time.temporal

Adjusters - class removed; all static adjusters moved to static methods in TemporalAdjuster
ChronoField -
- Renamed EPOCH_MONTH to PROLEPTIC_MONTH
- Added getDisplayName - for locale specific field name
Queries - class removed; all static query method moved to static methods in TemporalQuery
TemporalField - added getDisplayName method
UnsupportedTemporalTypeException - new subtype of DateTimeException to reflect no support for a unit or field
WeekFields - Added fields for week and year of week-Based-Years to match CLDR fields "Y", "W"