Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


Harris Geospatial / Docs Center / IDL Reference / I/O - CDF / CDF_PARSE_TT2000

CDF_PARSE_TT2000

CDF_PARSE_TT2000

The CDF_PARSE_TT2000 function parses a single or an array of input strings into an 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_EPOCH function or decomposed into date/time components using CDF_TT2000, /BREAKDOWN_EPOCH function.

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    = '2005-12-04T20:19:18.176214648'
TEST_EPOCH      LONG64    =     186999622360214648
2005-12-04T20:19:18.176214648
2005.0000       12.000000       4.0000000       20.000000       19.000000       18.000000       176.00000       214.00000
648.00000

Syntax


Result = CDF_PARSE_TT2000(Epoch_string)

Return Value


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

Arguments


Epoch_string

A formatted string that is parsed into a double precision value to be used as a CDF_TIME_TT2000 data type. The format can be one of the predefined formats.

The default format expected by CDF_PARSE_TT2000 is:

yyyy-MM-DDThh:mm:ss.cccuuunnn

where:

Date Element

Represents

YYYY

the year (A.D.)

MM

the month number (1-12)

DD

the day of the month (1-31)

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)

Note: T is a CDF_EPOCH type 3 placeholder. For more information about CDF_EPOCH values, see “Data Types” in the CDF User’s Guide.

Keywords


None

Version History


CDF 3.4.0

Introduced

See Also


CDF_ENCODE_TT2000, CDF_TT2000



© 2018 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us