148 * if the composite
149 * values constitute an invalid XMLGregorianCalendar instance (for example, if
150 * the 31st of June is specified).
151 *
152 * <p>The following operations are defined for this class:
153 * <ul>
154 * <li>accessors/mutators for independent date/time fields</li>
155 * <li>conversion between this class and W3C XML Schema 1.0 lexical representation,
156 * {@link #toString()}, {@link DatatypeFactory#newXMLGregorianCalendar(String lexicalRepresentation)}</li>
157 * <li>conversion between this class and {@link GregorianCalendar},
158 * {@link #toGregorianCalendar(java.util.TimeZone timezone, java.util.Locale aLocale, XMLGregorianCalendar defaults)},
159 * {@link DatatypeFactory}</li>
160 * <li>partial order relation comparator method, {@link #compare(XMLGregorianCalendar xmlGregorianCalendar)}</li>
161 * <li>{@link #equals(Object)} defined relative to {@link #compare(XMLGregorianCalendar xmlGregorianCalendar)}.</li>
162 * <li>addition operation with {@link Duration}
163 * instance as defined in <a href="http://www.w3.org/TR/xmlschema-2/#adding-durations-to-dateTimes">
164 * W3C XML Schema 1.0 Part 2, Appendix E, <i>Adding durations to dateTimes</i></a>.
165 * </li>
166 * </ul>
167 *
168 * @author <a href="mailto:Joseph.Fialli@Sun.com">Joseph Fialli</a>
169 * @author <a href="mailto:Kohsuke.Kawaguchi@Sun.com">Kohsuke Kawaguchi</a>
170 * @author <a href="mailto:Jeff.Suttor@Sun.com">Jeff Suttor</a>
171 * @author <a href="mailto:Sunitha.Reddy@Sun.com">Sunitha Reddy</a>
172 * @see Duration
173 * @see DatatypeFactory
174 * @since 1.5
175 */
176
177 public abstract class XMLGregorianCalendar
178 implements Cloneable {
179
180 /**
181 * Default no-arg constructor.
182 *
183 * <p>Note: Always use the {@link DatatypeFactory} to
184 * construct an instance of {@code XMLGregorianCalendar}.
185 * The constructor on this class cannot be guaranteed to
186 * produce an object with a consistent state and may be
187 * removed in the future.
188 */
189 public XMLGregorianCalendar() {
190 }
191
|
148 * if the composite
149 * values constitute an invalid XMLGregorianCalendar instance (for example, if
150 * the 31st of June is specified).
151 *
152 * <p>The following operations are defined for this class:
153 * <ul>
154 * <li>accessors/mutators for independent date/time fields</li>
155 * <li>conversion between this class and W3C XML Schema 1.0 lexical representation,
156 * {@link #toString()}, {@link DatatypeFactory#newXMLGregorianCalendar(String lexicalRepresentation)}</li>
157 * <li>conversion between this class and {@link GregorianCalendar},
158 * {@link #toGregorianCalendar(java.util.TimeZone timezone, java.util.Locale aLocale, XMLGregorianCalendar defaults)},
159 * {@link DatatypeFactory}</li>
160 * <li>partial order relation comparator method, {@link #compare(XMLGregorianCalendar xmlGregorianCalendar)}</li>
161 * <li>{@link #equals(Object)} defined relative to {@link #compare(XMLGregorianCalendar xmlGregorianCalendar)}.</li>
162 * <li>addition operation with {@link Duration}
163 * instance as defined in <a href="http://www.w3.org/TR/xmlschema-2/#adding-durations-to-dateTimes">
164 * W3C XML Schema 1.0 Part 2, Appendix E, <i>Adding durations to dateTimes</i></a>.
165 * </li>
166 * </ul>
167 *
168 * @author Joseph Fialli
169 * @author Kohsuke Kawaguchi
170 * @author Jeff Suttor
171 * @author Sunitha Reddy
172 * @see Duration
173 * @see DatatypeFactory
174 * @since 1.5
175 */
176
177 public abstract class XMLGregorianCalendar
178 implements Cloneable {
179
180 /**
181 * Default no-arg constructor.
182 *
183 * <p>Note: Always use the {@link DatatypeFactory} to
184 * construct an instance of {@code XMLGregorianCalendar}.
185 * The constructor on this class cannot be guaranteed to
186 * produce an object with a consistent state and may be
187 * removed in the future.
188 */
189 public XMLGregorianCalendar() {
190 }
191
|