Package org.orekit.time

Class UTCTAIOffset

java.lang.Object

org.orekit.time.UTCTAIOffset

All Implemented Interfaces:

Serializable, TimeStamped

public class UTCTAIOffset
extends Object
implements TimeStamped, Serializable

Offset between UTC and TAI time scales.

The UTC and TAI time scales are two scales offset with respect to each other. The TAI scale is continuous whereas the UTC includes some discontinuity when leap seconds are introduced by the International Earth Rotation Service (IERS).

This class represents the offset between the two scales that is valid between two leap seconds occurrences. It handles both the linear offsets used from 1961-01-01 to 1971-12-31 and the constant integer offsets used since 1972-01-01.

Author:

Luc Maisonobe

See Also:

UTCScale, UTCTAIHistoryFilesLoader, Serialized Form

Method Summary

Modifier and Type	Method	Description
AbsoluteDate	getDate()	Get the date of the start of the leap.
double	getLeap()	Get the value of the leap at offset validity start (in seconds).
int	getMJD()	Get the date of the start of the leap as Modified Julian Day.
double	getOffset(AbsoluteDate date)	Get the TAI - UTC offset in seconds.
double	getOffset(DateComponents date, TimeComponents time)	Get the TAI - UTC offset in seconds.
<T extends CalculusFieldElement<T>> T	getOffset(FieldAbsoluteDate<T> date)	Get the TAI - UTC offset in seconds.
AbsoluteDate	getValidityStart()	Get the start time of validity for this offset.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.orekit.time.TimeStamped

durationFrom

Method Detail

getDate

public AbsoluteDate getDate()

Get the date of the start of the leap.

Specified by:

getDate in interface TimeStamped

Returns:

date of the start of the leap

See Also:

getValidityStart()

getMJD

public int getMJD()

Get the date of the start of the leap as Modified Julian Day.

Returns:

date of the start of the leap as Modified Julian Day

getValidityStart

public AbsoluteDate getValidityStart()

Get the start time of validity for this offset.

The start of the validity of the offset is getLeap() seconds after the start of the leap itself.

Returns:

start of validity date

See Also:

getDate()

getLeap

public double getLeap()

Get the value of the leap at offset validity start (in seconds).

Returns:

value of the leap at offset validity start (in seconds)

getOffset

public double getOffset(AbsoluteDate date)

Get the TAI - UTC offset in seconds.

Parameters:

date - date at which the offset is requested

Returns:

TAI - UTC offset in seconds.

getOffset

public <T extends CalculusFieldElement<T>> T getOffset(FieldAbsoluteDate<T> date)

Get the TAI - UTC offset in seconds.

Type Parameters:

T - type of the filed elements

Parameters:

date - date at which the offset is requested

Returns:

TAI - UTC offset in seconds.

Since:

9.0

getOffset

public double getOffset(DateComponents date,
                        TimeComponents time)

Get the TAI - UTC offset in seconds.

Parameters:

date - date components (in UTC) at which the offset is requested

time - time components (in UTC) at which the offset is requested

Returns:

TAI - UTC offset in seconds.