ICU-9250 (J) Document that date format S+ fields truncate for S,SS and zero-pad for...

X-SVN-Rev: 32647

diff --git a/icu4j/main/classes/core/src/com/ibm/icu/text/DateFormat.java b/icu4j/main/classes/core/src/com/ibm/icu/text/DateFormat.java
index e7d4c246628d8695f170153b287fcc91d5c01cee..b7a6d66b8ba5ec211f82338232e49209ff34b9ff 100644 (file)
--- a/icu4j/main/classes/core/src/com/ibm/icu/text/DateFormat.java
+++ b/icu4j/main/classes/core/src/com/ibm/icu/text/DateFormat.java
@@ -218,6 +218,14 @@ public abstract class DateFormat extends UFormat {
     /**
      * {@icu} FieldPosition selector for 'S' field alignment,
      * corresponding to the {@link Calendar#MILLISECOND} field.
+     *
+     * Note: Time formats that use 'S' can display a maximum of three
+     * significant digits for fractional seconds, corresponding to millisecond
+     * resolution and a fractional seconds sub-pattern of SSS. If the
+     * sub-pattern is S or SS, the fractional seconds value will be truncated
+     * (not rounded) to the number of display places specified. If the
+     * fractional seconds sub-pattern is longer than SSS, the additional
+     * display places will be filled with zeros.
      * @stable ICU 3.0
      */
     public final static int FRACTIONAL_SECOND_FIELD = 8;

diff --git a/icu4j/main/classes/core/src/com/ibm/icu/text/SimpleDateFormat.java b/icu4j/main/classes/core/src/com/ibm/icu/text/SimpleDateFormat.java
index fb28129bc0adb289b64d3189dd9e24e670e0389a..0a8de3a83666975ad69ecd6a9ca8f22ec44ae7f6 100644 (file)
--- a/icu4j/main/classes/core/src/com/ibm/icu/text/SimpleDateFormat.java
+++ b/icu4j/main/classes/core/src/com/ibm/icu/text/SimpleDateFormat.java
@@ -81,6 +81,7 @@ import com.ibm.icu.util.ULocale.Category;
  * m        minute in hour          (Number)            30
  * s        second in minute        (Number)            55
  * S        fractional second       (Number)            978
+ *          (maximum resolution of SSS; truncated if shorter, zero-padded if longer)
  * E        day of week             (Text)              Tuesday
  * e*       day of week (local 1~7) (Text & Number)     Tuesday & 2
  * D        day in year             (Number)            189