org.lsst.ccs.utilities.taitime

Class CCSTimeStamp

java.lang.Object

org.lsst.ccs.utilities.taitime.CCSTimeStamp

All Implemented Interfaces:

Serializable

public class CCSTimeStamp
extends Object
implements Serializable

This class represents a CCS timestamp, which encapsulates both a TAI and UTC timestamp. If we are running in strict mode, both the TAI and UTC time are obtained by appropriate kernel routine calls, and if the kernel interface library cannot be loaded, or if the the kernel is not correctly configured, then the class will throw an exception. In non-strict mode. if the kernel libraries cannot be loaded the class will fall back to using the built-in Java time, plus a list of leap seconds read from an external URL.

The following system properties control how the class works:

Property	Default	Description
org.lsst.ccs.utilities.taitime.useStrict	false	Controls whether strict mode is set or not
org.lsst.ccs.utilities.taitime.libName	timeaccess	The name of the JNI library to load
org.lsst.ccs.utilities.taitime.minLeapSeconds	30	The minimum number of leap seconds for the kernel to be considered configured correctly

Author:

Farrukh Azfar

See Also:

Serialized Form

Method Summary

Modifier and Type	Method and Description
static CCSTimeStamp	currentTime() Attempts to get the current timestamp.
static CCSTimeStamp	currentTimeFromMillis(long milliseconds) Attempts to create a CCSTimeStamp from a utc milliseconds value.
boolean	equals(Object obj)
double	getTAIDouble()
Instant	getTAIInstant()
double	getUTCDouble()
Instant	getUTCInstant()
int	hashCode()

Methods inherited from class java.lang.Object

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

Method Detail

currentTime

public static CCSTimeStamp currentTime()

Attempts to get the current timestamp. If we are in strict mode, and the kernel library cannot be loaded, or the leap seconds offset does not seem reasonable, an exception will be thrown.

Returns:

A CCSTimeStamp for the current time

Throws:

RuntimeException - If the TAI time offset is not available.

currentTimeFromMillis

public static CCSTimeStamp currentTimeFromMillis(long milliseconds)

Attempts to create a CCSTimeStamp from a utc milliseconds value. This is a temporary method to allow migrating from old java time based milliseconds values to CCSTimeStamp.

Parameters:

milliseconds - A standard Java milliseconds values (as returned by System.currentTimeMills())

Returns:

A CCSTimeStamp corresponding to the given timestamp.

getTAIInstant

public Instant getTAIInstant()

getUTCInstant

public Instant getUTCInstant()

getTAIDouble

public double getTAIDouble()

getUTCDouble

public double getUTCDouble()

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object