CDF_ENCODE_EPOCH
----------------

The CDF_ENCODE_EPOCH function encodes a single or an array of CDF_EPOCH
value(s) into the standard date and time character string(s).  The format of
the string is default as dd-mmm-yyyy hh: mm:ss.ccc 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), and ccc is the millisecond
(0-999).

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

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

Arguments 
  Epoch    A scalar or any array (<=2D) CDF_EPOCH 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 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), and
              ccc is the millisecond (0-999).

  EPOCH=1 : returns a date in yyyymmdd.ttttttt where 
              yyyy is the year,
              mm is the month (1-12),
              dd is the day of the month (1-31), and 
              ttttttt is the fraction of the day (e.g. 5000000 
                 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.cccZ
              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), and
              ccc is the millisecond (0-999).


Examples 
  test_string = '04-Dec-2005 20:19:18.176' 
  test_epoch = CDF_PARSE_EPOCH(test_string) 
  PRINT, CDF_ENCODE_EPOCH(test_epoch)

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

Version History 
  Introduced: CDF 3.4.0

See Also 
  CDF_PARSE_EPOCH, CDF_EPOCH