home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / qutil2.zip / qdate.doc < prev    next >
Text File  |  1993-04-17  |  2KB  |  78 lines
  1.  
  2.  
  3.                        QDATE (OS/2) - 1.00
  4.                           Documentation
  5.  
  6.     Copyright 1992-1993, Thomas G. Harold, All Rights Reserved.
  7.  
  8.  
  9.     QDATE [-filename] [+"format"]
  10.         -filename - Appends output to a file.
  11.         +"format" - Format string for time values.
  12.  
  13.     QDATE is part of the QUTIL2 utilities package and may not be 
  14. distributed seperately.
  15.     QDATE works much like the *nix "date" command with the
  16. addition of the ability to redirect its output to a file.  Some
  17. codes may not work exactly like the *nix "date" command's do,
  18. and the character '!' is used instead of '%'.
  19.  
  20. -----------------------------------------------------------------
  21.  
  22. I.  Installation:
  23.  
  24.     Copy the qdate.exe file to a directory in your PATH statement.
  25. The TZ environment variable should also be set in your AUTOEXEC.BAT
  26. so that QDATE knows how your local time compares to Greenwich
  27. Mean Time.  The TZ string consists of a 3 letter time zone name
  28. followed by an integer defining the difference in hours between
  29. Greenwich Mean Time and your local time.  Although this will not 
  30. have an effect on the reported time, it will correct what the "!Z" 
  31. format command prints.
  32.  
  33. Some examples are:
  34.  
  35.     set TZ=EST5                 - Eastern Standard Time Zone
  36.     set TZ=EST5EDT              - Eastern Daylight Savings Time Zone
  37.     set TZ=CST6                 - Central Standard Time Zone
  38.     set TZ=CST6CDT              - Central Daylight Savings Time Zone
  39.     set TZ=MST7                 - Mountain Standard Time Zone
  40.     set TZ=MST7MDT              - Mountain Daylight Savings Time Zone
  41.     set TZ=PST8                 - Pacific Standard Time Zone
  42.     set TZ=PST8PDT              - Pacific Daylight Savings Time Zone
  43.  
  44. II. Usage:
  45.  
  46.     QDATE defaults to printing the current date and time in the
  47. following format:
  48.  
  49.     Mon Oct 19 03:22:04 EDT 1992
  50.  
  51.     Other formats may be specified by using the +"format" 
  52. argument.  For example:
  53.  
  54.     QDATE +"!y!m!d Shutdown"
  55.  
  56.         921019 Shutdown
  57.  
  58.     QDATE +"!a !b !d !H:!M:!S !Z !Y"
  59.  
  60.         Mon Oct 19 03:22:04 EDT 1992
  61.  
  62.     A full list of the format commands may be obtained by entering
  63. the command:
  64.  
  65.     QDATE -?
  66.  
  67. -----------------------------------------------------------------
  68.  
  69. History:
  70.  
  71.         1.00    Oct 1992
  72.             Original version.
  73.  
  74.         1.00    Apr 1993
  75.             Original OS/2 port.
  76.             
  77.  
  78.