src/java.base/share/classes/java/time/format/DateTimeFormatter.java

*** 1136,1148 ****
       * The ISO instant formatter that formats or parses an instant in UTC,
       * such as '2011-12-03T10:15:30Z'.
       * <p>
       * This returns an immutable formatter capable of formatting and parsing
       * the ISO-8601 instant format.
!      * When formatting, the second-of-minute is always output.
       * The nano-of-second outputs zero, three, six or nine digits as necessary.
!      * When parsing, time to at least the seconds field is required.
       * Fractional seconds from zero to nine are parsed.
       * The localized decimal style is not used.
       * <p>
       * This is a special case formatter intended to allow a human readable form
       * of an {@link java.time.Instant}. The {@code Instant} class is designed to
--- 1136,1151 ----
       * The ISO instant formatter that formats or parses an instant in UTC,
       * such as '2011-12-03T10:15:30Z'.
       * <p>
       * This returns an immutable formatter capable of formatting and parsing
       * the ISO-8601 instant format.
!      * When formatting, the instant will always be suffixed by 'Z' to indicate UTC.
!      * The second-of-minute is always output.
       * The nano-of-second outputs zero, three, six or nine digits as necessary.
!      * When parsing, the behaviour of {@code appendOffsetId()} will be used to
!      * parse the offset, converting the instant to UTC as necessary.
!      * The time to at least the seconds field is required.
       * Fractional seconds from zero to nine are parsed.
       * The localized decimal style is not used.
       * <p>
       * This is a special case formatter intended to allow a human readable form
       * of an {@link java.time.Instant}. The {@code Instant} class is designed to