CDF_PARSE_EPOCH16

Scientific Data Formats: Common Data Format

CDF_PARSE_EPOCH16

The CDF_PARSE_EPOCH16 function parses a properly-formatted input string into a double-complex value properly formatted for use as a CDF_EPOCH16 variable.

Note
CDF_EPOCH16 variables may be unparsed into a variety of formats using the CDF_ENCODE_EPOCH16 or CDF_EPOCH16 functions.

Syntax

Result = CDF_PARSE_EPOCH16(Epoch_string)

Return Value

Returns the double-precision complex value of the input string properly formatted for use as a CDF_EPOCH16 variable.

Arguments

Epoch_string

A formatted string that will be parsed into a double precision complex value suitable to be used as a CDF_EPOCH value. The format of the date string is:

DD-Mon-YYYY hh:mm:ss.ccc.uuu.nnn.ppp

where:


Date Element	Represents
`DD`	the day of the month (1-31)
`Mon`	the abbreviated month name: (`Jan`, `Feb`, `Mar`, `Apr`, `May`, `Jun`, `Jul`, `Aug`, `Sep`, `Oct`, `Nov`, or `Dec`)
`YYYY`	the year (A.D.)
`hh`	the hour (0-23)
`mm`	the minute (0-59)
`ss`	the second (0-59)
`ccc`	the millisecond (0-999)
`uuu`	the microsecond (0-999)
`nnn`	the nanosecond (0-999)
`ppp`	the picosecond (0-999)

Keywords

None

Example

test_string = '04-Dec-2005 20:19:18.176.214.648.000'   
test_epoch = CDF_PARSE_EPOCH16(test_string)   
CDF_EPOCH16, test_epoch, year, month, day, hour, min, sec, $  
   milli, micro, nano, pico, /BREAKDOWN_EPOCH  
HELP, test_string, test_epoch   
PRINT, CDF_ENCODE_EPOCH16(test_epoch)  
PRINT, year, month, day, hour, min, sec, milli, micro, nano, pico

IDL Prints:

TEST_STRING     STRING    = '04-Dec-2005 20:19:18.176.214.648.000'  
TEST_EPOCH      DCOMPLEX  = (   6.3300947e+10,   1.7621465e+11)  
  
04-Dec-2005 20:19:18.176.214.648.000  
2005  12  4  20  19  18  176  214  648  0

Version History


6.3	Introduced