A Span
with the maximum expressible value, Span(Long.MaxValue, Nanoseconds)
,
which is approximately 292 years.
A Span
with the maximum expressible value, Span(Long.MaxValue, Nanoseconds)
,
which is approximately 292 years.
One use case for this Span
value is to help convert a duration concept from a different library to
Span
when that library's duration concept includes a notion of infinite durations. An infinite
duration can be converted to Span.Max
.
a Span
with the maximum expressible value, Long.MaxValue
nanoseconds.
A Span
with representing a zero-length span of time.
A Span
with representing a zero-length span of time.
a zero-length Span
.
Returns a Span
representing the passed Double
length
of time in the
passed units
.
Returns a Span
representing the passed Double
length
of time in the
passed units
.
If the requested time span is less than 0.0
or, when converted to Long
number of nanoseconds, would be greater than
Long.MaxValue
nanoseconds, this method will throw an IllegalArgumentException
.
(Note: a zero-length time span is allowed, just not a negative or too-large time span.)
the length of time denominated by the passed units
the units of time for the passed length
a Span
representing the requested time span
Returns a Span
representing the passed Long
length
of time in the
passed units
.
Returns a Span
representing the passed Long
length
of time in the
passed units
.
If the requested time span is less than zero or greater than Long.MaxValue
nanoseconds, this method will throw
an IllegalArgumentException
. (Note: a zero-length time span is allowed, just not a negative or
too-large time span.)
the length of time denominated by the passed units
the units of time for the passed length
a Span
representing the requested time span
Companion object for
Span
that provides two factory methods for creatingSpan
instances.The first argument to each factory method is a numeric value; the second argument is a
Units
value. One factory method takes aLong
, so it can be invoked with either anInt
or Long, as in:The other factory method takes a
Double
, so it can be invoked with either aFloat
or aDouble
: