jdk-sandbox: comparison src/java.base/share/classes/java/text/DateFormat.java

equal deleted inserted replaced

-:a7f16447085e
+:48e480e56aad
 /**
 * {@code DateFormat} is an abstract class for date/time formatting subclasses which
 * formats and parses dates or time in a language-independent manner.
 * The date/time formatting subclass, such as {@link SimpleDateFormat}, allows for
 * formatting (i.e., date &rarr; text), parsing (text &rarr; date), and
-* normalization.  The date is represented as a <code>Date</code> object or
+* normalization.  The date is represented as a {@code Date} object or
 * as the milliseconds since January 1, 1970, 00:00:00 GMT.
 *
 * <p>{@code DateFormat} provides many class methods for obtaining default date/time
 * formatters based on the default or a given locale and a number of formatting
 * styles. The formatting styles include {@link #FULL}, {@link #LONG}, {@link #MEDIUM}, and {@link #SHORT}. More
 * and the instant of time. This field is used for both formatting and
 * parsing.
 *
 * <p>Subclasses should initialize this field to a {@link Calendar}
 * appropriate for the {@link Locale} associated with this
-* <code>DateFormat</code>.
+* {@code DateFormat}.
 * @serial
 */
 protected Calendar calendar;
 /**
-* The number formatter that <code>DateFormat</code> uses to format numbers
+* The number formatter that {@code DateFormat} uses to format numbers
 * in dates and times.  Subclasses should initialize this to a number format
-* appropriate for the locale associated with this <code>DateFormat</code>.
+* appropriate for the locale associated with this {@code DateFormat}.
 * @serial
 */
 protected NumberFormat numberFormat;
 /**
 * The method may not use the entire text of the given string.
 * <p>
 * See the {@link #parse(String, ParsePosition)} method for more information
 * on date parsing.
 *
-* @param source A <code>String</code> whose beginning should be parsed.
+* @param source A {@code String} whose beginning should be parsed.
-* @return A <code>Date</code> parsed from the string.
+* @return A {@code Date} parsed from the string.
 * @throws    ParseException if the beginning of the specified string
 *            cannot be parsed.
 */
 public Date parse(String source) throws ParseException
 {
 * @return      A {@code Date}, or {@code null} if the input could not be parsed
 */
 public abstract Date parse(String source, ParsePosition pos);
 /**
-* Parses text from a string to produce a <code>Date</code>.
+* Parses text from a string to produce a {@code Date}.
 * <p>
 * The method attempts to parse text starting at the index given by
-* <code>pos</code>.
+* {@code pos}.
-* If parsing succeeds, then the index of <code>pos</code> is updated
+* If parsing succeeds, then the index of {@code pos} is updated
 * to the index after the last character used (parsing does not necessarily
 * use all characters up to the end of the string), and the parsed
-* date is returned. The updated <code>pos</code> can be used to
+* date is returned. The updated {@code pos} can be used to
 * indicate the starting point for the next call to this method.
-* If an error occurs, then the index of <code>pos</code> is not
+* If an error occurs, then the index of {@code pos} is not
-* changed, the error index of <code>pos</code> is set to the index of
+* changed, the error index of {@code pos} is set to the index of
 * the character where the error occurred, and null is returned.
 * <p>
 * See the {@link #parse(String, ParsePosition)} method for more information
 * on date parsing.
 *
-* @param source A <code>String</code>, part of which should be parsed.
+* @param source A {@code String}, part of which should be parsed.
-* @param pos A <code>ParsePosition</code> object with index and error
+* @param pos A {@code ParsePosition} object with index and error
 *            index information as described above.
-* @return A <code>Date</code> parsed from the string. In case of
+* @return A {@code Date} parsed from the string. In case of
 *         error, returns null.
 * @throws NullPointerException if {@code source} or {@code pos} is null.
 */
 public Object parseObject(String source, ParsePosition pos) {
 return parse(source, pos);
 return getDateTimeInstance(SHORT, SHORT);
 }
 /**
 * Returns an array of all locales for which the
-* <code>get*Instance</code> methods of this class can return
+* {@code get*Instance} methods of this class can return
 * localized instances.
 * The returned array represents the union of locales supported by the Java
 * runtime and by installed
 * {@link java.text.spi.DateFormatProvider DateFormatProvider} implementations.
-* It must contain at least a <code>Locale</code> instance equal to
+* It must contain at least a {@code Locale} instance equal to
 * {@link java.util.Locale#US Locale.US}.
 *
 * @return An array of locales for which localized
-*         <code>DateFormat</code> instances are available.
+*         {@code DateFormat} instances are available.
 */
 public static Locale[] getAvailableLocales()
 {
 LocaleServiceProviderPool pool =
 LocaleServiceProviderPool.getPool(DateFormatProvider.class);
 */
 protected DateFormat() {}
 /**
 * Defines constants that are used as attribute keys in the
-* <code>AttributedCharacterIterator</code> returned
+* {@code AttributedCharacterIterator} returned
-* from <code>DateFormat.formatToCharacterIterator</code> and as
+* from {@code DateFormat.formatToCharacterIterator} and as
-* field identifiers in <code>FieldPosition</code>.
+* field identifiers in {@code FieldPosition}.
 * <p>
 * The class also provides two methods to map
 * between its constants and the corresponding Calendar constants.
 *
 * @since 1.4
 /** Calendar field. */
 private int calendarField;
 /**
-* Returns the <code>Field</code> constant that corresponds to
+* Returns the {@code Field} constant that corresponds to
-* the <code>Calendar</code> constant <code>calendarField</code>.
+* the {@code Calendar} constant {@code calendarField}.
-* If there is no direct mapping between the <code>Calendar</code>
+* If there is no direct mapping between the {@code Calendar}
-* constant and a <code>Field</code>, null is returned.
+* constant and a {@code Field}, null is returned.
 *
-* @throws IllegalArgumentException if <code>calendarField</code> is
+* @throws IllegalArgumentException if {@code calendarField} is
-*         not the value of a <code>Calendar</code> field constant.
+*         not the value of a {@code Calendar} field constant.
 * @param calendarField Calendar field constant
 * @return Field instance representing calendarField.
 * @see java.util.Calendar
 */
 public static Field ofCalendarField(int calendarField) {
 }
 return calendarToFieldMapping[calendarField];
 }
 /**
-* Creates a <code>Field</code>.
+* Creates a {@code Field}.
 *
-* @param name the name of the <code>Field</code>
+* @param name the name of the {@code Field}
-* @param calendarField the <code>Calendar</code> constant this
+* @param calendarField the {@code Calendar} constant this
-*        <code>Field</code> corresponds to; any value, even one
+*        {@code Field} corresponds to; any value, even one
-*        outside the range of legal <code>Calendar</code> values may
+*        outside the range of legal {@code Calendar} values may
-*        be used, but <code>-1</code> should be used for values
+*        be used, but {@code -1} should be used for values
-*        that don't correspond to legal <code>Calendar</code> values
+*        that don't correspond to legal {@code Calendar} values
 */
 protected Field(String name, int calendarField) {
 super(name);
 this.calendarField = calendarField;
 if (this.getClass() == DateFormat.Field.class) {
 }
 }
 }
 /**
-* Returns the <code>Calendar</code> field associated with this
+* Returns the {@code Calendar} field associated with this
 * attribute. For example, if this represents the hours field of
-* a <code>Calendar</code>, this would return
+* a {@code Calendar}, this would return
-* <code>Calendar.HOUR</code>. If there is no corresponding
+* {@code Calendar.HOUR}. If there is no corresponding
-* <code>Calendar</code> constant, this will return -1.
+* {@code Calendar} constant, this will return -1.
 *
 * @return Calendar constant for this field
 * @see java.util.Calendar
 */
 public int getCalendarField() {

changeset 58288	48e480e56aad
parent 58242	94bb65cb37d3
child 58679	9c3209ff7550