~/.local/bin tools and git-hooks
commit: 21272cff5a12324b9f21ad8aeb67a9eff3439730
parent: a44fd69f1764951bf1cd07ae0a05a4c998e16039
Author: Haelwenn (lanodan) Monnier <contact@hacktivis.me>
Date:   Mon, 15 Oct 2018 06:02:33 +0200

src/date.1: Create


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