Calarify SimpleDateFormat symbols X documentation.
Added clarification that "Z" in "ISO 8601 Time zone" paragraph refers to the
letter Z in parsed string not the "Z" symbol.
Added clarification that pattern of letters for "ISO 8601 Time zone" is X.
Test: make docs
Bug: 70206473
Change-Id: Id4245e33b56bbbce2551e90da3bfbba609d861b7
diff --git a/ojluni/src/main/java/java/text/SimpleDateFormat.java b/ojluni/src/main/java/java/text/SimpleDateFormat.java
index 559349d..d8e2d90a 100644
--- a/ojluni/src/main/java/java/text/SimpleDateFormat.java
+++ b/ojluni/src/main/java/java/text/SimpleDateFormat.java
@@ -68,6 +68,7 @@
import static java.text.DateFormatSymbols.*;
// Android-changed: Added supported API level, removed unnecessary <br>
+// Android-changed: Clarified info about X symbol time zone parsing
/**
* <code>SimpleDateFormat</code> is a concrete class for formatting and
* parsing dates in a locale-sensitive manner. It allows for formatting
@@ -363,10 +364,10 @@
* is ignored. For example, if the pattern is {@code "X"} and the time zone is
* {@code "GMT+05:30"}, {@code "+05"} is produced.
*
- * <p>For parsing, {@code "Z"} is parsed as the UTC time zone designator.
+ * <p>For parsing, the letter {@code "Z"} is parsed as the UTC time zone designator (therefore
+ * {@code "09:30Z"} is parsed as {@code "09:30 UTC"}.
* <a href="#timezone">General time zones</a> are <em>not</em> accepted.
- *
- * <p>If the number of pattern letters is 4 or more, {@link
+ * <p>If the number of {@code "X"} pattern letters is 4 or more (e.g. {@code XXXX}), {@link
* IllegalArgumentException} is thrown when constructing a {@code
* SimpleDateFormat} or {@linkplain #applyPattern(String) applying a
* pattern}.