home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / tools / date.README < prev   
Encoding:
Text File  |  1996-06-23  |  8.1 KB  |  195 lines
  1. This is the NetBSD version of unix "date" ported to compile and
  2. execute under NeXTSTEP 3.3.  It also includes a quad-fat binary
  3. for those who don't want to or can't compile the source.  The
  4. NeXTSTEP version of "date" is of little value in scripts since it
  5. doesn't support the "+" option.   This version does support the
  6. "+" option, but unfortunately does so using the NeXTSTEP "strftime()"
  7. library call rather than the NetBSD system call.  The NeXTSTEP
  8. "strftime()" function is also limiting.   In fact, it's not even
  9. possible to duplicate the output of the regular "date" command with
  10. strftime which may explain why there's no "+" option.  However,
  11. it's better than nothing.
  12.  
  13. I make no guarantees that this version of date works correctly.
  14. It seems to work well enough for me, but I'm only using it to
  15. generate formatted strings containing %y%m%d.
  16.  
  17. I've hacked in support for the correct output of date when given
  18. no + option just to keep things compatible in case someone uses
  19. this date function instead of the system-supplied one.   It looked
  20. like it would be too much work to also port the NetBSD version of
  21. strftime().
  22.  
  23. Along with all of the other problems that popped up when trying to
  24. port this, I also was unable to generate a nicely formatted man
  25. page.   I'm including an SGI man page for date (since it's all I
  26. have access to) even though it's probably wrong in some areas.
  27. It's still closer to what this version of date does than what the
  28. NeXTSTEP man page outputs.   For the important stuff (what options
  29. are available for use with "+"), see the strftime (3) man page.
  30.  
  31. If anyone feels like improving this port, please do so.  Including
  32. a better version of strftime would be great.   Creating a man page
  33. from the date.1 source file would also be great.  Please send me
  34. any updates you make so I can start using them :)  It's unlikely
  35. that I'll spend any further time improving this port.
  36.  
  37. This file was originally uploaded to
  38. ftp://next-ftp.peak.org/pub/next/submissions/date-unix-0.1-NIHS.bs.tar.gz.
  39. I would expect to see it eventually migrate to
  40. ftp://next-ftp.peak.org/pub/next/sources/util/date-unix-0.1-NIHS.bs.tar.gz
  41.  
  42. -Mike Kienenberger
  43.  mkienenb@alaska.net
  44.  June 23rd, 1996
  45.  
  46. date(1)                                                                date(1)
  47.  
  48. NAME
  49.      date - print and set the date
  50.  
  51. SYNOPSIS
  52.      date [ -u ] [ + format ]
  53.      date [ -a [ - ] sss.fff ]
  54.      date [ -u | -n ] [[ mmdd]HHMM | mmddHHMM[cc]yy ] [ .ss ]
  55.  
  56. DESCRIPTION
  57.      If no argument is given, or if the argument begins with +, the current
  58.      date and time are printed.  Otherwise, the current date is set if the
  59.      user is super-user.
  60.  
  61.      Supplementary code set characters in +format (see below) are recognized
  62.      and displayed according to the locale specified in the LC_CTYPE
  63.      environment variable [see LANG on environ(5)].  Month and weekday names
  64.      are recognized according to the locale specified in the LC_TIME
  65.      environment variable, as described below.
  66.  
  67.      -a [ - ] sss.fff
  68.                  Slowly adjust the time by sss.fff seconds (fff represents
  69.                  fractions of a second).  This adjustment can be positive or
  70.                  negative.  The system's clock will be sped up or slowed down
  71.                  until it has drifted by the number of seconds specified.
  72.  
  73.      -u          Display (or set) the date in Greenwich Mean Time (GMT-
  74.                  universal time), bypassing the normal conversion to (or from)
  75.                  local time.
  76.  
  77.      mm          is the month number
  78.  
  79.      dd          is the day number in the month
  80.  
  81.      HH          is the hour number (24 hour system)
  82.  
  83.      MM          is the minute number
  84.  
  85.      ss          is the second(s) number
  86.  
  87.      cc          is the century minus one
  88.  
  89.      yy          is the last 2 digits of the year number
  90.  
  91.                  The month, day, year, and century may be omitted; the current
  92.                  values are supplied as defaults.  For example:
  93.  
  94.                        date 10080045
  95.  
  96.                  sets the date to Oct 8, 12:45 AM.  The current year is the
  97.                  default because no year is supplied.  The system operates in
  98.                  GMT.  date takes care of the conversion to and from local
  99.                  standard and daylight time.  Only super-user may change the
  100.                  date.  After successfully setting the date and time, date
  101.                  displays the new date according to the default format.  The
  102.                  date command uses TZ to determine the correct time zone
  103.                  information [see environ(5)].
  104.  
  105.      + format    If the argument begins with +, the output of date is under
  106.                  the control of the user.  Each Field Descriptor, described
  107.                  below, is preceded by % and is replaced in the output by its
  108.                  corresponding value.  A single % is encoded by %%.  All other
  109.                  characters are copied to the output without change.  The
  110.                  string is always terminated with a new-line character.  If
  111.                  the argument contains embedded blanks it must be quoted (see
  112.                  the EXAMPLE section).  Supplementary code set characters may
  113.                  be used in format.
  114.  
  115.      As noted, month and weekday names are recognized according to the locale
  116.      specified in the LC_TIME environment variable [see LANG on environ(5)].
  117.      The names are taken from a file whose format is specified in strftime(4).
  118.      This file also defines country-specific date and time formats such as %c,
  119.      which specifies the default date format.  The following form is the
  120.      default for %c:
  121.  
  122.                %a %b %e %T %Z %Y
  123.                e.g., Fri Dec 23 10:10:42 EST 1988
  124.  
  125.      Field Descriptors (must be preceded by a %):
  126.          a   abbreviated weekday name
  127.          A   full weekday name
  128.          b   abbreviated month name
  129.          B   full month name
  130.          c   country-specific date and time format
  131.          d   day of month - 01 to 31
  132.          D   date as %m/%d/%y
  133.          e   day of month - 1 to 31 (single digits are preceded by a blank)
  134.          h   abbreviated month name (alias for %b)
  135.          H   hour - 00 to 23
  136.          I   hour - 01 to 12
  137.          j   day of year - 001 to 366
  138.          m   month of year - 01 to 12
  139.          M   minute - 00 to 59
  140.          n   insert a new-line character
  141.          p   string containing ante-meridiem or post-meridiem indicator (by
  142.              default, AM or PM)
  143.          r   time as %I:%M:%S %p
  144.          R   time as %H:%M
  145.          S   second - 00 to 61, allows for leap seconds
  146.          t   insert a tab character
  147.          T   time as %H:%M:%S
  148.          U   week number of year (Sunday as the first day of the week) - 00 to
  149.              53
  150.          w   day of week - Sunday = 0
  151.          W   week number of year (Monday as the first day of the week) - 00 to
  152.              53
  153.          x   country-specific date format
  154.          X   country-specific time format
  155.          y   year within century - 00 to 99
  156.          Y   year as ccyy (4 digits)
  157.          Z   timezone name
  158.  
  159. EXAMPLE
  160.      The command
  161.  
  162.           date '+DATE: %m/%d/%y%nTIME: %H:%M:%S'
  163.  
  164.      generates as output:
  165.  
  166.           DATE: 08/01/76
  167.           TIME: 14:45:05
  168.  
  169. FILES
  170.      /usr/lib/locale/locale/LC_MESSAGES/uxcore.abi
  171.           language-specific message file [See LANG on environ (5).]
  172.  
  173. SEE ALSO
  174.      syslog(3), strftime(4), timed(1M), timeslave(1M), utmp(4), environ(5)
  175.  
  176. DIAGNOSTICS
  177.      UX:date:ERROR:No permission
  178.                        You are not super-user and you try to change the date.
  179.      UX:date:ERROR:bad conversion
  180.                        The date set is syntactically incorrect.
  181.  
  182. NOTES
  183.      If you attempt to set the current date to one of the dates on which the
  184.      standard and alternate time zones change (for example, the date that
  185.      daylight time is starting or ending), and you attempt to set the time to
  186.      a time in the interval between the end of standard time and the beginning
  187.      of the alternate time (or the end of the alternate time and the beginning
  188.      of standard time), the results are unpredictable.
  189.  
  190.      If you are running a network-based time service, such as timed, then it
  191.      will override any changes you make with the date command.
  192.  
  193.                                                                         Page 3
  194.  
  195.