|Global DRMS-module pointer that refers to module_args. |
|Global DRMS-module structure representing the default command-line arguments for a DRMS module. |
time_convert -h time_convert s=<secondsJSOC> | sdo=<secondsSDO> | egse=<secondsEGSE> | time=<calenderTime> | ord=<ordinalDate> [o=jsoc | o=sdo | o=egse | o=ord | o=cal] [zone=<zone>] [p=<precision>]
Ordinal date, and
SDO timeis the number of seconds that have elapsed since January 1, 1958 TAI, i.e. SDO onboard time. The full format is the string representation of a double data type.
EGSE timeis the number of seconds that have elapsed since APPROXIMATELY January 1, 2004 UTC (actual epoch is 2003.12.30_23:59:36.000_UTC). The full format is also the string representation of a double data type.
Ordinal dateis the day number of the year (starting at day 1 on January 1). The full format is YYYY.DDD[_ZZZ], where YYYY is the year, DDD is the day number, and ZZZ is the zone (e.g., UTC, TDT, PDT, etc.).
Calendar timegives the year, month, date, hour, minutes, and seconds for a given system of time (like UTC). The full format is specified in
JSOC TN 07-001(http://jsoc.stanford.edu/doc/timerep.html), but in short it looks like:
The precision of the seconds field is specified with the
p parameter. The default is 0. Setting p=3 will produce output identical to the original version of time_convert.
Alternatively, and with the appropriate command-line parameters, time_convert converts from any supported time representation to any other representation.
If multiple input format strings are specified as arguments (e.g., time_convert s=234235235.35 ord=1982.035), only one will be used. A descriptive string will be printed describing which input string was used. Given a definitive input format, time_convert chooses a default output format. If the input is an internal time, an SDO time, an EGSE time, or an ordinal date, the default output is a calendar time. If the definitive input format is a calendar time, the default output is an internal time. The default output format can be overwritten by providing the o=format argument.
When the output format is either an ordinal time or a calendar time, the time can be expressed in any of several supported time systems (e.g., UTC, TDT, TAI, or even a time zone, like PDT). This is accomplished by supplying the appropriate zone=system argument. Refer to
JSOC TN 07-001 (http://jsoc.stanford.edu/doc/timerep.html) for a complete list of the supported "zones".
The default time format is with no fractions of seconds. If o=jsoc is specified the seconds are provided to the nearest ms.
-h: Show usage message.
|s||An input time formatted as an internal time. <secondsJSOC> is seconds since 15 seconds before January 1, 1977 UTC.|
|sdo||An input time formatted as an SDO time. <secondsSDO> is seconds since January 1, 1958 TAI.|
|egse||An input time formatted as an EGSE time. <secondsEGSE> is seconds since 2003.12.30_23:59:36.000_UTC|
|time||An input time formatted as a calendar time. <calenderTime> is as specified in |
|ord||An input time formatted as an ordinal date. <ordinalDate> is yyyy.ddd[_zone], where zone is any supported time system as specified in |
|o||The output format to be used. "jsoc" refers to internal time; "sdo" refers to SDO time; "egse" refers to EGSE time; "ord" refers to ordinal date; and "cal" refers to calendar time.|
time_convert s=234253535.23 zone=TAI
time_convert s=234253535.23 o=egse
time_convert egse=232533636.362 o=cal zone=PDT
time_convert ord=2007.352 o=cal zone=TDT
time_convert time=1998.02.04_06:00:17.230_UTC o=jsoc
time_convert time=1998.02.04_06:00:17.230_UTC o=sdo