LAL  7.5.0.1-08ee4f4
Date.h File Reference

Prototypes

INT8 XLALGPSToINT8NS (const LIGOTimeGPS *epoch)
 Converts GPS time to nano seconds stored as an INT8. More...
 
LIGOTimeGPSXLALINT8NSToGPS (LIGOTimeGPS *epoch, INT8 ns)
 Converts nano seconds stored as an INT8 to GPS time. More...
 
LIGOTimeGPSXLALGPSSet (LIGOTimeGPS *epoch, INT4 gpssec, INT8 gpsnan)
 Sets GPS time given GPS integer seconds and residual nanoseconds. More...
 
LIGOTimeGPSXLALGPSSetREAL8 (LIGOTimeGPS *epoch, REAL8 t)
 Sets GPS time given GPS seconds as a REAL8. More...
 
REAL8 XLALGPSGetREAL8 (const LIGOTimeGPS *epoch)
 Returns the GPS time as a REAL8. More...
 
REAL8 XLALGPSModf (REAL8 *iptr, const LIGOTimeGPS *epoch)
 Breaks the GPS time into REAL8 integral and fractional parts, each of which has the same sign as the epoch. More...
 
LIGOTimeGPSXLALGPSAdd (LIGOTimeGPS *epoch, REAL8 dt)
 Adds a double to a GPS time. More...
 
LIGOTimeGPSXLALGPSAddGPS (LIGOTimeGPS *epoch, const LIGOTimeGPS *dt)
 Adds two GPS times. More...
 
LIGOTimeGPSXLALGPSSubGPS (LIGOTimeGPS *t1, const LIGOTimeGPS *t0)
 Difference between two GPS times. More...
 
REAL8 XLALGPSDiff (const LIGOTimeGPS *t1, const LIGOTimeGPS *t0)
 Difference between two GPS times as double. More...
 
int XLALGPSCmp (const LIGOTimeGPS *t0, const LIGOTimeGPS *t1)
 Compares two GPS times. More...
 
LIGOTimeGPSXLALGPSMultiply (LIGOTimeGPS *gps, REAL8 x)
 Multiply a GPS time by a number. More...
 
LIGOTimeGPSXLALGPSDivide (LIGOTimeGPS *gps, REAL8 x)
 Divide a GPS time by a number. More...
 
int XLALStrToGPS (LIGOTimeGPS *t, const char *nptr, char **endptr)
 Parse an ASCII string into a LIGOTimeGPS structure. More...
 
char * XLALGPSToStr (char *, const LIGOTimeGPS *t)
 Return a string containing the ASCII base 10 representation of a LIGOTimeGPS. More...
 
LIGOTimeGPSXLALGPSTimeNow (LIGOTimeGPS *gpstime)
 Populate the LIGOTimeGPS argument with the current system time as returned by time(2) converted to GPS seconds. More...
 
int XLALLeapSeconds (INT4 gpssec)
 Returns the leap seconds TAI-UTC at a given GPS second. More...
 
int XLALGPSLeapSeconds (INT4 gpssec)
 Returns the leap seconds GPS-UTC at a given GPS second. More...
 
int XLALLeapSecondsUTC (const struct tm *utc)
 Returns the leap seconds TAI-UTC for a given UTC broken down time. More...
 
struct tm * XLALFillUTC (struct tm *utc)
 Fill in derived fields, e.g. More...
 
time_t XLALSecondsSinceUnixEpoch (const struct tm *utc)
 Compute Unix epoch time: seconds since 1970 January 1 0h UTC (POSIX:2001 definition of Unix Epoch). More...
 
INT4 XLALUTCToGPS (const struct tm *utc)
 Returns the GPS seconds since the GPS epoch for a specified UTC time structure. More...
 
struct tm * XLALGPSToUTC (struct tm *utc, INT4 gpssec)
 Returns a pointer to a tm structure representing the time specified in seconds since the GPS epoch. More...
 
REAL8 XLALConvertCivilTimeToJD (const struct tm *civil)
 Returns the Julian Day (JD) corresponding to the civil date and time given in a broken down time structure. More...
 
REAL8 XLALConvertCivilTimeToMJD (const struct tm *civil)
 Returns the Modified Julian Day MJD corresponding to the civil date and time given in a broken down time structure (using the same time system as the input). More...
 
INT4 XLALModifiedJulianDay (const struct tm *utc)
 
