home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 635.lha / DiffTime / DiffTime.doc < prev    next >
Encoding:
Text File  |  1992-02-22  |  2.4 KB  |  62 lines
  1.      
  2.      DIFFTIME(1)          Amiga User's Manual             DIFFTIME(1)
  3.      
  4.      NAME
  5.           dur - calculate time differential between two times  
  6.      
  7.      SYNOPSIS
  8.          dur time1 [time2]
  9.          dur "Sun Sep 29 10:20:30 CST 1991" "Sun Sep 14 11:12:13 1990"
  10.           dur "Sun Sep 14"
  11.      
  12.             Note that quotation marks are needed where the time
  13.          includes blanks!
  14.  
  15.      DESCRIPTION
  16.           Dur is used to calculate the difference in time between two
  17.           dates given in the same format as that used by the date     
  18.           command.  If the second parameter is not supplied, the  
  19.           current system time is assumed.  The time duration is 
  20.           provided in a fixed field output, containing the years, days,
  21.            hours, minutes, and seconds of duration.
  22.  
  23.       Times given must be in system format, with the exception that
  24.       timezone information is optional, and ignored if supplied.
  25.       Time differential is always reported as the absolute positive
  26.       difference.  Times supplied must be valid system times, ie:
  27.       there is no provision for times not understood by the date
  28.       command, such as dates BC.  If a year is not supplied, the
  29.       current year is assumed.  If a time is not supplied, 00:00:01
  30.       is assumed.  Thus, dur "Sun Sep 29" "Mon Sep 30" is valid.
  31.           The Day of Week field is ignored, and may be specified as ???.
  32.       Time fields may be overloaded, in order to make projections
  33.       easier.  As an example, ??? Oct 51 00:00:00 1991 is valid and
  34.       is assumed to mean Nov 21.  All month lengths and leap years
  35.       are fully considered and significant.
  36.      
  37.      FILES
  38.           difftime - program executable
  39.      
  40.      SEE ALSO
  41.           date(1), asctime(1), localtime(1), ctime(1)
  42.      
  43.      BUGS
  44.      All times provided are converted back into system internal 
  45.      times using the mktime() function, and therefore must be
  46.      valid in the context of the system (see date(1)).  
  47.      A single year is considered to be a unit of 365 days, so that
  48.      leap years are computed correctly.  As an example, the 
  49.      difference between Oct 31, 1991 and Oct 31, 1992 is 1 year
  50.      and 1 day (see your local dictionary).
  51.      
  52.      DIAGNOSTICS
  53.      A usage summary is displayed in the absence of correct input
  54.      values.  It is sent to the standard error stream.
  55.      
  56.      COMPATIBILITY
  57.      Fully compatible with all systems implementing the full ANSI
  58.      library set.  
  59.      
  60.      AUTHOR
  61.           David Plummer   plummer@hercules.cs.uregina.ca   
  62.