Hi, JSR 310 has continued to refine and update the java.time API. Please help review the proposed changeset as showed in webrev:
http://cr.openjdk.java.net/~sherman/8011172/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"
