home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c019 / 1.ddi / ARC521_C / LIBTWS.DOC < prev    next >
Encoding:
Text File  |  1988-08-01  |  3.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      llliiibbbtttwwwsss(((333)))          UUUNNNIIIXXX 555...000 (((000888 NNNooovvveeemmmbbbeeerrr 111999888666)))          llliiibbbtttwwwsss(((333)))
  5.  
  6.  
  7.  
  8.      NNNAAAMMMEEE
  9.           libtws - alternate date and time routines including parsing
  10.  
  11.      SSSYYYNNNOOOPPPSSSIIISSS
  12.           include "tws.h"
  13.  
  14.           struct tws *dlocaltime( clock );   /* local clock into tws */
  15.           long *clock;
  16.  
  17.           struct tws *gmtime( clock );       /* GMT clock into tws */
  18.           long *clock;
  19.  
  20.           char *dtime( clock );              /* clock into string */
  21.           long *clock;
  22.  
  23.           long twclock( t );                 /* tws into clock */
  24.           struct tws *t;
  25.  
  26.           long twjuliandate( t );            /* tws into Julian day number */
  27.           struct tws *t;
  28.  
  29.           struct tws *dparsetime( str );     /* string into tws */
  30.           char *str;
  31.  
  32.           char *dctime( t );                 /* tws into string */
  33.           struct tws *t;
  34.  
  35.           char *dasctime( t, flags );        /* tws into string */
  36.           struct tws *t;
  37.           int flags;
  38.  
  39.           char *dtimezone( offset, flags );  /* timezone into string */
  40.           int offset, flags;
  41.  
  42.           char *dtwszone( t );               /* tws's timezone into string */
  43.           struct tws *t;
  44.  
  45.           char *dtimemow( );                 /* current time into string */
  46.  
  47.           struct tws *dtwstime( );           /* current time into tws */
  48.  
  49.           void twscopy( tot, fromt );        /* copy a tws */
  50.           struct tws *tot, *fromt;
  51.  
  52.           int twsort( t1, t2 );              /* compare two tws's */
  53.           struct tws *t1, *t2;
  54.  
  55.           long twsubtract( t1, t2 );         /* seconds between t2 and t1 */
  56.           struct tws *t1, *t2;
  57.  
  58.      DDDEEESSSCCCRRRIIIPPPTTTIIIOOONNN
  59.           _L_i_b_t_w_s is a fairly complete date/time library.  Unlike the
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 8/1/88)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      llliiibbbtttwwwsss(((333)))          UUUNNNIIIXXX 555...000 (((000888 NNNooovvveeemmmbbbeeerrr 111999888666)))          llliiibbbtttwwwsss(((333)))
  71.  
  72.  
  73.  
  74.           standard Unix* date/time routines, _l_i_b_t_w_s will parse
  75.           date/time strings into internal form.  The format for
  76.           specifying date/time strings is pretty loose - basically the
  77.           same as the format for date/times in network mail.
  78.  
  79.           Most of the routines do not use the Unix* "clock" time
  80.           format, and therefore are not limited to dates after 01
  81.           January 1970.  In particular, twsubtract() lets you subtract
  82.           two dates without converting them to "clock" form.
  83.  
  84.      SSSEEEEEE AAALLLSSSOOO
  85.           _c_t_i_m_e(_3), _t_i_m_e(_3)
  86.  
  87.      AAAUUUTTTHHHOOORRR
  88.           Most of _l_i_b_t_w_s came from version 6.5 of the MH message
  89.           handling system, courtesy of Marshall Rose.  Some
  90.           improvements (?) were added by Jef Poskanzer.
  91.  
  92.      BBBUUUGGGSSS
  93.           The return values point to static data whose contents are
  94.           overwritten by the next call.
  95.  
  96.           The basic Unix* time format (clock) only goes back to 1970,
  97.           limiting applications somewhat.
  98.  
  99.      NNNOOOTTTEEE
  100.           * Unix is a virus from outer space.
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 8/1/88)
  130.  
  131.  
  132.  
  133.