< prev index next >

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

Print this page

        

@@ -1136,13 +1136,16 @@
      * 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.
+     * 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, time to at least the seconds field is required.
+     * 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
< prev index next >