src/java.base/share/classes/java/text/DateFormat.java

rev 47480 : [mq]: 8176841

@@ -95,10 +95,17 @@
  * <blockquote>
  * <pre>{@code
  * DateFormat df = DateFormat.getDateInstance(DateFormat.LONG, Locale.FRANCE);
  * }</pre>
  * </blockquote>
+ *
+ * <p>If the specified locale contains "ca" (calendar), "rg" (region override),
+ * and/or "tz" (timezone) <a href="../util/Locale.html#def_locale_extension">Unicode
+ * extensions</a>, the calendar, the country and/or the time zone for formatting
+ * are overriden. If both "ca" and "rg" are specified, the calendar from "ca"
+ * extension supersedes the implicit one from "rg" extension.
+ *
  * <p>You can use a DateFormat to parse also.
  * <blockquote>
  * <pre>{@code
  * myDate = df.parse(myString);
  * }</pre>