tsetyr_c

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

    Thu Apr 16 08:59:24 2009