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

equal deleted inserted replaced

-:69648476a89e
+:a64012cb49d6
 /*
-* Copyright (c) 1996, 2012, Oracle and/or its affiliates. All rights reserved.
+* Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 /**
 * {@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 -> text), parsing (text -> date), and
+* formatting (i.e., date &rarr; text), parsing (text &rarr; date), and
 * normalization.  The date is represented as a <code>Date</code> 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
 * Your code can be completely independent of the locale conventions for
 * months, days of the week, or even the calendar format: lunar vs. solar.
 *
 * <p>To format a date for the current Locale, use one of the
 * static factory methods:
-* <pre>
+* <blockquote>
-*  myString = DateFormat.getDateInstance().format(myDate);
+* <pre>{@code
-* </pre>
+* myString = DateFormat.getDateInstance().format(myDate);
+* }</pre>
+* </blockquote>
 * <p>If you are formatting multiple dates, it is
 * more efficient to get the format and use it multiple times so that
 * the system doesn't have to fetch the information about the local
 * language and country conventions multiple times.
-* <pre>
+* <blockquote>
-*  DateFormat df = DateFormat.getDateInstance();
+* <pre>{@code
-*  for (int i = 0; i < myDate.length; ++i) {
+* DateFormat df = DateFormat.getDateInstance();
-*    output.println(df.format(myDate[i]) + "; ");
+* for (int i = 0; i < myDate.length; ++i) {
-*  }
+*     output.println(df.format(myDate[i]) + "; ");
-* </pre>
+* }
+* }</pre>
+* </blockquote>
 * <p>To format a date for a different Locale, specify it in the
 * call to {@link #getDateInstance(int, Locale) getDateInstance()}.
-* <pre>
+* <blockquote>
-*  DateFormat df = DateFormat.getDateInstance(DateFormat.LONG, Locale.FRANCE);
+* <pre>{@code
-* </pre>
+* DateFormat df = DateFormat.getDateInstance(DateFormat.LONG, Locale.FRANCE);
+* }</pre>
+* </blockquote>
 * <p>You can use a DateFormat to parse also.
-* <pre>
+* <blockquote>
-*  myDate = df.parse(myString);
+* <pre>{@code
-* </pre>
+* myDate = df.parse(myString);
+* }</pre>
+* </blockquote>
 * <p>Use {@code getDateInstance} to get the normal date format for that country.
 * There are other static factory methods available.
 * Use {@code getTimeInstance} to get the time format for that country.
 * Use {@code getDateTimeInstance} to get a date and time format. You can pass in
 * different options to these factory methods to control the length of the
 * <ul><li>progressively parse through pieces of a string.
 * <li>align any particular field, or find out where it is for selection
 * on the screen.
 * </ul>
 *
-* <h4><a name="synchronization">Synchronization</a></h4>
+* <h3><a name="synchronization">Synchronization</a></h3>
 *
 * <p>
 * Date formats are not synchronized.
 * It is recommended to create separate format instances for each thread.
 * If multiple threads access a format concurrently, it must be synchronized
 }
 /**
 * Get a default date/time formatter that uses the SHORT style for both the
 * date and the time.
+*
+* @return a date/time formatter
 */
 public final static DateFormat getInstance() {
 return getDateTimeInstance(SHORT, SHORT);
 }
 }
 /**
 * Sets the time zone for the calendar of this {@code DateFormat} object.
 * This method is equivalent to the following call.
-* <blockquote><pre>
+* <blockquote><pre>{@code
-*  getCalendar().setTimeZone(zone)
+* getCalendar().setTimeZone(zone)
-* </pre></blockquote>
+* }</pre></blockquote>
 *
 * <p>The {@code TimeZone} set by this method is overwritten by a
 * {@link #setCalendar(java.util.Calendar) setCalendar} call.
 *
 * <p>The {@code TimeZone} set by this method may be overwritten as
 }
 /**
 * Gets the time zone.
 * This method is equivalent to the following call.
-* <blockquote><pre>
+* <blockquote><pre>{@code
-*  getCalendar().getTimeZone()
+* getCalendar().getTimeZone()
-* </pre></blockquote>
+* }</pre></blockquote>
 *
 * @return the time zone associated with the calendar of DateFormat.
 */
 public TimeZone getTimeZone()
 {
 * lenient parsing, the parser may use heuristics to interpret inputs that
 * do not precisely match this object's format.  With strict parsing,
 * inputs must match this object's format.
 *
 * <p>This method is equivalent to the following call.
-* <blockquote><pre>
+* <blockquote><pre>{@code
-*  getCalendar().setLenient(lenient)
+* getCalendar().setLenient(lenient)
-* </pre></blockquote>
+* }</pre></blockquote>
 *
 * <p>This leniency value is overwritten by a call to {@link
 * #setCalendar(java.util.Calendar) setCalendar()}.
 *
 * @param lenient when {@code true}, parsing is lenient
 }
 /**
 * Tell whether date/time parsing is to be lenient.
 * This method is equivalent to the following call.
-* <blockquote><pre>
+* <blockquote><pre>{@code
-*  getCalendar().isLenient()
+* getCalendar().isLenient()
-* </pre></blockquote>
+* }</pre></blockquote>
 *
 * @return {@code true} if the {@link #calendar} is lenient;
 *         {@code false} otherwise.
 * @see java.util.Calendar#isLenient()
 */

changeset 19054	a64012cb49d6
parent 16010	2727163b5df5