|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.joda.time.DurationField org.joda.time.field.BaseDurationField
public abstract class BaseDurationField
BaseDurationField provides the common behaviour for DurationField implementations.
This class should generally not be used directly by API users. The DurationField class should be used when different kinds of DurationField objects are to be referenced.
BaseDurationField is thread-safe and immutable, and its subclasses must be as well.
DecoratedDurationField
,
Serialized FormConstructor Summary | |
---|---|
protected |
BaseDurationField(DurationFieldType type)
|
Method Summary | |
---|---|
int |
compareTo(DurationField otherField)
|
int |
getDifference(long minuendInstant,
long subtrahendInstant)
Computes the difference between two instants, as measured in the units of this field. |
long |
getMillis(int value)
Get the millisecond duration of this field from its value, which is approximate if this field is imprecise. |
long |
getMillis(long value)
Get the millisecond duration of this field from its value, which is approximate if this field is imprecise. |
String |
getName()
Get the name of the field. |
DurationFieldType |
getType()
Get the type of the field. |
int |
getValue(long duration)
Get the value of this field from the milliseconds, which is approximate if this field is imprecise. |
int |
getValue(long duration,
long instant)
Get the value of this field from the milliseconds relative to an instant. |
long |
getValueAsLong(long duration)
Get the value of this field from the milliseconds, which is approximate if this field is imprecise. |
boolean |
isSupported()
Returns true if this field is supported. |
String |
toString()
Get a suitable debug string. |
Methods inherited from class org.joda.time.DurationField |
---|
add, add, getDifferenceAsLong, getMillis, getMillis, getUnitMillis, getValueAsLong, isPrecise, subtract, subtract |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
protected BaseDurationField(DurationFieldType type)
Method Detail |
---|
public final DurationFieldType getType()
DurationField
getType
in class DurationField
public final String getName()
DurationField
By convention, names are plural.
getName
in class DurationField
public final boolean isSupported()
DurationField
isSupported
in class DurationField
public int getValue(long duration)
getValue
in class DurationField
duration
- the milliseconds to query, which may be negative
public long getValueAsLong(long duration)
getValueAsLong
in class DurationField
duration
- the milliseconds to query, which may be negative
public int getValue(long duration, long instant)
If the milliseconds is positive, then the instant is treated as a "start instant". If negative, the instant is treated as an "end instant".
The default implementation returns
Utils.safeToInt(getAsLong(millisDuration, instant))
.
getValue
in class DurationField
duration
- the milliseconds to query, which may be negativeinstant
- the start instant to calculate relative to
public long getMillis(int value)
getMillis
in class DurationField
value
- the value of the field, which may be negative
public long getMillis(long value)
getMillis
in class DurationField
value
- the value of the field, which may be negative
public int getDifference(long minuendInstant, long subtrahendInstant)
DurationField
long instant = ... int v = ... int age = getDifference(add(instant, v), instant);The value 'age' is the same as the value 'v'.
getDifference
in class DurationField
minuendInstant
- the milliseconds from 1970-01-01T00:00:00Z to
subtract fromsubtrahendInstant
- the milliseconds from 1970-01-01T00:00:00Z to
subtract off the minuend
public int compareTo(DurationField otherField)
compareTo
in interface Comparable<DurationField>
public String toString()
toString
in class DurationField
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |