CDF_PARSE_TT2000
----------------

The CDF_PARSE_TT2000 function parses a single or an array of properly-formatted
input string into a 8-byte integer (LONG64) value(s) for use as a
CDF_TIME_TT2000 type variable.  CDF_TIME_TT2000 variables may be encoded into a
variety of formats using the CDF_ENCODE_TT2000 function or decomposed into
date/time components using CDF_TT2000,/BREAKDOWN_EPOCH function. 

Syntax 
  Result = CDF_PARSE_TT2000(Epoch_string) 

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

Arguments 
  Epoch_string    A scalar or an array (<= 2D) formatted string(s) that will
                  be parsed into a 8-byte value to be used as a CDF_TIME_TT2000
                  data type. The format can be one of the predefined formats.
                  However, the default expected by CDF_PARSE_TT2000 is
                  yyyy-mm-ddThh:mm:ss.cccuuunnn, a ISO 8601 form, where:

                    yyyy is the year, A.D.
                    mm is the month, 1-12.
                    dd is the day of the month, 1-31.
                    hh is the hour, 0-23.
                    mm is the minute, 0-59.
                    ss is the second, 0-59 (0-60 if leap second applicable).
                    ccc is the millisecond, 0-999.
                    uuu is the microsecond, 0-999.
                    nnn is the nanosecond, 0-999.


Keywords 
  None. 

Examples 
  test_string = '2005-12-04T20:19:18.176214648' 
  test_epoch = CDF_PARSE_TT2000(test_string) 
  CDF_TT2000,test_epoch, year, month, day, hour, min, sec, milli, $
     micro, nano,/BREAKDOWN_EPOCH
  HELP, test_string, test_epoch 
  PRINT, CDF_ENCODE_TT2000(test_epoch)
  PRINT, year, month, day, hour, min, sec, milli, micro, nano

IDL Output 
  TEST_STRING     STRING    = '1995-12-04T20:19:18.176214648' 
  TEST_EPOCH      LONG64    =     186999558176214648
 
  2005-12-04T20:19:18.176214648
         2005.000        12.000000       4.0000000       20.000000 
           19.000000     18.000000     176.00000        214.00000
          648.00000

Version History 
  Introduced: CDF 3.4.0

See Also 
  CDF_ENCODE_TT2000, CDF_TT2000