vendor/tzcode/unsplit

1 files changed, 127 insertions, 0 deletions

diff --git a/date.1.txt b/date.1.txt
new file mode 100644
index 000000000000..2910aaac370c
--- /dev/null
+++ b/date.1.txt
@@ -0,0 +1,127 @@
+NAME
+
+     date - show and set date and time
+
+SYNOPSIS
+     date [ -u ] [ -c ] [ -n ] [ -d dsttype ] [ -t minutes-west ]
+     [ -a [+|-]sss.fff ] [ +format ] [ [yyyy]mmddhhmm[yy][.ss] ]
+
+DESCRIPTION
+     Date without arguments writes the date and time to the
+     standard output in the form
+                     Wed Mar  8 14:54:40 EST 1989
+     with EST replaced by the local time zone's abbreviation (or
+     by the abbreviation for the time zone specified in the TZ
+     environment variable if set).  The exact output format
+     depends on the locale.
+
+     If a command-line argument starts with a plus sign (`+'),
+     the rest of the argument is used as a format that controls
+     what appears in the output.  In the format, when a percent
+     sign (`%') appears, it and the character after it are not
+     output, but rather identify part of the date or time to be
+     output in a particular way (or identify a special character
+     to output):
+
+           Sample output                 Explanation
+       %a  Wed                           Abbreviated weekday name*
+       %A  Wednesday                     Full weekday name*
+       %b  Mar                           Abbreviated month name*
+       %B  March                         Full month name*
+       %c  Wed Mar 08 14:54:40 1989      Date and time*
+       %C  19                            Century
+       %d  08                            Day of month (always two digits)
+       %D  03/08/89                      Month/day/year (eight characters)
+       %e   8                            Day of month (leading zero blanked)
+       %h  Mar                           Abbreviated month name*
+       %H  14                            24-hour-clock hour (two digits)
+       %I  02                            12-hour-clock hour (two digits)
+       %j  067                           Julian day number (three digits)
+       %k   2                            12-hour-clock hour (leading zero blanked)
+       %l  14                            24-hour-clock hour (leading zero blanked)
+       %m  03                            Month number (two digits)
+       %M  54                            Minute (two digits)
+       %n  \n                            newline character
+       %p  PM                            AM/PM designation
+       %r  02:54:40 PM                   Hour:minute:second AM/PM designation
+       %R  14:54                         Hour:minute
+       %S  40                            Second (two digits)
+       %t  \t                            tab character
+       %T  14:54:40                      Hour:minute:second
+       %U  10                            Sunday-based week number (two digits)
+       %w  3                             Day number (one digit, Sunday is 0)
+       %W  10                            Monday-based week number (two digits)
+       %x  03/08/89                      Date*
+       %X  14:54:40                      Time*
+       %y  89                            Last two digits of year
+       %Y  1989                          Year in full
+       %Z  EST                           Time zone abbreviation
+       %+  Wed Mar  8 14:54:40 EST 1989  Default output format*
+     * The exact output depends on the locale.
+
+     If a character other than one of those shown above appears
+     after a percent sign in the format, that following character
+     is output.  All other characters in the format are copied
+     unchanged to the output; a newline character is always added
+     at the end of the output.
+     In Sunday-based week numbering, the first Sunday of the year
+     begins week 1; days preceding it are part of ``week 0.''  In
+     Monday-based week numbering, the first Monday of the year
+     begins week 1.
+
+     To set the date, use a command line argument with one of the
+     following forms:
+       1454         24-hour-clock hours (first two digits) and minutes
+       081454       Month day (first two digits), hours, and minutes
+       03081454     Month (two digits, January is 01), month day, hours, minutes
+       8903081454   Year, month, month day, hours, minutes
+       0308145489   Month, month day, hours, minutes, year
+                    (on System V-compatible systems)
+       030814541989 Month, month day, hours, minutes, four-digit year
+       198903081454 Four-digit year, month, month day, hours, minutes
+     If the century, year, month, or month day is not given, the
+     current value is used.  Any of the above forms may be
+     followed by a period and two digits that give the seconds
+     part of the new time; if no seconds are given, zero is
+     assumed.
+
+     These options are available:
+
+     -u or -c
+          Use UTC when setting and showing the date and time.
+
+     -n   Do not notify other networked systems of the time
+          change.
+
+     -d dsttype
+          Set the kernel-stored Daylight Saving Time type to the
+          given value.  (The kernel-stored DST type is used
+          mostly by ``old'' binaries.)
+
+     -t minutes-west
+          Set the kernel-stored ``minutes west of UTC'' value to
+          the one given on the command line.  (The kernel-stored
+          DST type is used mostly by ``old'' binaries.)
+
+     -a adjustment
+          Change the time forward (or backward) by the number of
+          seconds (and fractions thereof) specified in the
+          adjustment argument.  Either the seconds part or the
+          fractions part of the argument (but not both) may be
+          omitted.  On BSD-based systems, the adjustment is made
+          by changing the rate at which time advances; on System-
+          V-based systems, the adjustment is made by changing the
+          time.
+
+FILES
+     /usr/lib/locale/L/LC_TIME           description of time
+     locale L
+     /usr/local/etc/zoneinfo             time zone information
+     directory
+     /usr/local/etc/zoneinfo/localtime   local time zone file
+     /usr/local/etc/zoneinfo/posixrules  used with POSIX-style
+     TZ's
+     /usr/local/etc/zoneinfo/GMT         for UTC leap seconds
+
+     If /usr/local/etc/zoneinfo/GMT is absent, UTC leap seconds
+     are loaded from /usr/local/etc/zoneinfo/posixrules.