Class AbstractDuration

java.lang.Object
org.joda.time.base.AbstractDuration
All Implemented Interfaces:
Comparable<ReadableDuration>, ReadableDuration
Direct Known Subclasses:
BaseDuration

public abstract class AbstractDuration extends Object implements ReadableDuration
AbstractDuration provides the common behaviour for duration classes.

This class should generally not be used directly by API users. The ReadableDuration interface should be used when different kinds of durations are to be referenced.

AbstractDuration subclasses may be mutable and not thread-safe.

Since:
1.0
Author:
Brian S O'Neill, Stephen Colebourne
  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
    protected
    Constructor.
  • Method Summary

    Modifier and Type
    Method
    Description
    int
    Compares this duration with the specified duration based on length and direction.
    boolean
    equals(Object duration)
    Compares this object with the specified object for equality based on the millisecond length.
    int
    Gets a hash code for the duration that is compatible with the equals method.
    boolean
    Is the length of this duration equal to the duration passed in.
    boolean
    Is the length of this duration longer than the duration passed in.
    boolean
    Is the length of this duration shorter than the duration passed in.
    Get this duration as an immutable Duration object.
    Converts this duration to a Period instance using the standard period type and the ISO chronology.
    Gets the value as a String in the ISO8601 duration format including only seconds and milliseconds.

    Methods inherited from class java.lang.Object

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

    Methods inherited from interface org.joda.time.ReadableDuration

    getMillis
  • Constructor Details

    • AbstractDuration

      protected AbstractDuration()
      Constructor.
  • Method Details

    • toDuration

      public Duration toDuration()
      Get this duration as an immutable Duration object.
      Specified by:
      toDuration in interface ReadableDuration
      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(ReadableInstant,ReadableDuration).

      Specified by:
      toPeriod in interface ReadableDuration
      Returns:
      a Period created using the millisecond duration from this instance
    • compareTo

      public int compareTo(ReadableDuration other)
      Compares this duration with the specified duration based on length and direction.

      The comparison takes into account the sign. As such, a duration of 5 seconds is longer than a duration of minus 7 seconds.

      Specified by:
      compareTo in interface Comparable<ReadableDuration>
      Parameters:
      other - 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.

      The comparison takes into account the sign. As such, a duration of 5 seconds is not equal to a duration of minus 5 seconds.

      Specified by:
      isEqual in interface ReadableDuration
      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.

      The comparison takes into account the sign. As such, a duration of 5 seconds is longer than a duration of minus 7 seconds.

      Specified by:
      isLongerThan in interface ReadableDuration
      Parameters:
      duration - another duration to compare to, null means zero milliseconds
      Returns:
      true if this duration is strictly longer than the duration passed in
    • isShorterThan

      public boolean isShorterThan(ReadableDuration duration)
      Is the length of this duration shorter than the duration passed in.

      The comparison takes into account the sign. As such, a duration of minus 5 seconds is shorter than a duration of 3 seconds.

      Specified by:
      isShorterThan in interface ReadableDuration
      Parameters:
      duration - another duration to compare to, null means zero milliseconds
      Returns:
      true if this duration is strictly shorter than the duration passed in
    • equals

      public boolean equals(Object duration)
      Compares this object with the specified object for equality based on the millisecond length. All ReadableDuration instances are accepted.

      The comparison takes into account the sign. As such, a duration of 5 seconds is not equal to a duration of minus 5 seconds.

      Specified by:
      equals in interface ReadableDuration
      Overrides:
      equals in class Object
      Parameters:
      duration - 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 compatible with the equals method.
      Specified by:
      hashCode in interface ReadableDuration
      Overrides:
      hashCode in class Object
      Returns:
      a hash code
    • toString

      public String toString()
      Gets the value as a String in the ISO8601 duration format including only seconds and milliseconds.

      For example, "PT72.345S" represents 1 minute, 12 seconds and 345 milliseconds.

      For more control over the output, see PeriodFormatterBuilder.

      Specified by:
      toString in interface ReadableDuration
      Overrides:
      toString in class Object
      Returns:
      the value as an ISO8601 string