Index Page
cspice_unitim
A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X 

Abstract
I/O
Examples
Particulars
Required Reading
Version
Index_Entries

Abstract


   CSPICE_UNITIM returns the double precision value of an input epoch converted
   from one uniform time scale to another.

   For important details concerning this module's function, please refer to
   the CSPICE routine unitim_c.

I/O


   Given:

      epoch    a scalar double precision epoch relative to the 'insys'
               time scale.

      insys    the scalar string naming the uniform time scale of
               'epoch'. Acceptable values:

                  'TAI'     International Atomic Time.

                  'TDB'     Barycentric Dynamical Time.

                  'TDT'     Terrestrial Dynamical Time.

                  'ET'      Ephemeris time (in the SPICE system, this is
                            equivalent to TDB).

                  'JDTDB'   Julian Date relative to TDB.

                  'JDTDT'   Julian Date relative to TDT.

                  'JED'     Julian Ephemeris date (in the SPICE system
                            this is equivalent to JDTDB).

               The routine is not sensitive to the case of the
               characters in insys;  'tai' 'Tai' and 'TAI' are
               all equivalent from the point of view of this routine.

      outsys   the scalar string naming the uniform time scale to which 'epoch'
               should be converted. Acceptable values are the same as for
               'insys'.

               The routine is not sensitive to the case of 'outsys'.

   the call:

      double = cspice_unitim( epoch, insys, outsys)


   returns:

      The function returns a scalar double precision, the time in the system
      specified by 'outsys' equivalent to the 'epoch' in the 'insys' time scale.

Examples


   Convert a date from ephemeris seconds J2000 to Julian Ephemeris Date:

      cspice_str2et, 'Dec 19 2003', et

      converted_et = cspice_unitim(et, 'ET','JED')

      print, converted_et

      ;;
      ;; It's always good form to unload kernels after use,
      ;; particularly in IDL due to data persistence.
      ;;
      cspice_kclear

   IDL outputs:

      2452992.5

Particulars


   None.

Required Reading


   ICY.REQ
   TIME.REQ

Version


   -Icy Version 1.0.1, 09-MAY-2016, EDW (JPL)

      Eliminated typo in example code; no change to functionality.

   -Icy Version 1.0.2, 04-NOV-2008, EDW (JPL)

      Expanded and improved header

   -Icy Version 1.0.1, 09-DEC-2005, EDW (JPL)

      Added Examples section.

   -Icy Version 1.0.0, 16-JUN-2003, EDW (JPL)

Index_Entries


   Transform between two uniform numeric time systems
   Transform between two additive numeric time systems
   Convert one uniform numeric time system to another
   Convert one additive numeric time system to another




Wed Apr  5 17:58:04 2017