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

Procedure
Abstract
Required_Reading
Keywords
Brief_I/O
Detailed_Input
Detailed_Output
Parameters
Exceptions
Files
Particulars
Examples
Restrictions
Literature_References
Author_and_Institution
Version
Index_Entries

Procedure

   void tsetyr_c ( SpiceInt year )

Abstract

  Set the lower bound on the 100 year range

Required_Reading

   None.

Keywords

   TIME


Brief_I/O

   VARIABLE  I/O  DESCRIPTION
   --------  ---  --------------------------------------------------
   year       I   Lower bound on the 100 year interval of expansion

Detailed_Input

   year       is the year associated with the lower bound on all
              year expansions computed by texpyr_.  For example
              if year is 1980, then the range of years that
              can be abbreviated is from 1980 to 2079.

Detailed_Output

   None.

Parameters

   None.

Exceptions

   Error free.

   1) If year is less than 1 no action is taken

Files

   None.

Particulars

   This routine allows all of the SPICE time subsystem to handle
   uniformly the expansion of "abbreviated" years.  (i.e. the
   remainder after dividing the actual year by 100).  The input
   supplied to this routine represents the lower bound of the
   expansion interval.  The upper bound of the expansion interval
   is year + 99.

   The default expansion interval is from 1969 to 2068.

   The default behavior is as follows

   year input      year Output
   ----------      -----------
   00              2000
   01              2001
    .                .
    .                .
    .                .
   67              2067
   68              2068
   69              1969
   70              1970
    .                .
    .                .
    .                .
   99              1999

Examples

   Suppose that you need to manipulate time strings and that
   you want to treat years components in the range from 0 to 99
   as being abbreviations for years in the range from
   1980 to 2079 (provided that the years are not modified by
   an ERA substring).  The code fragment below shows how you
   could go about this.

      Early in your application set up the lower bound for the
      expansion of abbreviated years.

      tsetyr_c ( 1980 );

   year input      year Output
   ----------      -----------
   00              2000
   01              2001
    .                .
    .                .
    .                .
   48              2048
   49              2049
    .                .
    .                .
    .                .
   79              2079
   80              1980
    .                .
   99              1999

Restrictions

   None.

Literature_References

   None.

Author_and_Institution

   W.L. Taber      (JPL)
   E.D. Wright     (JPL)

Version

   -CSPICE Version 1.0.0, 11-FEB-1998   (EDW)

Index_Entries

   Set the interval of expansion for abbreviated years

Link to routine tsetyr_c source file tsetyr_c.c

Wed Apr  5 17:54:46 2017