mirror of
git://git.suckless.org/sbase
synced 2026-01-27 05:54:08 +00:00
a0998d0252
From ed5e4d34a16436a37c0e084666fcfb77cc4859c3 Mon Sep 17 00:00:00 2001 From: Hiltjo Posthuma <hiltjo@codemadness.org> Date: Thu, 31 Jul 2025 14:42:59 +0200 Subject: [PATCH 4/4] improve man pages and some warnings. Checking for warnings: mandoc -Tlint *.1 - Swap .St -p1003.1-2013 macro with text: mdoc does not support this macro and some texts were changed, like commit d4dfd42d3580ad36bedfdc5b8924ff6683981f53 - Typo fixes: exeption -> exception. - xargs.1: document -P extension. - sed.1: remove use of .Pp of .Ss. - Wrap lines to less than 80 characters and use a new sentence for each line. - find.1: Xr reference C library functions.
82 lines
1.5 KiB
Groff
82 lines
1.5 KiB
Groff
.Dd October 8, 2015
|
|
.Dt DATE 1
|
|
.Os sbase
|
|
.Sh NAME
|
|
.Nm date
|
|
.Nd print or set date and time
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl d Ar time
|
|
.Op Fl u
|
|
.Oo
|
|
.Cm + Ns Ar format |
|
|
.Sm off
|
|
.Ar mmddHHMM Oo Oo Ar CC Oc Ar yy Oc
|
|
.Sm on
|
|
.Oc
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
prints the date and time according to
|
|
.Xr locale 7
|
|
or
|
|
.Ar format
|
|
using
|
|
.Xr strftime 3
|
|
or sets the date.
|
|
.Sh OPTIONS
|
|
.Bl -tag -width Ds
|
|
.It Fl d Ar time
|
|
Print
|
|
.Ar time
|
|
given as the number of seconds since the
|
|
Unix epoch 1970-01-01T00:00:00Z.
|
|
.It Fl u
|
|
Print or set UTC time instead of local time.
|
|
.El
|
|
.Pp
|
|
An operand with a leading plus
|
|
.Pq Cm +
|
|
sign signals a user-defined format string using
|
|
.Xr strftime 3
|
|
conversion specifications.
|
|
.Pp
|
|
An operand without a leading plus sign is interpreted as a value
|
|
for setting the system's current date and time.
|
|
The canonical representation for setting the date and time is:
|
|
.Pp
|
|
.Bl -tag -width Ds -compact -offset indent
|
|
.It Ar mm
|
|
The month of the year, from 01 to 12.
|
|
.It Ar dd
|
|
The day of the month, from 01 to 31.
|
|
.It Ar HH
|
|
The hour of the day, from 00 to 23.
|
|
.It Ar MM
|
|
The minute of the hour, from 00 to 59.
|
|
.It Ar CC
|
|
The first two digits of the year (the century).
|
|
.It Ar yy
|
|
The second two digits of the year.
|
|
If
|
|
.Ar yy
|
|
is specified, but
|
|
.Ar CC
|
|
is not, a value for
|
|
.Ar yy
|
|
between 69 and 99 results in a
|
|
.Ar CC
|
|
value of 19.
|
|
Otherwise, a
|
|
.Ar CC
|
|
value of 20 is used.
|
|
.El
|
|
.Pp
|
|
The century and year are optional.
|
|
The default is the current year.
|
|
.Sh STANDARDS
|
|
POSIX.1-2013.
|
|
.Pp
|
|
The
|
|
.Op Fl d
|
|
flag is an extension to that specification.
|