CDF_ENCODE_EPOCH16
------------------

The CDF_ENCODE_EPOCH16 function encodes a single or an array of CDF_EPOCH16
value(s) into the standard date and time character string(s).  The default
format of the string 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, Dec), yyyy is the year, 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), and
ppp is the picosecond (0-999).

Syntax 
  Result = CDF_ENCODE_EPOCH16(Epoch16 [, EPOCH={0 | 1 | 2 | 3}]) 

Return Value 
  Returns the string(s) representation of the given CDF_EPOCH16 value(s). 

Arguments 
  Epoch16    A scalar or an array (<= 2D) CDF_EPOCH16 value(s). 


Keywords 
  EPOCH=<epoch_mode>, where the default epoch_mode is 0.

  EPOCH=0 : returns a date in 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), and
              ppp is the picosecond (0-999).

  EPOCH=1 : returns a date in yyyymmdd.ttttttttttttttt where 
              yyyy is the year,
              mm is the month (1-12),
              dd is the day of the month (1-31), and 
              ttttttttttttttt is the fraction of the day (e.g. 500000000000000 
                 is 12 'oclock noon).

  EPOCH=2 : returns a date in yyyymmddss where
              yyyy is the year,
              mm is the month (1-12),
              dd is the day of the month (1-31), and 
              ss is the second (0-59).
  
  EPOCH=3 : returns a date in yyyy-mm-ddThh:mm:ss.ccc.uuu.nnn.pppZ
              yyyy is the year, 
              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-60 if leap second),
              ccc is the millisecond (0-999),
              uuu is the microsecond (0-999),
              nnn is the nanosecond (0-999), and
              ppp is the picosecond (0-999).


Examples 
  test_string = '04-Dec-2005 20:19:18.176.214.648.000' 
  test_epoch = CDF_PARSE_EPOCH16(test_string) 
  PRINT, CDF_ENCODE_EPOCH16(test_epoch)

IDL Output 
  04-Dec-2005 20:19:18.176.214.648.000

Version History 
  Introduced: CDF 3.4.0

See Also 
  CDF_PARSE_EPOCH16, CDF_EPOCH16