home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / gnu / shellutils-1.9.4-bin.lha / man / cat1 / date.0 < prev    next >
Text File  |  1993-12-07  |  4KB  |  199 lines
  1.  
  2.  
  3.  
  4. DATE(1L)                                                 DATE(1L)
  5.  
  6.  
  7. NNAAMMEE
  8.        date - print or set the system date and time
  9.  
  10. SSYYNNOOPPSSIISS
  11.        ddaattee  [-u]  [-d  datestr]  [-s  datestr]  [+FORMAT]  [MMD-
  12.        Dhhmm[[CC]YY][.ss]]
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        This manual page documents the GNU version of ddaattee.   ddaattee
  16.        with no arguments prints the current time and date (in the
  17.        format of the `%c' directive described below).   If  given
  18.        an  argument that starts with a `+', it prints the current
  19.        time and date in a format  controlled  by  that  argument,
  20.        which  has  the same format as the format string passed to
  21.        the `strftime' function.  Except for directives that start
  22.        with `%', characters in that string are printed unchanged.
  23.  
  24.        The directives are:
  25.  
  26.        %      a literal %
  27.  
  28.        n      a newline
  29.  
  30.        t      a horizontal tab
  31.  
  32.        Time fields:
  33.  
  34.        %H     hour (00..23)
  35.  
  36.        %I     hour (01..12)
  37.  
  38.        %k     hour ( 0..23)
  39.  
  40.        %l     hour ( 1..12)
  41.  
  42.        %M     minute (00..59)
  43.  
  44.        %p     locale's AM or PM
  45.  
  46.        %r     time, 12-hour (hh:mm:ss [AP]M)
  47.  
  48.        %S     second (00..61)
  49.  
  50.        %T     time, 24-hour (hh:mm:ss)
  51.  
  52.        %X     locale's time representation (%H:%M:%S)
  53.  
  54.        %Z     time zone (e.g., EDT), or nothing if no  time  zone
  55.               is determinable
  56.  
  57.        Date fields:
  58.  
  59.        %a     locale's abbreviated weekday name (Sun..Sat)
  60.  
  61.  
  62.  
  63.  
  64.                                                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DATE(1L)                                                 DATE(1L)
  71.  
  72.  
  73.        %A     locale's  full  weekday name, variable length (Sun-
  74.               day..Saturday)
  75.  
  76.        %b     locale's abbreviated month name (Jan..Dec)
  77.  
  78.        %B     locale's full month  name,  variable  length  (Jan-
  79.               uary..December)
  80.  
  81.        %c     locale's  date  and  time  (Sat Nov 04 12:02:33 EST
  82.               1989)
  83.  
  84.        %d     day of month (01..31)
  85.  
  86.        %D     date (mm/dd/yy)
  87.  
  88.        %h     same as %b
  89.  
  90.        %j     day of year (001..366)
  91.  
  92.        %m     month (01..12)
  93.  
  94.        %U     week number of year with Sunday  as  first  day  of
  95.               week (00..53)
  96.  
  97.        %w     day of week (0..6)
  98.  
  99.        %W     week  number  of  year  with Monday as first day of
  100.               week (00..53)
  101.  
  102.        %x     locale's date representation (mm/dd/yy)
  103.  
  104.        %y     last two digits of year (00..99)
  105.  
  106.        %Y     year (1970...)
  107.  
  108.        If given an argument that does not start  with  `+',  ddaattee
  109.        sets  the  system  clock to the time and date specified by
  110.        that argument.  The argument must consist entirely of dig-
  111.        its, which have the following meaning:
  112.  
  113.        MM     month
  114.  
  115.        DD     day within month
  116.  
  117.        hh     hour
  118.  
  119.        mm     minute
  120.  
  121.        CC     first two digits of year (optional)
  122.  
  123.        YY     last two digits of year (optional)
  124.  
  125.        ss     second (optional)
  126.  
  127.  
  128.  
  129.  
  130.                                                                 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. DATE(1L)                                                 DATE(1L)
  137.  
  138.  
  139.        Only the superuser can set the system clock.
  140.  
  141.    OOPPTTIIOONNSS
  142.        _-_d _d_a_t_e_s_t_r
  143.               Display  the  time  and  date specified in _d_a_t_e_s_t_r,
  144.               which can be in almost any common format.  The dis-
  145.               play  is  in  the  default  output format, or if an
  146.               argument starting with `+' is given to ddaattee, in the
  147.               format specified by that argument.
  148.  
  149.        _-_s _d_a_t_e_s_t_r
  150.               Set  the  time and date to _d_a_t_e_s_t_r, which can be in
  151.               almost any common format.   It  can  contain  month
  152.               names, timezones, `am' and `pm', etc.
  153.  
  154.        _-_u     Print or set the time and date in Universal Coordi-
  155.               nated Time (also  known  as  Greenwich  Mean  Time)
  156.               instead of in local (wall clock) time.
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                                                 3
  197.  
  198.  
  199.