REAL8 XLALJulianDay (const struct tm *utc)
 
REAL8 XLALGreenwichSiderealTime (const LIGOTimeGPS *gpstime, REAL8 equation_of_equinoxes)
 Returns the Greenwich Sidereal Time IN RADIANS corresponding to a specified GPS time. More...
 
REAL8 XLALGreenwichMeanSiderealTime (const LIGOTimeGPS *gpstime)
 Convenience wrapper, calling XLALGreenwichSiderealTime() with the equation of equinoxes set to 0. More...
 
LIGOTimeGPSXLALGreenwichMeanSiderealTimeToGPS (REAL8 gmst, LIGOTimeGPS *gps)
 Inverse of XLALGreenwichMeanSiderealTime(). More...
 
LIGOTimeGPSXLALGreenwichSiderealTimeToGPS (REAL8 gmst, REAL8 equation_of_equinoxes, LIGOTimeGPS *gps)
 Convenience wrapper of XLALGreenwichMeanSiderealTimeToGPS(), adjusting the input by the equation of equinoxes. More...
 

Go to the source code of this file.

Data Structures

struct  LALPlaceAndGPS
 This structure stores pointers to a LALDetector and a LIGOTimeGPS. More...
 

Macros

#define XLAL_BILLION_INT4   1000000000
 
#define XLAL_BILLION_INT8   LAL_INT8_C( 1000000000 )
 
#define XLAL_BILLION_REAL8   1e9
 
#define XLAL_EPOCH_UNIX_GPS   315964800
 The UNIX time of the GPS origin epoch. More...
 
#define XLAL_EPOCH_J2000_0_JD   2451545.0
 Julian Day (UTC) of the J2000.0 epoch (2000 JAN 1 12h UTC). More...
 
#define XLAL_EPOCH_J2000_0_TAI_UTC   32
 Leap seconds (TAI-UTC) on the J2000.0 epoch (2000 JAN 1 12h UTC). More...
 
#define XLAL_EPOCH_J2000_0_GPS   630763213
 GPS seconds of the J2000.0 epoch (2000 JAN 1 12h UTC). More...
 
#define XLAL_EPOCH_GPS_JD   2444244.5
 Julian Day (UTC) of the GPS epoch (1980 JAN 6 0h UTC) More...
 
#define XLAL_EPOCH_GPS_TAI_UTC   19
 Leap seconds (TAI-UTC) on the GPS epoch (1980 JAN 6 0h UTC) More...
 
#define XLAL_MJD_REF   2400000.5
 Reference Julian Day for Mean Julian Day. More...
 
#define XLAL_JD_TO_MJD(jd)   ((jd) - XLAL_MJD_REF)
 Modified Julian Day for specified civil time structure. More...
 
Format macros for printing LIGOTimeGPS

Example

LIGOTimeGPS t = { 1122334455, 666777888 };
printf("The time is %" LAL_GPS_FORMAT "\n", LAL_GPS_PRINT(t));
#define LAL_GPS_FORMAT
Definition: Date.h:119
#define LAL_GPS_PRINT(gps)
Definition: Date.h:120
Epoch relative to GPS epoch, see LIGOTimeGPS type for more details.
Definition: LALDatatypes.h:458
#define LAL_GPS_FORMAT   LAL_INT8_FORMAT ".%09" LAL_INT4_FORMAT
 
#define LAL_GPS_PRINT(gps)   (INT8)(XLALGPSToINT8NS(&(gps)) / XLAL_BILLION_INT8), (INT4)labs(XLALGPSToINT8NS(&(gps)) % XLAL_BILLION_INT8)
 

Macro Definition Documentation

◆ XLAL_BILLION_INT4

#define XLAL_BILLION_INT4   1000000000

Definition at line 39 of file Date.h.

◆ XLAL_BILLION_INT8

#define XLAL_BILLION_INT8   LAL_INT8_C( 1000000000 )

Definition at line 40 of file Date.h.

◆ XLAL_BILLION_REAL8

#define XLAL_BILLION_REAL8   1e9

Definition at line 41 of file Date.h.

Function Documentation

◆ XLALStrToGPS()

int XLALStrToGPS ( LIGOTimeGPS t,
const char *  nptr,
char **  endptr 
)

Parse an ASCII string into a LIGOTimeGPS structure.

Definition at line 91 of file StrToGPS.c.