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 |