org.joda.time.field
Class PreciseDurationField
- Comparable, Serializable
public class PreciseDurationField
Duration field class representing a field with a fixed unit length.
PreciseDurationField is thread-safe and immutable.
- Stephen Colebourne
- Brian S O'Neill
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.
|
boolean | equals(Object obj) - Compares this duration field to another.
|
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.
|
long | getMillis(long value, long instant) - Get the millisecond duration of this field from its value.
|
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.
|
int | hashCode() - Gets a hash code for this instance.
|
boolean | isPrecise() - This field is precise.
|
compareTo , getDifference , getMillis , getMillis , getName , getType , getValue , getValue , getValueAsLong , isSupported , toString |
add , add , compareTo , getDifference , getDifferenceAsLong , getMillis , getMillis , getMillis , getMillis , getName , getType , getUnitMillis , getValue , getValue , getValueAsLong , getValueAsLong , isPrecise , isSupported , subtract , subtract , toString |
PreciseDurationField
public PreciseDurationField(DurationFieldType type,
long unitMillis)
Constructor.
type
- the field typeunitMillis
- the unit milliseconds
add
public long add(long instant,
int value)
Adds a duration value (which may be negative) to the instant.
- add in interface DurationField
instant
- the milliseconds from 1970-01-01T00:00:00Z to add tovalue
- the value to add, in the units of the field
add
public long add(long instant,
long value)
Adds a duration value (which may be negative) to the instant.
- add in interface DurationField
instant
- the milliseconds from 1970-01-01T00:00:00Z to add tovalue
- the value to add, in the units of the field
equals
public boolean equals(Object obj)
Compares this duration field to another.
Two fields are equal if of the same type and duration.
obj
- the object to compare to
getDifferenceAsLong
public long getDifferenceAsLong(long minuendInstant,
long subtrahendInstant)
Computes the difference between two instants, as measured in the units
of this field. Any fractional units are dropped from the result. Calling
getDifference reverses the effect of calling add. In the following code:
long instant = ...
long v = ...
long age = getDifferenceAsLong(add(instant, v), instant);
The value 'age' is the same as the value 'v'.
- getDifferenceAsLong in interface 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
- the difference in the units of this field
getMillis
public long getMillis(int value,
long instant)
Get the millisecond duration of this field from its value.
- getMillis in interface DurationField
value
- the value of the field, which may be negativeinstant
- ignored
- the milliseconds that the field represents, which may be
negative
getMillis
public long getMillis(long value,
long instant)
Get the millisecond duration of this field from its value.
- getMillis in interface DurationField
value
- the value of the field, which may be negativeinstant
- ignored
- the milliseconds that the field represents, which may be
negative
getUnitMillis
public final long getUnitMillis()
Returns the amount of milliseconds per unit value of this field.
- getUnitMillis in interface DurationField
- the unit size of this field, in milliseconds
getValueAsLong
public long getValueAsLong(long duration,
long instant)
Get the value of this field from the milliseconds.
- getValueAsLong in interface DurationField
duration
- the milliseconds to query, which may be negativeinstant
- ignored
- the value of the field, in the units of the field, which may be
negative
hashCode
public int hashCode()
Gets a hash code for this instance.
Copyright (c) 2001-2006 - Joda.org