com.twitter.util

Duration

sealed class Duration extends TimeLike[Duration] with Serializable

A Duration represents the span between two points in time. It represents this with a signed long, and thus the largest representable duration is:

106751.days+23.hours+47.minutes+16.seconds +854.milliseconds+775.microseconds+807.nanoseconds

Durations may be constructed via its companion object, Duration.fromNanoseconds, Duration.fromSeconds, etc. or by using the time conversions:

import com.twitter.conversions.time._

3.days+4.nanoseconds

In addition to the timespans in the range of Long.MinValue to Long.MaxValue nanoseconds, durations have two distinguished values: Duration.Top and Duration.Bottom. These have special semantics: Top is greater than every other duration, save for itself; Bottom is smaller than any duration except for itself — they act like positive and negative infinity, and their arithmetic follows. This is useful for representing durations that are truly infinite; for example the absence of a timeout.

Linear Supertypes
Serializable, TimeLike[Duration], Ordered[Duration], Comparable[Duration], AnyRef, Any
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. Duration
  2. Serializable
  3. TimeLike
  4. Ordered
  5. Comparable
  6. AnyRef
  7. Any
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Value Members

  1. final def !=(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  2. final def !=(arg0: Any): Boolean

    Definition Classes
    Any
  3. final def ##(): Int

    Definition Classes
    AnyRef → Any
  4. def %(x: Duration): Duration

    Scales this Duration by modding by x.

  5. def *(x: Double): Duration

    Scales this Duration by multiplying by x.

  6. def *(x: Long): Duration

    Scales this Duration by multiplying by x.

  7. def +(delta: Duration): Duration

    Adds delta to this TimeLike.

    Adds delta to this TimeLike. Adding Duration.Top results in the TimeLike's Top, adding Duration.Bottom results in the TimeLike's Bottom.

    Definition Classes
    TimeLike
  8. def -(delta: Duration): Duration

    Definition Classes
    TimeLike
  9. def /(x: Double): Duration

    Scales this Duration by dividing by x.

  10. def /(x: Long): Duration

    Scales this Duration by dividing by x.

  11. def <(that: Duration): Boolean

    Definition Classes
    Ordered
  12. def <=(that: Duration): Boolean

    Definition Classes
    Ordered
  13. final def ==(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  14. final def ==(arg0: Any): Boolean

    Definition Classes
    Any
  15. def >(that: Duration): Boolean

    Definition Classes
    Ordered
  16. def >=(that: Duration): Boolean

    Definition Classes
    Ordered
  17. def abs: Duration

    Converts negative durations to positive durations.

  18. def afterEpoch: Time

  19. def ago: Time

  20. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  21. def clone(): AnyRef

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  22. def compare(that: Duration): Int

    Definition Classes
    TimeLike → Ordered
  23. def compareTo(that: Duration): Int

    Definition Classes
    Ordered → Comparable
  24. def diff(that: Duration): Duration

    The difference between the two TimeLikes

    The difference between the two TimeLikes

    Definition Classes
    DurationTimeLike
  25. def div(x: Double): Duration

    See also

    operator /

  26. def div(x: Long): Duration

    See also

    operator /

  27. final def eq(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  28. def equals(other: Any): Boolean

    Definition Classes
    Duration → AnyRef → Any
  29. def finalize(): Unit

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  30. def floor(x: Duration): Duration

    Rounds down to the nearest multiple of the given duration.

    Rounds down to the nearest multiple of the given duration. For example: 127.seconds.floor(1.minute) => 2.minutes. Taking the floor of a Time object with duration greater than 1.hour can have unexpected results because of timezones.

    Definition Classes
    DurationTimeLike
  31. def fromNow: Time

  32. final def getClass(): Class[_]

    Definition Classes
    AnyRef → Any
  33. def hashCode(): Int

    Definition Classes
    Duration → AnyRef → Any
  34. def inDays: Int

    Definition Classes
    TimeLike
  35. def inHours: Int

    Definition Classes
    TimeLike
  36. def inLongSeconds: Long

    Definition Classes
    TimeLike
  37. def inMicroseconds: Long

    Definition Classes
    TimeLike
  38. def inMillis: Long

    Definition Classes
    TimeLike
  39. def inMilliseconds: Long

    Definition Classes
    TimeLike
  40. def inMinutes: Int

    Definition Classes
    TimeLike
  41. def inNanoseconds: Long

    The TimeLike's value in nanoseconds.

    The TimeLike's value in nanoseconds.

    Definition Classes
    DurationTimeLike
  42. def inSeconds: Int

    Definition Classes
    TimeLike
  43. def inTimeUnit: (Long, TimeUnit)

    Returns a value/TimeUnit pair; attempting to return coarser grained values if possible (specifically: TimeUnit.SECONDS or TimeUnit.MILLISECONDS) before resorting to the default TimeUnit.NANOSECONDS.

    Returns a value/TimeUnit pair; attempting to return coarser grained values if possible (specifically: TimeUnit.SECONDS or TimeUnit.MILLISECONDS) before resorting to the default TimeUnit.NANOSECONDS.

    Definition Classes
    TimeLike
  44. def inUnit(unit: TimeUnit): Long

    Returns the length of the duration in the given TimeUnit.

    Returns the length of the duration in the given TimeUnit.

    In general, a simpler approach is to use the named methods (eg. inSeconds) However, this is useful for more programmatic call sites.

  45. def isFinite: Boolean

    Is this a finite TimeLike value?

    Is this a finite TimeLike value?

    Definition Classes
    DurationTimeLike
  46. final def isInstanceOf[T0]: Boolean

    Definition Classes
    Any
  47. def max(that: Duration): Duration

    Definition Classes
    TimeLike
  48. def min(that: Duration): Duration

    Definition Classes
    TimeLike
  49. def minus(delta: Duration): Duration

    See also

    operator -

  50. def moreOrLessEquals(other: Duration, maxDelta: Duration): Boolean

    Equality within maxDelta

    Equality within maxDelta

    Definition Classes
    TimeLike
  51. def mul(x: Double): Duration

    See also

    operator *

  52. def mul(x: Long): Duration

    See also

    operator *

  53. val nanos: Long

    Attributes
    protected
  54. final def ne(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  55. def neg: Duration

    Negates this Duration.

  56. final def notify(): Unit

    Definition Classes
    AnyRef
  57. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  58. val ops: Duration.type

    Attributes
    protected
    Definition Classes
    DurationTimeLike
  59. def plus(delta: Duration): Duration

    See also

    operator +

  60. def rem(x: Duration): Duration

    See also

    operator %

  61. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef
  62. def toString(): String

    toString produces a representation that

    toString produces a representation that

    - loses no information - is easy to read - can be read back in if com.twitter.conversions.time._ is imported

    An example:

    com.twitter.util.Duration(9999999, java.util.concurrent.TimeUnit.MICROSECONDS) res0: com.twitter.util.Duration = 9.seconds+999.milliseconds+999.microseconds

    Definition Classes
    Duration → AnyRef → Any
  63. def unary_-: Duration

  64. final def wait(): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  65. final def wait(arg0: Long, arg1: Int): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  66. final def wait(arg0: Long): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Inherited from Serializable

Inherited from TimeLike[Duration]

Inherited from Ordered[Duration]

Inherited from Comparable[Duration]

Inherited from AnyRef

Inherited from Any

Ungrouped