java.io.Serializable, java.lang.Comparable<DurationField>ScaledDurationFieldpublic class DecoratedDurationField extends BaseDurationField
DecoratedDurationField extends BaseDurationField,
implementing only the minimum required set of methods. These implemented
methods delegate to a wrapped field.
This design allows new DurationField types to be defined that piggyback on top of another, inheriting all the safe method implementations from BaseDurationField. Should any method require pure delegation to the wrapped field, simply override and use the provided getWrappedField method.
DecoratedDurationField is thread-safe and immutable, and its subclasses must be as well.
DelegatedDurationField,
Serialized Form| Constructor | Description |
|---|---|
DecoratedDurationField(DurationField field,
DurationFieldType type) |
Constructor.
|
| Modifier and Type | Method | Description |
|---|---|---|
long |
add(long instant,
int value) |
Adds a duration value (which may be negative) to the instant.
|
long |
add(long instant,
long value) |
Adds a duration value (which may be negative) to the instant.
|
long |
getDifferenceAsLong(long minuendInstant,
long subtrahendInstant) |
Computes the difference between two instants, as measured in the units
of this field.
|
long |
getMillis(int value,
long instant) |
Get the millisecond duration of this field from its value relative to an
instant.
|
long |
getMillis(long value,
long instant) |
Get the millisecond duration of this field from its value relative to an
instant.
|
long |
getUnitMillis() |
Returns the amount of milliseconds per unit value of this field.
|
long |
getValueAsLong(long duration,
long instant) |
Get the value of this field from the milliseconds relative to an
instant.
|
DurationField |
getWrappedField() |
Gets the wrapped duration field.
|
boolean |
isPrecise() |
Is this field precise.
|
compareTo, getDifference, getMillis, getMillis, getName, getType, getValue, getValue, getValueAsLong, isSupported, toStringsubtract, subtractpublic DecoratedDurationField(DurationField field, DurationFieldType type)
field - the base fieldtype - the type to actually usepublic final DurationField getWrappedField()
public boolean isPrecise()
DurationFieldisPrecise in class DurationFieldDurationField.getUnitMillis()public long getValueAsLong(long duration,
long instant)
DurationFieldIf the millisecond duration is positive, then the instant is treated as a "start instant". If negative, the instant is treated as an "end instant".
getValueAsLong in class DurationFieldduration - the milliseconds to query, which may be negativeinstant - the start instant to calculate relative topublic long getMillis(int value,
long instant)
DurationFieldIf the value is positive, then the instant is treated as a "start instant". If negative, the instant is treated as an "end instant".
getMillis in class DurationFieldvalue - the value of the field, which may be negativeinstant - the instant to calculate relative topublic long getMillis(long value,
long instant)
DurationFieldIf the value is positive, then the instant is treated as a "start instant". If negative, the instant is treated as an "end instant".
getMillis in class DurationFieldvalue - the value of the field, which may be negativeinstant - the instant to calculate relative topublic long add(long instant,
int value)
DurationFieldadd in class DurationFieldinstant - the milliseconds from 1970-01-01T00:00:00Z to add tovalue - the value to add, in the units of the fieldpublic long add(long instant,
long value)
DurationFieldadd in class DurationFieldinstant - the milliseconds from 1970-01-01T00:00:00Z to add tovalue - the value to add, in the units of the fieldpublic long getDifferenceAsLong(long minuendInstant,
long subtrahendInstant)
DurationFieldlong instant = ... long v = ... long age = getDifferenceAsLong(add(instant, v), instant);The value 'age' is the same as the value 'v'.
getDifferenceAsLong in class DurationFieldminuendInstant - the milliseconds from 1970-01-01T00:00:00Z to
subtract fromsubtrahendInstant - the milliseconds from 1970-01-01T00:00:00Z to
subtract off the minuendpublic long getUnitMillis()
DurationFieldFor imprecise fields, the unit size is variable, and so this method returns a suitable average value.
getUnitMillis in class DurationFieldDurationField.isPrecise()