Example

   The following example scales a relative time, computes its
   absolute value, and prints the result.

   utc_t       relutc, scaledutc;
   char        timstr[UTC_MAX_STR_LEN];

   /*
    *   Make sure relative timestamp represents a positive interval...
    */

   utc_abstime(&relutc,            /* Out: Abs-value of rel time  */
               &relutc);           /* In:  Relative time to scale */

   /*
    *   Scale it by a factor of 17...
    */

   utc_multime(&scaledutc,         /* Out: Scaled relative time   */
               &relutc,            /* In:  Relative time to scale */
               17L);               /* In:  Scale factor           */

   utc_ascreltime(timstr,          /* Out: ASCII relative time    */
                  UTC_MAX_STR_LEN, /* In:  Length of input string */
                  &scaledutc);     /* In:  Relative time to       */
                                   /*      convert                */

   printf("%s\n",timstr);

   /*
    *   Scale it by a factor of 17.65...
    */

   utc_mulftime(&scaledutc,        /* Out: Scaled relative time   */
                &relutc,           /* In:  Relative time to scale */
                17.65);            /* In:  Scale factor           */

   utc_ascreltime(timstr,          /* Out: ASCII relative time    */
                  UTC_MAX_STR_LEN, /* In:  Length of input string */
                  &scaledutc);     /* In:  Relative time to       */
                                   /*      convert                */

   printf("%s\n",timstr);