The CDF_ENCODE_TT2000 function encodes a single value or an array of CDF_TIME_TT2000 value(s) into the standard date and time character string(s), including possible leap seconds. The default format of the string is ISO 8601 format:
yyyy-mm-ddThh:mm:ss.cccuuunnn
Tip: See the CDF_LEAPSECONDS_INFO routine for up-to-date info on current leap seconds.
Examples
epoch_string = '2005-12-04T20:19:18.176321123'
epoch = CDF_PARSE_TT2000(epoch_string)
PRINT, CDF_ENCODE_TT2000(epoch)
CDF_TT2000, epoch2, 2005, 12, 4, 20, 19, 18, 176, 321, /compute
PRINT, CDF_ENCODE_TT2000(epoch2, epoch=0)
IDL Output
2005-12-04T20:19:18.176321123
04-Dec-2005 20:19:18.176321123
Syntax
Result = CDF_ENCODE_TT2000(Epoch [, EPOCH={0 | 1 | 2 | 3}] )
Return Value
Returns a string containing the CDF_TIME_TT2000 values.
Arguments
Epoch
A scalar or an array (<=2D) of CDF_TIME_TT2000 values.
Keywords
EPOCH
Set this keyword equal to one of the following values, specifying the epoch mode to use for the output:
Value |
Date Format |
0 |
DD-MM-YYYY hh:mm:ss.ccccccccc
(This is the default)
|
1 |
YYYYMMDD.ttttttt
|
2 |
YYYYMMDDss
|
3 |
YYYY-MM-DDThh:mm:ss.ccccccccc
( T is a CDF_EPOCH type 3 placeholder)
|
where:
Date Element |
Represents |
DD
|
the day of the month (1-31)
|
MM
|
the month number (1-12)
|
YYYY
|
the year (A.D.) |
hh
|
the hour (0-23) |
mm
|
the minute (0-59)
|
ss
|
the second (0-59) (60 for leap seconds)
|
ccccccccc
|
the millisecond (0-999), microsecond (000-999) and nanosecond (000-999)
|
ttttttt
|
the fraction of the day (e.g. 2500000 is 6 am).
|
Version History
See Also
CDF_PARSE_TT2000, CDF_TT2000, CDF_LEAPSECONDS_INFO