sbase/date.1

.Dd 2015-10-08
.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
The
.Nm
utility is compliant with the
.St -p1003.1-2013
specification.
.Pp
The
.Op Fl d
flag is an extension to that specification.
Use ISO-date-format in manpages The one specified by mdoc is hard to read for non-native speakers from countries which read the date day-first (like Germany, Greece, North-Korea, Swamp,...). This is also consistent with how we generally specify dates at suckless.org. 2015-10-08 11:15:08 -04:00			`.Dd 2015-10-08`
remove sbase-VERSION from man page, fix sponge.1 date 2015-01-31 08:20:02 -05:00			`.Dt DATE 1`
Add .Os sbase and sed replace to .Os sbase $(VERSION) in make install 2015-01-31 14:37:03 -05:00			`.Os sbase`
Add mandoc-manpage for date(1) and clean up code and mark it as finished in README. 2015-01-23 16:54:25 -05:00			`.Sh NAME`
			`.Nm date`
date: add date/time setting capability [Michael Forney: Moved functionality to setdate, other minor tweaks] 2017-01-01 20:09:53 -05:00			`.Nd print or set date and time`
Add mandoc-manpage for date(1) and clean up code and mark it as finished in README. 2015-01-23 16:54:25 -05:00			`.Sh SYNOPSIS`
add some mandoc pages and fix some warnings - add .Os, it is mandatory. - don't redeclare .Nm when it's not needed. - fix some warnings (checked with mandoc -Tlint). - remove some leftover old stuff. 2015-01-30 15:17:58 -05:00			`.Nm`
Add mandoc-manpage for date(1) and clean up code and mark it as finished in README. 2015-01-23 16:54:25 -05:00			`.Op Fl d Ar time`
			`.Op Fl u`
date: add date/time setting capability [Michael Forney: Moved functionality to setdate, other minor tweaks] 2017-01-01 20:09:53 -05:00			`.Oo`
			`.Cm + Ns Ar format \|`
			`.Sm off`
			`.Ar mmddHHMM Oo Oo Ar CC Oc Ar yy Oc`
			`.Sm on`
			`.Oc`
Add mandoc-manpage for date(1) and clean up code and mark it as finished in README. 2015-01-23 16:54:25 -05:00			`.Sh DESCRIPTION`
			`.Nm`
			`prints the date and time according to`
			`.Xr locale 7`
			`or`
			`.Ar format`
			`using`
date: add date/time setting capability [Michael Forney: Moved functionality to setdate, other minor tweaks] 2017-01-01 20:09:53 -05:00			`.Xr strftime 3`
			`or sets the date.`
Add mandoc-manpage for date(1) and clean up code and mark it as finished in README. 2015-01-23 16:54:25 -05:00			`.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`
date: add date/time setting capability [Michael Forney: Moved functionality to setdate, other minor tweaks] 2017-01-01 20:09:53 -05:00			`Print or set UTC time instead of local time.`
Add mandoc-manpage for date(1) and clean up code and mark it as finished in README. 2015-01-23 16:54:25 -05:00			`.El`
date: add date/time setting capability [Michael Forney: Moved functionality to setdate, other minor tweaks] 2017-01-01 20:09:53 -05:00			`.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`
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command. 2020-03-01 17:37:31 -05:00			`for setting the system's current date and time.`
			`The canonical representation for setting the date and time is:`
date: add date/time setting capability [Michael Forney: Moved functionality to setdate, other minor tweaks] 2017-01-01 20:09:53 -05:00			`.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`
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command. 2020-03-01 17:37:31 -05:00			`value of 19.`
			`Otherwise, a`
date: add date/time setting capability [Michael Forney: Moved functionality to setdate, other minor tweaks] 2017-01-01 20:09:53 -05:00			`.Ar CC`
			`value of 20 is used.`
			`.El`
			`.Pp`
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command. 2020-03-01 17:37:31 -05:00			`The century and year are optional.`
			`The default is the current year.`
Add mandoc-manpage for date(1) and clean up code and mark it as finished in README. 2015-01-23 16:54:25 -05:00			`.Sh STANDARDS`
			`The`
			`.Nm`
			`utility is compliant with the`
POSIX 2013 audit Mostly manpage-shuffling according to the changes in the corrigendum, wording changes and more idiomatic expressions. All this is finished up by marking the POSIX 2013 conformant tools with .St -p1003.1-2013 which is not available in older mandoc builds or nroff, but which reflects what we actually did, so who cares? This is a huge step and it's not far until we can release sbase 0.1. 2015-03-27 12:22:48 -04:00			`.St -p1003.1-2013`
Add mandoc-manpage for date(1) and clean up code and mark it as finished in README. 2015-01-23 16:54:25 -05:00			`specification.`
			`.Pp`
			`The`
			`.Op Fl d`
			`flag is an extension to that specification.`