org.joda.time
Interface ReadableDuration

All Superinterfaces:

Comparable

All Known Implementing Classes:

AbstractDuration, BaseDuration, Duration

public interface ReadableDuration

extends Comparable

Defines an exact duration of time in milliseconds.

The implementation of this interface may be mutable or immutable. This interface only gives access to retrieve data, never to change it.

Methods that are passed a duration as a parameter will treat null as a zero length duration.

Since:

1.0

Author:

Brian S O'Neill, Stephen Colebourne

See Also:

ReadableInterval, ReadablePeriod

Method Summary

int	compareTo(Object obj) Compares this duration with the specified duration based on length.
boolean	equals(Object readableDuration) Compares this object with the specified object for equality based on the millisecond length.
long	getMillis() Gets the total length of this duration in milliseconds.
int	hashCode() Gets a hash code for the duration that is compatable with the equals method.
boolean	isEqual(ReadableDuration duration) Is the length of this duration equal to the duration passed in.
boolean	isLongerThan(ReadableDuration duration) Is the length of this duration longer than the duration passed in.
boolean	isShorterThan(ReadableDuration duration) Is the length of this duration shorter than the duration passed in.
Duration	toDuration() Get this duration as an immutable Duration object.
Period	toPeriod() Converts this duration to a Period instance using the standard period type and the ISO chronology.
String	toString() Gets the value as a String in the ISO8601 duration format using hours, minutes and seconds (including fractional milliseconds).

Method Detail

getMillis

public long getMillis()

Gets the total length of this duration in milliseconds.

Returns:

the total length of the time duration in milliseconds.

toDuration

public Duration toDuration()

Get this duration as an immutable Duration object.

This will either typecast this instance, or create a new Duration.

Returns:

a Duration created using the millisecond duration from this instance

toPeriod

public Period toPeriod()

Converts this duration to a Period instance using the standard period type and the ISO chronology.

Only precise fields in the period type will be used. Thus, only the hour, minute, second and millisecond fields on the period will be used. The year, month, week and day fields will not be populated.

If the duration is small, less than one day, then this method will perform as you might expect and split the fields evenly. If the duration is larger than one day then all the remaining duration will be stored in the largest available field, hours in this case.

For example, a duration effectively equal to (365 + 60 + 5) days will be converted to ((365 + 60 + 5) * 24) hours by this constructor.

For more control over the conversion process, you must pair the duration with an instant, see Period.Period(ReadableInstant,ReadableDuration).

Returns:

a Period created using the millisecond duration from this instance

compareTo

public int compareTo(Object obj)

Compares this duration with the specified duration based on length.

Specified by:

compareTo in interface Comparable

Parameters:

obj - a duration to check against

Returns:

negative value if this is less, 0 if equal, or positive value if greater

Throws:

NullPointerException - if the object is null

ClassCastException - if the given object is not supported

isEqual

public boolean isEqual(ReadableDuration duration)

Is the length of this duration equal to the duration passed in.

Parameters:

duration - another duration to compare to, null means zero milliseconds

Returns:

true if this duration is equal to than the duration passed in

isLongerThan

public boolean isLongerThan(ReadableDuration duration)

Is the length of this duration longer than the duration passed in.

Parameters:

duration - another duration to compare to, null means zero milliseconds

Returns:

true if this duration is equal to than the duration passed in

isShorterThan

public boolean isShorterThan(ReadableDuration duration)

Is the length of this duration shorter than the duration passed in.

Parameters:

duration - another duration to compare to, null means zero milliseconds

Returns:

true if this duration is equal to than the duration passed in

equals

public boolean equals(Object readableDuration)

Compares this object with the specified object for equality based on the millisecond length. All ReadableDuration instances are accepted.

Parameters:

readableDuration - a readable duration to check against

Returns:

true if the length of the duration is equal

hashCode

public int hashCode()

Gets a hash code for the duration that is compatable with the equals method. The following formula must be used:

  long len = getMillis();
  return (int) (len ^ (len >>> 32));
 

Returns:

a hash code

toString

public String toString()

Gets the value as a String in the ISO8601 duration format using hours, minutes and seconds (including fractional milliseconds).

For example, "PT6H3M7S" represents 6 hours, 3 minutes, 7 seconds.

Returns:

the value as an ISO8601 string