Index Page
cspice_etcal
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_ETCAL converts an ephemeris epoch measured in seconds past
   the epoch of J2000 to a calendar string format using a
   formal calendar free of leapseconds.

I/O


   Given:

      et   the ephemeris time(s) expressed as ephemeris seconds
           past J2000.

           [1,n] = size(et); double = class(et)

   the call:

      string = cspice_etcal(et)

   returns:

      string   the array of time string(s) representing the input ephemeris
               epoch 'et'.

               [n,c1] = size(string); char = class(string)

               This string is based upon extending the Gregorian Calendar
               backward and forward indefinitely keeping the same rules
               for determining leap years. Moreover, there is no accounting
               for leapseconds.

Examples


   Any numerical results shown for this example may differ between
   platforms as the results depend on the SPICE kernels used as input
   and the machine specific arithmetic implementation.

      %
      % Load a leapseconds kernel.
      %
      cspice_furnsh( 'standard.tm' )

      %
      % Define a UTC time string.
      %
      TIMESTR = '2013 JUN 30 00:00:00.000';

      %
      % Convert the time string to ephemeris time.
      %
      et  = cspice_str2et( TIMESTR );

      %
      % Convert the ephemeris time to a time string, the conversion
      % ignoring leapseconds. Note, this evaluation does not require
      % loading a leapsecond kernel.
      %
      cal = cspice_etcal( et );

      %
      % Display the two time strings.
      %
      disp( ['Original times string: ' TIMESTR] )
      disp( ['ETCAL time string    : ' cal    ] )

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

   MATLAB outputs:

      Original times string: 2013 JUN 30 00:00:00.000
      ETCAL time string    : 2013 JUN 30 00:01:05.184

Particulars


   None.

Required Reading


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

   MICE.REQ

Version


   -Mice Version 1.0.2, 05-NOV-2014, EDW (JPL)

       Edited I/O section to conform to NAIF standard for Mice documentation.

   -Mice Version 1.0.1, 06-MAY-2009, EDW (JPL)

      Added MICE.REQ reference to the Required Reading section.

   -Mice Version 1.0.0, 07-MAR-2007, EDW (JPL)

Index_Entries


   Convert ephemeris time to a formal calendar date


Wed Apr  5 18:00:31 2017