Class DateTimeSyntax
- 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
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 callinggetValue()
. A date-time attribute's Date 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. Class DateTimeSyntax 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 and 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 and 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
- (unchecked exception) Thrown iftheValue
is null.
-
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 not null.object
is an instance of class DateTimeSyntax.- 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 if
object
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)
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.