src/java.base/share/classes/java/time/format/DateTimeFormatter.java
changeset 55446 1aae575eb1ef
parent 54206 003cc64366da
equal deleted inserted replaced
55445:a7b9d6d4940e 55446:1aae575eb1ef
   394  * second, with a colon, such as '+01:30:15'. Six or more letters throws
   394  * second, with a colon, such as '+01:30:15'. Six or more letters throws
   395  * {@code IllegalArgumentException}. Pattern letter 'X' (upper case) will output
   395  * {@code IllegalArgumentException}. Pattern letter 'X' (upper case) will output
   396  * 'Z' when the offset to be output would be zero, whereas pattern letter 'x'
   396  * 'Z' when the offset to be output would be zero, whereas pattern letter 'x'
   397  * (lower case) will output '+00', '+0000', or '+00:00'.
   397  * (lower case) will output '+00', '+0000', or '+00:00'.
   398  * <p>
   398  * <p>
   399  * <b>Offset O</b>: This formats the localized offset based on the number of
   399  * <b>Offset O</b>: With a non-zero offset, this formats the localized offset
   400  * pattern letters. One letter outputs the {@linkplain TextStyle#SHORT short}
   400  * based on the number of pattern letters. One letter outputs the
   401  * form of the localized offset, which is localized offset text, such as 'GMT',
   401  * {@linkplain TextStyle#SHORT short} form of the localized offset, which is
   402  * with hour without leading zero, optional 2-digit minute and second if
   402  * localized offset text, such as 'GMT', with hour without leading zero, optional
   403  * non-zero, and colon, for example 'GMT+8'. Four letters outputs the
   403  * 2-digit minute and second if non-zero, and colon, for example 'GMT+8'. Four
   404  * {@linkplain TextStyle#FULL full} form, which is localized offset text,
   404  * letters outputs the {@linkplain TextStyle#FULL full} form, which is localized
   405  * such as 'GMT, with 2-digit hour and minute field, optional second field
   405  * offset text, such as 'GMT, with 2-digit hour and minute field, optional second
   406  * if non-zero, and colon, for example 'GMT+08:00'. Any other count of letters
   406  * field if non-zero, and colon, for example 'GMT+08:00'. If the offset is zero,
   407  * throws {@code IllegalArgumentException}.
   407  * only localized text is output. Any other count of letters throws
       
   408  * {@code IllegalArgumentException}.
   408  * <p>
   409  * <p>
   409  * <b>Offset Z</b>: This formats the offset based on the number of pattern
   410  * <b>Offset Z</b>: This formats the offset based on the number of pattern
   410  * letters. One, two or three letters outputs the hour and minute, without a
   411  * letters. One, two or three letters outputs the hour and minute, without a
   411  * colon, such as '+0130'. The output will be '+0000' when the offset is zero.
   412  * colon, such as '+0130'. The output will be '+0000' when the offset is zero.
   412  * Four letters outputs the {@linkplain TextStyle#FULL full} form of localized
   413  * Four letters outputs the {@linkplain TextStyle#FULL full} form of localized