- java.lang.Object
-
- javax.print.attribute.DateTimeSyntax
-
- All Implemented Interfaces:
Serializable
,Cloneable
- Direct Known Subclasses:
DateTimeAtCompleted
,DateTimeAtCreation
,DateTimeAtProcessing
,JobHoldUntil
public abstract class DateTimeSyntax extends Object implements Serializable, Cloneable
ClassDateTimeSyntax
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'sDate
value by callinggetValue()
. A date-time attribute'sDate
value is established when it is constructed (seeDateTimeSyntax(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 ajava.util.Date
object, then use thejava.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 ajava.util.Calendar
object and set it to thejava.util.Date
from the date-time attribute. ClassDateTimeSyntax
stores its value in the form of ajava.util.Date
rather than ajava.util.Calendar
because it typically takes less memory to store and less time to compare ajava.util.Date
than ajava.util.Calendar
.- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
DateTimeSyntax(Date value)
Construct a new date-time attribute with the givenjava.util.Date
value.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
equals(Object object)
Returns whether this date-time attribute is equivalent to the passed in object.Date
getValue()
Returns this date-time attribute'sjava.util.Date
value.int
hashCode()
Returns a hash code value for this date-time attribute.String
toString()
Returns a string value corresponding to this date-time attribute.
-
-
-
Constructor Detail
DateTimeSyntax
protected DateTimeSyntax(Date value)
Construct a new date-time attribute with the givenjava.util.Date
value.- Parameters:
value
-java.util.Date
value- Throws:
NullPointerException
- ifvalue
isnull
-
Method Detail
getValue
public Date getValue()
Returns this date-time attribute'sjava.util.Date
value.- Returns:
-
the
Date
equals
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 notnull
.object
is an instance of classDateTimeSyntax
.- This date-time attribute's
java.util.Date
value andobject
'sjava.util.Date
value are equal.
- Overrides:
equals
in classObject
- Parameters:
object
-Object
to compare to- Returns:
true
ifobject
is equivalent to this date-time attribute,false
otherwise- See Also:
Object.hashCode()
,HashMap
hashCode
public int hashCode()
Returns a hash code value for this date-time attribute. The hashcode is that of this attribute'sjava.util.Date
value.- Overrides:
hashCode
in classObject
- Returns:
- a hash code value for this object.
- See Also:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-