commit: 21272cff5a12324b9f21ad8aeb67a9eff3439730
parent: a44fd69f1764951bf1cd07ae0a05a4c998e16039
Author: Haelwenn (lanodan) Monnier <contact@hacktivis.me>
Date: Mon, 15 Oct 2018 06:02:33 +0200
src/date.1: Create
Diffstat:
| A | src/date.1 | 45 | +++++++++++++++++++++++++++++++++++++++++++++ |
1 file changed, 45 insertions(+), 0 deletions(-)
diff --git a/src/date.1 b/src/date.1
@@ -0,0 +1,45 @@
+.Dd 2018-10-15
+.Dt DATE 1
+.Os
+.Sh NAME
+.Nm date
+.Nd display date and time
+.Sh SYNOPSIS
+.Nm
+.Op Fl du
+.Op Cm + Ns Ar format
+.Sh DESCRIPTION
+When
+.Nm
+is invoked without arguments it displays the current datetime
+Otherwise, depending on the options specified, will print the datetime in a user-defined way.
+.Bl -tag -width Ds
+.It Fl u
+Use UTC (Coordinated Universal) time instead of the local time.
+.It Fl d
+Use the time provided after this option instead of the system one.
+.Pp
+The plus operand
+.Pq Sq +
+specifies in which format the datetime should be displayed, the format string is specified in the
+.Xr strftime 3
+manual page.
+.Sh ENVIRONMENT
+Look at the manual page of
+.Xr strftime 3
+for the environment variables, typical ones are TZ and LC_TIME/LC_ALL, but that depends on your system.
+.Sh EXIT STATUS
+.Ex -std
+.Sh SEE ALSO
+.Xr strftime 3
+.Sh STANDARDS
+.Nm
+is compliant wit the
+.St -p1003.1-2008
+specification.
+.Pp
+The
+.Op Fl d
+flag is an extension to this specification.
+.Sh AUTHORS
+.An Haelwenn (lanodan) Monnier Aq Mt contact@hacktivis.me
