--- old/src/java.xml/share/classes/javax/xml/datatype/XMLGregorianCalendar.java 2015-04-21 18:33:55.508094845 +0400 +++ new/src/java.xml/share/classes/javax/xml/datatype/XMLGregorianCalendar.java 2015-04-21 18:33:55.416094845 +0400 @@ -43,17 +43,17 @@ * {@link DatatypeConstants#GMONTH}, and * {@link DatatypeConstants#GDAY} * defined in the XML Namespace - * "http://www.w3.org/2001/XMLSchema". + * {@code "http://www.w3.org/2001/XMLSchema"}. * These datatypes are normatively defined in - * W3C XML Schema 1.0 Part 2, Section 3.2.7-14.

+ * W3C XML Schema 1.0 Part 2, Section 3.2.7-14. * *

The table below defines the mapping between XML Schema 1.0 * date/time datatype fields and this class' fields. It also summarizes * the value constraints for the date and time fields defined in * W3C XML Schema 1.0 Part 2, Appendix D, - * ISO 8601 Date and Time Formats.

+ * ISO 8601 Date and Time Formats. * - * + * * * * @@ -64,22 +64,22 @@ * * * - * - * + * * * * - * - * + * - * * * - * + * * * * * - * + * * - * * * - * + * * * * * - * + * * * * * - * + * * * * * - * + * * *
XML Schema 1.0
- * datatype
+ * 		XML Schema 1.0
+ * datatype
* field		Related
XMLGregorianCalendar
Accessor(s)		Related
XMLGregorianCalendar
Accessor(s)		Value Range
year {@link #getYear()} + {@link #getEon()} or
+ * 		year {@link #getYear()} + {@link #getEon()} or
* {@link #getEonAndYear} * 		getYear() is a value between -(10^9-1) to (10^9)-1 - * or {@link DatatypeConstants#FIELD_UNDEFINED}.
- * {@link #getEon()} is high order year value in billion of years.
- * getEon() has values greater than or equal to (10^9) or less than or equal to -(10^9). - * A value of null indicates field is undefined.
+ * 		{@code getYear()} is a value between -(10^9-1) to (10^9)-1 + * or {@link DatatypeConstants#FIELD_UNDEFINED}.
+ * {@link #getEon()} is high order year value in billion of years.
+ * {@code getEon()} has values greater than or equal to (10^9) or less than or equal to -(10^9). + * A value of null indicates field is undefined.
* Given that XML Schema 1.0 errata states that the year zero * will be a valid lexical value in a future version of XML Schema, * this class allows the year field to be set to zero. Otherwise, @@ -89,20 +89,20 @@ *
monthmonth {@link #getMonth()} 1 to 12 or {@link DatatypeConstants#FIELD_UNDEFINED}
dayday {@link #getDay()} Independent of month, max range is 1 to 31 or {@link DatatypeConstants#FIELD_UNDEFINED}.
+ * 		Independent of month, max range is 1 to 31 or {@link DatatypeConstants#FIELD_UNDEFINED}.
* The normative value constraint stated relative to month * field's value is in W3C XML Schema 1.0 Part 2, Appendix D. *
hourhour{@link #getHour()} * 0 to 23 or {@link DatatypeConstants#FIELD_UNDEFINED}. @@ -114,28 +114,28 @@ *
minuteminute {@link #getMinute()} 0 to 59 or {@link DatatypeConstants#FIELD_UNDEFINED}
secondsecond - * {@link #getSecond()} + {@link #getMillisecond()}/1000 or
+ * {@link #getSecond()} + {@link #getMillisecond()}/1000 or
* {@link #getSecond()} + {@link #getFractionalSecond()} * 		- * {@link #getSecond()} from 0 to 60 or {@link DatatypeConstants#FIELD_UNDEFINED}.
- * (Note: 60 only allowable for leap second.)
+ * {@link #getSecond()} from 0 to 60 or {@link DatatypeConstants#FIELD_UNDEFINED}.
+ * (Note: 60 only allowable for leap second.)
* {@link #getFractionalSecond()} allows for infinite precision over the range from 0.0 to 1.0 when - * the {@link #getSecond()} is defined.
- * FractionalSecond is optional and has a value of null when it is undefined.
+ * the {@link #getSecond()} is defined.
+ * {@code FractionalSecond} is optional and has a value of {@code null} when it is undefined.
* {@link #getMillisecond()} is the convenience * millisecond precision of value of {@link #getFractionalSecond()}. *
timezonetimezone {@link #getTimezone()} Number of minutes or {@link DatatypeConstants#FIELD_UNDEFINED}. * Value range from -14 hours (-14 * 60 minutes) to 14 hours (14 * 60 minutes). @@ -145,14 +145,13 @@ *
* *

All maximum value space constraints listed for the fields in the table - * above are checked by factory methods, @{link DatatypeFactory}, + * above are checked by factory methods, {@link DatatypeFactory}, * setter methods and parse methods of - * this class. IllegalArgumentException is thrown when a + * this class. {@code IllegalArgumentException} is thrown when a * parameter's value is outside the value constraint for the field or * if the composite * values constitute an invalid XMLGregorianCalendar instance (for example, if * the 31st of June is specified). - *

* *

The following operations are defined for this class: *

- *

* * @author Joseph Fialli * @author Kohsuke Kawaguchi @@ -187,26 +185,26 @@ * Default no-arg constructor. * *

Note: Always use the {@link DatatypeFactory} to - * construct an instance of XMLGregorianCalendar. + * construct an instance of {@code XMLGregorianCalendar}. * The constructor on this class cannot be guaranteed to * produce an object with a consistent state and may be - * removed in the future.

+ * removed in the future. */ public XMLGregorianCalendar() { } /** - *

Unset all fields to undefined.

+ * Unset all fields to undefined. * *

Set all int fields to {@link DatatypeConstants#FIELD_UNDEFINED} and reference fields - * to null.

+ * to null. */ public abstract void clear(); /** - *

Reset this XMLGregorianCalendar to its original values.

+ * Reset this {@code XMLGregorianCalendar} to its original values. * - *

XMLGregorianCalendar is reset to the same values as when it was created with + *

{@code XMLGregorianCalendar} is reset to the same values as when it was created with * {@link DatatypeFactory#newXMLGregorianCalendar()}, * {@link DatatypeFactory#newXMLGregorianCalendar(String lexicalRepresentation)}, * {@link DatatypeFactory#newXMLGregorianCalendar( @@ -250,83 +248,82 @@ * int seconds, * int milliseconds, * int timezone)}. - *

* - *

reset() is designed to allow the reuse of existing XMLGregorianCalendars - * thus saving resources associated with the creation of new XMLGregorianCalendars.

+ *

{@code reset()} is designed to allow the reuse of existing {@code XMLGregorianCalendar}s + * thus saving resources associated with the creation of new {@code XMLGregorianCalendar}s. */ public abstract void reset(); /** - *

Set low and high order component of XSD dateTime year field.

+ * Set low and high order component of XSD {@code dateTime} year field. * - *

Unset this field by invoking the setter with a parameter value of null.

+ *

Unset this field by invoking the setter with a parameter value of {@code null}. * * @param year value constraints summarized in year field of date/time field mapping table. * - * @throws IllegalArgumentException if year parameter is + * @throws IllegalArgumentException if {@code year} parameter is * outside value constraints for the field as specified in * date/time field mapping table. */ public abstract void setYear(BigInteger year); /** - *

Set year of XSD dateTime year field.

+ * Set year of XSD {@code dateTime} year field. * *

Unset this field by invoking the setter with a parameter value of - * {@link DatatypeConstants#FIELD_UNDEFINED}.

+ * {@link DatatypeConstants#FIELD_UNDEFINED}. * - *

Note: if the absolute value of the year parameter + *

Note: if the absolute value of the {@code year} parameter * is less than 10^9, the eon component of the XSD year field is set to - * null by this method.

+ * {@code null} by this method. * * @param year value constraints are summarized in year field of date/time field mapping table. - * If year is {@link DatatypeConstants#FIELD_UNDEFINED}, then eon is set to null. + * If year is {@link DatatypeConstants#FIELD_UNDEFINED}, then eon is set to {@code null}. */ public abstract void setYear(int year); /** - *

Set month.

+ * Set month. * - *

Unset this field by invoking the setter with a parameter value of {@link DatatypeConstants#FIELD_UNDEFINED}.

+ *

Unset this field by invoking the setter with a parameter value of {@link DatatypeConstants#FIELD_UNDEFINED}. * * @param month value constraints summarized in month field of date/time field mapping table. * - * @throws IllegalArgumentException if month parameter is + * @throws IllegalArgumentException if {@code month} parameter is * outside value constraints for the field as specified in * date/time field mapping table. */ public abstract void setMonth(int month); /** - *

Set days in month.

+ * Set days in month. * - *

Unset this field by invoking the setter with a parameter value of {@link DatatypeConstants#FIELD_UNDEFINED}.

+ *

Unset this field by invoking the setter with a parameter value of {@link DatatypeConstants#FIELD_UNDEFINED}. * * @param day value constraints summarized in day field of date/time field mapping table. * - * @throws IllegalArgumentException if day parameter is + * @throws IllegalArgumentException if {@code day} parameter is * outside value constraints for the field as specified in * date/time field mapping table. */ public abstract void setDay(int day); /** - *

Set the number of minutes in the timezone offset.

+ * Set the number of minutes in the timezone offset. * - *

Unset this field by invoking the setter with a parameter value of {@link DatatypeConstants#FIELD_UNDEFINED}.

+ *

Unset this field by invoking the setter with a parameter value of {@link DatatypeConstants#FIELD_UNDEFINED}. * * @param offset value constraints summarized in * timezone field of date/time field mapping table. * - * @throws IllegalArgumentException if offset parameter is + * @throws IllegalArgumentException if {@code offset} parameter is * outside value constraints for the field as specified in * date/time field mapping table. */ public abstract void setTimezone(int offset); /** - *

Set time as one unit.

+ * Set time as one unit. * * @param hour value constraints are summarized in * hour field of date/time field mapping table. @@ -352,71 +349,71 @@ } /** - *

Set hours.

+ * Set hours. * - *

Unset this field by invoking the setter with a parameter value of {@link DatatypeConstants#FIELD_UNDEFINED}.

+ *

Unset this field by invoking the setter with a parameter value of {@link DatatypeConstants#FIELD_UNDEFINED}. * * @param hour value constraints summarized in hour field of date/time field mapping table. * - * @throws IllegalArgumentException if hour parameter is outside value constraints for the field as specified in + * @throws IllegalArgumentException if {@code hour} parameter is outside value constraints for the field as specified in * date/time field mapping table. */ public abstract void setHour(int hour); /** - *

Set minutes.

+ * Set minutes. * - *

Unset this field by invoking the setter with a parameter value of {@link DatatypeConstants#FIELD_UNDEFINED}.

+ *

Unset this field by invoking the setter with a parameter value of {@link DatatypeConstants#FIELD_UNDEFINED}. * * @param minute value constraints summarized in minute field of date/time field mapping table. * - * @throws IllegalArgumentException if minute parameter is outside value constraints for the field as specified in + * @throws IllegalArgumentException if {@code minute} parameter is outside value constraints for the field as specified in * date/time field mapping table. */ public abstract void setMinute(int minute); /** - *

Set seconds.

+ * Set seconds. * - *

Unset this field by invoking the setter with a parameter value of {@link DatatypeConstants#FIELD_UNDEFINED}.

+ *

Unset this field by invoking the setter with a parameter value of {@link DatatypeConstants#FIELD_UNDEFINED}. * * @param second value constraints summarized in second field of date/time field mapping table. * - * @throws IllegalArgumentException if second parameter is outside value constraints for the field as specified in + * @throws IllegalArgumentException if {@code second} parameter is outside value constraints for the field as specified in * date/time field mapping table. */ public abstract void setSecond(int second); /** - *

Set milliseconds.

+ * Set milliseconds. * - *

Unset this field by invoking the setter with a parameter value of {@link DatatypeConstants#FIELD_UNDEFINED}.

+ *

Unset this field by invoking the setter with a parameter value of {@link DatatypeConstants#FIELD_UNDEFINED}. * * @param millisecond value constraints summarized in * second field of date/time field mapping table. * - * @throws IllegalArgumentException if millisecond parameter is outside value constraints for the field as specified + * @throws IllegalArgumentException if {@code millisecond} parameter is outside value constraints for the field as specified * in date/time field mapping table. */ public abstract void setMillisecond(int millisecond); /** - *

Set fractional seconds.

+ * Set fractional seconds. * - *

Unset this field by invoking the setter with a parameter value of null.

+ *

Unset this field by invoking the setter with a parameter value of {@code null}. * * @param fractional value constraints summarized in * second field of date/time field mapping table. * - * @throws IllegalArgumentException if fractional parameter is outside value constraints for the field as specified + * @throws IllegalArgumentException if {@code fractional} parameter is outside value constraints for the field as specified * in date/time field mapping table. */ public abstract void setFractionalSecond(BigDecimal fractional); /** - *

Set time as one unit, including the optional infinite precision - * fractional seconds.

+ * Set time as one unit, including the optional infinite precision + * fractional seconds. * * @param hour value constraints are summarized in * hour field of date/time field mapping table. @@ -424,7 +421,7 @@ * minute field of date/time field mapping table. * @param second value constraints are summarized in * second field of date/time field mapping table. - * @param fractional value of null indicates this optional + * @param fractional value of {@code null} indicates this optional * field is not set. * * @throws IllegalArgumentException if any parameter is @@ -445,7 +442,7 @@ /** - *

Set time as one unit, including optional milliseconds.

+ * Set time as one unit, including optional milliseconds. * * @param hour value constraints are summarized in * hour field of date/time field mapping table. @@ -469,13 +466,13 @@ } /** - *

Return high order component for XML Schema 1.0 dateTime datatype field for - * year. - * null if this optional part of the year field is not defined.

+ * Return high order component for XML Schema 1.0 dateTime datatype field for + * {@code year}. + * {@code null} if this optional part of the year field is not defined. * *

Value constraints for this value are summarized in - * year field of date/time field mapping table.

- * @return eon of this XMLGregorianCalendar. The value + * year field of date/time field mapping table. + * @return eon of this {@code XMLGregorianCalendar}. The value * returned is an integer multiple of 10^9. * * @see #getYear() @@ -484,13 +481,13 @@ public abstract BigInteger getEon(); /** - *

Return low order component for XML Schema 1.0 dateTime datatype field for - * year or {@link DatatypeConstants#FIELD_UNDEFINED}.

+ * Return low order component for XML Schema 1.0 dateTime datatype field for + * {@code year} or {@link DatatypeConstants#FIELD_UNDEFINED}. * *

Value constraints for this value are summarized in - * year field of date/time field mapping table.

+ * year field of date/time field mapping table. * - * @return year of this XMLGregorianCalendar. + * @return year of this {@code XMLGregorianCalendar}. * * @see #getEon() * @see #getEonAndYear() @@ -498,16 +495,16 @@ public abstract int getYear(); /** - *

Return XML Schema 1.0 dateTime datatype field for - * year.

+ * Return XML Schema 1.0 dateTime datatype field for + * {@code year}. * *

Value constraints for this value are summarized in - * year field of date/time field mapping table.

+ * year field of date/time field mapping table. * - * @return sum of eon and BigInteger.valueOf(year) - * when both fields are defined. When only year is defined, - * return it. When both eon and year are not - * defined, return null. + * @return sum of {@code eon} and {@code BigInteger.valueOf(year)} + * when both fields are defined. When only {@code year} is defined, + * return it. When both {@code eon} and {@code year} are not + * defined, return {@code null}. * * @see #getEon() * @see #getYear() @@ -515,21 +512,21 @@ public abstract BigInteger getEonAndYear(); /** - *

Return number of month or {@link DatatypeConstants#FIELD_UNDEFINED}.

+ * Return number of month or {@link DatatypeConstants#FIELD_UNDEFINED}. * *

Value constraints for this value are summarized in - * month field of date/time field mapping table.

+ * month field of date/time field mapping table. * - * @return year of this XMLGregorianCalendar. + * @return year of this {@code XMLGregorianCalendar}. * */ public abstract int getMonth(); /** - * Return day in month or {@link DatatypeConstants#FIELD_UNDEFINED}.

+ * Return day in month or {@link DatatypeConstants#FIELD_UNDEFINED}. * *

Value constraints for this value are summarized in - * day field of date/time field mapping table.

+ * day field of date/time field mapping table. * * @see #setDay(int) */ @@ -540,7 +537,7 @@ * {@link DatatypeConstants#FIELD_UNDEFINED} if this optional field is not defined. * *

Value constraints for this value are summarized in - * timezone field of date/time field mapping table.

+ * timezone field of date/time field mapping table. * * @see #setTimezone(int) */ @@ -551,34 +548,34 @@ * Returns {@link DatatypeConstants#FIELD_UNDEFINED} if this field is not defined. * *

Value constraints for this value are summarized in - * hour field of date/time field mapping table.

+ * hour field of date/time field mapping table. * @see #setTime(int, int, int) */ public abstract int getHour(); /** - * Return minutes or {@link DatatypeConstants#FIELD_UNDEFINED}.

+ * Return minutes or {@link DatatypeConstants#FIELD_UNDEFINED}. * Returns {@link DatatypeConstants#FIELD_UNDEFINED} if this field is not defined. * *

Value constraints for this value are summarized in - * minute field of date/time field mapping table.

+ * minute field of date/time field mapping table. * @see #setTime(int, int, int) */ public abstract int getMinute(); /** - *

Return seconds or {@link DatatypeConstants#FIELD_UNDEFINED}.

+ * Return seconds or {@link DatatypeConstants#FIELD_UNDEFINED}. * *

Returns {@link DatatypeConstants#FIELD_UNDEFINED} if this field is not defined. * When this field is not defined, the optional xs:dateTime * fractional seconds field, represented by * {@link #getFractionalSecond()} and {@link #getMillisecond()}, - * must not be defined.

+ * must not be defined. * *

Value constraints for this value are summarized in - * second field of date/time field mapping table.

+ * second field of date/time field mapping table. * - * @return Second of this XMLGregorianCalendar. + * @return Second of this {@code XMLGregorianCalendar}. * * @see #getFractionalSecond() * @see #getMillisecond() @@ -587,20 +584,20 @@ public abstract int getSecond(); /** - *

Return millisecond precision of {@link #getFractionalSecond()}.

+ * Return millisecond precision of {@link #getFractionalSecond()}. * *

This method represents a convenience accessor to infinite * precision fractional second value returned by * {@link #getFractionalSecond()}. The returned value is the rounded * down to milliseconds value of * {@link #getFractionalSecond()}. When {@link #getFractionalSecond()} - * returns null, this method must return - * {@link DatatypeConstants#FIELD_UNDEFINED}.

+ * returns {@code null}, this method must return + * {@link DatatypeConstants#FIELD_UNDEFINED}. * *

Value constraints for this value are summarized in - * second field of date/time field mapping table.

+ * second field of date/time field mapping table. * - * @return Millisecond of this XMLGregorianCalendar. + * @return Millisecond of this {@code XMLGregorianCalendar}. * * @see #getFractionalSecond() * @see #setTime(int, int, int) @@ -618,18 +615,18 @@ } /** - *

Return fractional seconds.

+ * Return fractional seconds. * - *

null is returned when this optional field is not defined.

+ *

{@code null} is returned when this optional field is not defined. * *

Value constraints are detailed in - * second field of date/time field mapping table.

+ * second field of date/time field mapping table. * *

This optional field can only have a defined value when the * xs:dateTime second field, represented by {@link #getSecond()}, - * does not return {@link DatatypeConstants#FIELD_UNDEFINED}.

+ * does not return {@link DatatypeConstants#FIELD_UNDEFINED}. * - * @return fractional seconds of this XMLGregorianCalendar. + * @return fractional seconds of this {@code XMLGregorianCalendar}. * * @see #getSecond() * @see #setTime(int, int, int, BigDecimal) @@ -638,51 +635,51 @@ // comparisons /** - *

Compare two instances of W3C XML Schema 1.0 date/time datatypes + * Compare two instances of W3C XML Schema 1.0 date/time datatypes * according to partial order relation defined in * W3C XML Schema 1.0 Part 2, Section 3.2.7.3, - * Order relation on dateTime.

+ * Order relation on dateTime. * - *

xsd:dateTime datatype field mapping to accessors of + *

{@code xsd:dateTime} datatype field mapping to accessors of * this class are defined in - * date/time field mapping table.

+ * date/time field mapping table. * - * @param xmlGregorianCalendar Instance of XMLGregorianCalendar to compare + * @param xmlGregorianCalendar Instance of {@code XMLGregorianCalendar} to compare * - * @return The relationship between this XMLGregorianCalendar and - * the specified xmlGregorianCalendar as + * @return The relationship between {@code this} {@code XMLGregorianCalendar} and + * the specified {@code xmlGregorianCalendar} as * {@link DatatypeConstants#LESSER}, * {@link DatatypeConstants#EQUAL}, * {@link DatatypeConstants#GREATER} or * {@link DatatypeConstants#INDETERMINATE}. * - * @throws NullPointerException if xmlGregorianCalendar is null. + * @throws NullPointerException if {@code xmlGregorianCalendar} is null. */ public abstract int compare(XMLGregorianCalendar xmlGregorianCalendar); /** - *

Normalize this instance to UTC.

+ * Normalize this instance to UTC. * - *

2000-03-04T23:00:00+03:00 normalizes to 2000-03-04T20:00:00Z

- *

Implements W3C XML Schema Part 2, Section 3.2.7.3 (A).

+ *

2000-03-04T23:00:00+03:00 normalizes to 2000-03-04T20:00:00Z + *

Implements W3C XML Schema Part 2, Section 3.2.7.3 (A). * - * @return this XMLGregorianCalendar normalized to UTC. + * @return {@code this} {@code XMLGregorianCalendar} normalized to UTC. */ public abstract XMLGregorianCalendar normalize(); /** - *

Compares this calendar to the specified object. The result is - * true if and only if the argument is not null and is an - * XMLGregorianCalendar object that represents the same - * instant in time as this object.

+ * Compares this calendar to the specified object. The result is + * {@code true} if and only if the argument is not null and is an + * {@code XMLGregorianCalendar} object that represents the same + * instant in time as this object. * * @param obj to compare. * - * @return true when obj is an instance of - * XMLGregorianCalendar and + * @return {@code true} when {@code obj} is an instance of + * {@code XMLGregorianCalendar} and * {@link #compare(XMLGregorianCalendar obj)} * returns {@link DatatypeConstants#EQUAL}, - * otherwise false. + * otherwise {@code false}. */ public boolean equals(Object obj) { @@ -693,7 +690,7 @@ } /** - *

Returns a hash code consistent with the definition of the equals method.

+ * Returns a hash code consistent with the definition of the equals method. * * @return hash code of this object. */ @@ -721,15 +718,15 @@ } /** - *

Return the lexical representation of this instance. + * Return the lexical representation of {@code this} instance. * The format is specified in * XML Schema 1.0 Part 2, Section 3.2.[7-14].1, - * Lexical Representation".

+ * Lexical Representation". * *

Specific target lexical representation format is determined by - * {@link #getXMLSchemaType()}.

+ * {@link #getXMLSchemaType()}. * - * @return XML, as String, representation of this XMLGregorianCalendar + * @return XML, as {@code String}, representation of this {@code XMLGregorianCalendar} * * @throws IllegalStateException if the combination of set fields * does not match one of the eight defined XML Schema builtin date/time datatypes. @@ -737,14 +734,14 @@ public abstract String toXMLFormat(); /** - *

Return the name of the XML Schema date/time type that this instance - * maps to. Type is computed based on fields that are set.

+ * Return the name of the XML Schema date/time type that this instance + * maps to. Type is computed based on fields that are set. * * * * * * @@ -850,11 +847,11 @@ public abstract QName getXMLSchemaType(); /** - *

Returns a String representation of this XMLGregorianCalendar Object.

+ * Returns a {@code String} representation of this {@code XMLGregorianCalendar} {@code Object}. * - *

The result is a lexical representation generated by {@link #toXMLFormat()}.

+ *

The result is a lexical representation generated by {@link #toXMLFormat()}. * - * @return A non-null valid String representation of this XMLGregorianCalendar. + * @return A non-{@code null} valid {@code String} representation of this {@code XMLGregorianCalendar}. * * @throws IllegalStateException if the combination of set fields * does not match one of the eight defined XML Schema builtin date/time datatypes. @@ -867,89 +864,89 @@ } /** - * Validate instance by getXMLSchemaType() constraints. + * Validate instance by {@code getXMLSchemaType()} constraints. * @return true if data values are valid. */ public abstract boolean isValid(); /** - *

Add duration to this instance.

+ * Add {@code duration} to this instance. * *

The computation is specified in * XML Schema 1.0 Part 2, Appendix E, - * Adding durations to dateTimes>. + * Adding durations to dateTimes. * date/time field mapping table - * defines the mapping from XML Schema 1.0 dateTime fields - * to this class' representation of those fields.

+ * defines the mapping from XML Schema 1.0 {@code dateTime} fields + * to this class' representation of those fields. * - * @param duration Duration to add to this XMLGregorianCalendar. + * @param duration Duration to add to this {@code XMLGregorianCalendar}. * - * @throws NullPointerException when duration parameter is null. + * @throws NullPointerException when {@code duration} parameter is {@code null}. */ public abstract void add(Duration duration); /** - *

Convert this XMLGregorianCalendar to a {@link GregorianCalendar}.

+ * Convert this {@code XMLGregorianCalendar} to a {@link GregorianCalendar}. * - *

When this instance has an undefined field, this - * conversion relies on the java.util.GregorianCalendar default + *

When {@code this} instance has an undefined field, this + * conversion relies on the {@code java.util.GregorianCalendar} default * for its corresponding field. A notable difference between - * XML Schema 1.0 date/time datatypes and java.util.GregorianCalendar + * XML Schema 1.0 date/time datatypes and {@code java.util.GregorianCalendar} * is that Timezone value is optional for date/time datatypes and it is - * a required field for java.util.GregorianCalendar. See javadoc - * for java.util.TimeZone.getDefault() on how the default - * is determined. To explicitly specify the TimeZone + * a required field for {@code java.util.GregorianCalendar}. See javadoc + * for {@code java.util.TimeZone.getDefault()} on how the default + * is determined. To explicitly specify the {@code TimeZone} * instance, see - * {@link #toGregorianCalendar(TimeZone, Locale, XMLGregorianCalendar)}.

+ * {@link #toGregorianCalendar(TimeZone, Locale, XMLGregorianCalendar)}. * *
- * Required fields for XML Schema 1.0 Date/Time Datatypes.
+ * Required fields for XML Schema 1.0 Date/Time Datatypes.
* (timezone is optional for all date/time datatypes) *
* * * * * * * - * - * + * + * * * - * - * + * + * * * - * - * + * + * * * - * + * * * * - * + * * * * - * + * * * * - * + * * * * - * + * * * * - * + * * * * - * + * * * * @@ -958,74 +955,74 @@ * to source datatype having higher precision than target datatype. * *

To ensure consistency in conversion implementations, the new - * GregorianCalendar should be instantiated in following + * {@code GregorianCalendar} should be instantiated in following * manner. *

- *

* * @see #toGregorianCalendar(java.util.TimeZone, java.util.Locale, XMLGregorianCalendar) */ public abstract GregorianCalendar toGregorianCalendar(); /** - *

Convert this XMLGregorianCalendar along with provided parameters - * to a {@link GregorianCalendar} instance.

+ * Convert this {@code XMLGregorianCalendar} along with provided parameters + * to a {@link GregorianCalendar} instance. * *

Since XML Schema 1.0 date/time datetypes has no concept of * timezone ids or daylight savings timezone ids, this conversion operation * allows the user to explicitly specify one with - * timezone parameter.

+ * {@code timezone} parameter. * - *

To compute the return value's TimeZone field, + *

To compute the return value's {@code TimeZone} field, *

* *

To ensure consistency in conversion implementations, the new - * GregorianCalendar should be instantiated in following + * {@code GregorianCalendar} should be instantiated in following * manner. *

* - * @param timezone provide Timezone. null is a legal value. + * @param timezone provide Timezone. {@code null} is a legal value. * @param aLocale provide explicit Locale. Use default GregorianCalendar locale if - * value is null. + * value is {@code null}. * @param defaults provide default field values to use when corresponding * field for this instance is FIELD_UNDEFINED or null. - * If defaultsis null or a field - * within the specified defaults is undefined, - * just use java.util.GregorianCalendar defaults. + * If {@code defaults}is {@code null} or a field + * within the specified {@code defaults} is undefined, + * just use {@code java.util.GregorianCalendar} defaults. * @return a java.util.GregorianCalendar conversion of this instance. */ public abstract GregorianCalendar toGregorianCalendar( @@ -1034,7 +1031,7 @@ XMLGregorianCalendar defaults); /** - *

Returns a java.util.TimeZone for this class.

+ * Returns a {@code java.util.TimeZone} for this class. * *

If timezone field is defined for this instance, * returns TimeZone initialized with custom timezone id @@ -1042,7 +1039,7 @@ * try the defaultZoneoffset that was passed in. * If defaultZoneoffset is FIELD_UNDEFINED, return * default timezone for this host. - * (Same default as java.util.GregorianCalendar).

+ * (Same default as java.util.GregorianCalendar). * * @param defaultZoneoffset default zoneoffset if this zoneoffset is * {@link DatatypeConstants#FIELD_UNDEFINED}. @@ -1054,9 +1051,9 @@ /** - *

Creates and returns a copy of this object.

+ * Creates and returns a copy of this object. * - * @return copy of this Object + * @return copy of this {@code Object} */ public abstract Object clone(); }
* Field by Field Conversion from this class to - * java.util.GregorianCalendar + * {@code java.util.GregorianCalendar} *
java.util.GregorianCalendar fieldjavax.xml.datatype.XMLGregorianCalendar field{@code java.util.GregorianCalendar} field{@code javax.xml.datatype.XMLGregorianCalendar} field
ERA{@link #getEonAndYear()}.signum() < 0 ? GregorianCalendar.BC : GregorianCalendar.AD{@code ERA}{@link #getEonAndYear()}{@code .signum() < 0 ? GregorianCalendar.BC : GregorianCalendar.AD}
YEAR{@link #getEonAndYear()}.abs().intValue()*{@code YEAR}{@link #getEonAndYear()}{@code .abs().intValue()}*
MONTH{@code MONTH}{@link #getMonth()} - {@link DatatypeConstants#JANUARY} + {@link GregorianCalendar#JANUARY}
DAY_OF_MONTH{@code DAY_OF_MONTH}{@link #getDay()}
HOUR_OF_DAY{@code HOUR_OF_DAY}{@link #getHour()}
MINUTE{@code MINUTE}{@link #getMinute()}
SECOND{@code SECOND}{@link #getSecond()}
MILLISECOND{@code MILLISECOND}get millisecond order from {@link #getFractionalSecond()}*
GregorianCalendar.setTimeZone(TimeZone){@code GregorianCalendar.setTimeZone(TimeZone)}{@link #getTimezone()} formatted into Custom timezone id