manifold.science.measures

Class Time

java.lang.Object

manifold.science.api.AbstractMeasure<TimeUnit,Time>

manifold.science.measures.Time

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<Time>, java.time.temporal.TemporalAmount, Sequential<Time,Rational,TimeUnit>, ComparableUsing<Time>, Dimension<Time>

public final class Time
extends AbstractMeasure<TimeUnit,Time>
implements java.time.temporal.TemporalAmount

Models a measure of time in units of TimeUnit.

Use values of Time directly in arithmetic expressions with other dimensions such as:

   // commonly used unit abbreviations e.g., m, ft, hr, mph, etc.
   import static manifold.science.util.UnitConstants.*;
   ...
   Time duration = 5.2 hr;
   Time mileTime = 4 min + 12.78 sec;
   Length distance = 80 mph * 2.3 hr;
 

Like all dimensions in the manifold.science.measures library, the Time dimension is unit-independent, which means you can work with any combination of TimeUnit such as Second, Hour, and Day, because all operations on Time are maintained internally using standard SI units.

 Time seconds = 12.7 s;
 seconds = seconds + 5.2 hr; // add hours to seconds
 

Time implements TemporalAmount so you can easily work with Java's java.time library:

   LocalDateTime date = LocalDateTime.of( 2018, 10, 17, 17, 35 );
   LocalDateTime yearLater = date + 1 yr;
   LocalDateTime tomorrowOneHourLater = date + 1 day + 1 hr;
 

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface manifold.ext.rt.api.ComparableUsing

ComparableUsing.EqualityMode, ComparableUsing.Operator

Constructor Summary

Constructors

Constructor and Description
Time(Rational value, TimeUnit unit)
Time(Rational value, TimeUnit unit, TimeUnit displayUnit)

Method Summary

Modifier and Type	Method and Description
java.time.temporal.Temporal	addTo(java.time.temporal.Temporal temporal)
long	get(java.time.temporal.TemporalUnit unit)
TimeUnit	getBaseUnit() The unit on which all instances of this type are based.
java.util.List<java.time.temporal.TemporalUnit>	getUnits()
Time	make(Rational value, TimeUnit unit) Creates a new instance using the specified parameters.
Time	make(Rational value, TimeUnit unit, TimeUnit displayUnit) Creates a new instance using the specified parameters.
static Time	now()
java.time.temporal.Temporal	subtractFrom(java.time.temporal.Temporal temporal)
Velocity	times(Acceleration acc)
Charge	times(Current current)
Momentum	times(Force force)
Angle	times(Frequency frequency)
Energy	times(Power power)
Length	times(Velocity r)

Methods inherited from class manifold.science.api.AbstractMeasure

compareTo, copy, copy, div, equalityMode, equals, fromBaseNumber, fromNumber, getDisplayUnit, getValue, hashCode, minus, nextInSequence, nextNthInSequence, plus, previousInSequence, previousNthInSequence, rem, to, toBaseNumber, toMixedString, toNumber, toNumber, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface manifold.science.api.Dimension

div, rem, times, unaryMinus

Methods inherited from interface manifold.ext.rt.api.ComparableUsing

compareToUsing

Constructor Detail

Time

public Time(Rational value,
            TimeUnit unit,
            TimeUnit displayUnit)

Time

public Time(Rational value,
            TimeUnit unit)

Method Detail

getBaseUnit

public TimeUnit getBaseUnit()

Description copied from class: AbstractMeasure

The unit on which all instances of this type are based. For instance, a Length dimension might use Meters as the base unit because it is the SI standard.

Specified by:

getBaseUnit in class AbstractMeasure<TimeUnit,Time>

make

public Time make(Rational value,
                 TimeUnit unit,
                 TimeUnit displayUnit)

Description copied from class: AbstractMeasure

Creates a new instance using the specified parameters.

Specified by:

make in class AbstractMeasure<TimeUnit,Time>

make

public Time make(Rational value,
                 TimeUnit unit)

Description copied from class: AbstractMeasure

Creates a new instance using the specified parameters.

Specified by:

make in class AbstractMeasure<TimeUnit,Time>

now

public static Time now()

get

public long get(java.time.temporal.TemporalUnit unit)

Specified by:

get in interface java.time.temporal.TemporalAmount

getUnits

public java.util.List<java.time.temporal.TemporalUnit> getUnits()

Specified by:

getUnits in interface java.time.temporal.TemporalAmount

addTo

public java.time.temporal.Temporal addTo(java.time.temporal.Temporal temporal)

Specified by:

addTo in interface java.time.temporal.TemporalAmount

subtractFrom

public java.time.temporal.Temporal subtractFrom(java.time.temporal.Temporal temporal)

Specified by:

subtractFrom in interface java.time.temporal.TemporalAmount

times

public Length times(Velocity r)

times

public Velocity times(Acceleration acc)

times

public Charge times(Current current)

times

public Angle times(Frequency frequency)

times

public Energy times(Power power)

times

public Momentum times(Force force)