public abstract class DateTimeSyntax extends Object implements Serializable, Cloneable
Class DateTimeSyntax is an abstract base class providing the common implementation of all attributes whose value is a date and time.
Under the hood, a date-time attribute is stored as a value of class
java.util.Date
. You can get a date-time attribute's Date value by calling getValue()
. A date-time attribute's Date value is established when it is constructed (see DateTimeSyntax(Date)
). Once constructed, a date-time attribute's value is immutable.
To construct a date-time attribute from separate values of the year, month, day, hour, minute, and so on, use a java.util.Calendar
object to construct a java.util.Date
object, then use the java.util.Date
object to construct the date-time attribute. To convert a date-time attribute to separate values of the year, month, day, hour, minute, and so on, create a java.util.Calendar
object and set it to the java.util.Date
from the date-time attribute. Class DateTimeSyntax stores its value in the form of a java.util.Date
rather than a java.util.Calendar
because it typically takes less memory to store and less time to compare a java.util.Date
than a java.util.Calendar
.
protected DateTimeSyntax(Date value)
Construct a new date-time attribute with the given java.util.Date
value.
value
- java.util.Date
value.NullPointerException
- (unchecked exception) Thrown if theValue
is null.public Date getValue()
Returns this date-time attribute's java.util.Date
value.
public boolean equals(Object object)
Returns whether this date-time attribute is equivalent to the passed in object. To be equivalent, all of the following conditions must be true:
object
is not null. object
is an instance of class DateTimeSyntax. java.util.Date
value and object
's java.util.Date
value are equal. equals
in class Object
object
- Object to compare to.object
is equivalent to this date-time attribute, false otherwise.Object.hashCode()
, HashMap
public int hashCode()
Returns a hash code value for this date-time attribute. The hashcode is that of this attribute's java.util.Date
value.
hashCode
in class Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
public String toString()
Returns a string value corresponding to this date-time attribute. The string value is just this attribute's java.util.Date
value converted to a string.
© 1993–2017, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.