CDF_PARSE_EPOCH16
-----------------

The CDF_PARSE_EPOCH16 function parses a single or an array of properly-formatted
input string(s) into a single or an array of double complex value(s) properly
formatted for use as a CDF_EPOCH16 variable.  CDF_EPOCH16 variables may be
encoded into a variety of formats using the CDF_ENCODE_EPOCH16 function or
decomposed into date/time components using CDF_EPOCH16, /BREAKDOWN_EPOCH
function. 

Syntax 
  Result = CDF_PARSE_EPOCH16(Epoch_string) 

Return Value 
  Returns a single or an array (<= 2D) of double-complex value(s) of the input
  string. 

Arguments 
  Epoch_string    A scalar or an array (<= 2D) formatted string that will be
                  parsed into a double-complex value(s) suitable to be used as
                  a CDF_EPOCH16 value(s). The format expected by
                  CDF_PARSE_EPOCH16 is dd-mmm-yyyy hh:mm:ss.ccc.uuu.nnn.ppp
                  where: 

                    dd is the day of the month, 1-31.
                    mmm is the month, Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, 
                       Sep, Oct, Nov, or Dec.
                    yyyy is the year, A.D.
                    hh is the hour, 0-23.
                    mm is the minute, 0-59.
                    ss is the second, 0-60 if leap second.
                    ccc is the millisecond, 0-999.
                    uuu is the microsecond, 0-999.
                    nnn is the nanosecond, 0-999.
                    ppp is the picosecond, 0-999.


Keywords 
  None. 

Examples 
  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 Output 
  TEST_STRING     STRING    = '04-Dec-1995 20:19:18.176' 
  TEST_EPOCH      DCOMPLEX  =    6.2985328e+13 
 
  04-Dec-2005 20:19:18.176.214.648.000
  2005 12 4 20 19 18 176 214 648 000

Version History 
  Introduced: CDF 3.4.0

See Also 
  CDF_ENCODE_EPOCH16, CDF_EPOCH16