date.1 (1046B)
1 .Dd 2018-10-15
2 .Dt DATE 1
3 .Os
4 .Sh NAME
5 .Nm date
6 .Nd display date and time
7 .Sh SYNOPSIS
8 .Nm
9 .Op Fl du
10 .Op Cm + Ns Ar format
11 .Sh DESCRIPTION
12 When
13 .Nm
14 is invoked without arguments it displays the current datetime
15 Otherwise, depending on the options specified, will print the datetime in a user-defined way.
16 .Bl -tag -width Ds
17 .It Fl u
18 Use UTC (Coordinated Universal) time instead of the local time.
19 .It Fl d
20 Use the time provided after this option instead of the system one.
21 .Pp
22 The plus operand
23 .Pq Sq +
24 specifies in which format the datetime should be displayed, the format string is specified in the
25 .Xr strftime 3
26 manual page.
27 .Sh ENVIRONMENT
28 Look at the manual page of
29 .Xr strftime 3
30 for the environment variables, typical ones are TZ and LC_TIME/LC_ALL, but that depends on your system.
31 .Sh EXIT STATUS
32 .Ex -std
33 .Sh SEE ALSO
34 .Xr strftime 3
35 .Sh STANDARDS
36 .Nm
37 is compliant wit the
38 .St -p1003.1-2008
39 specification.
40 .Pp
41 The
42 .Op Fl d
43 flag is an extension to this specification.
44 .Sh AUTHORS
45 .An Haelwenn (lanodan) Monnier Aq Mt contact@hacktivis.me