GopherProxy

	date.1 - sbase - suckless unix tools
	git clone git://git.suckless.org/sbase
	Log
	Files
	Refs
	README
	LICENSE
	---
	date.1 (1563B)
	---
	1 .Dd October 8, 2015
	2 .Dt DATE 1
	3 .Os sbase
	4 .Sh NAME
	5 .Nm date
	6 .Nd print or set date and time
	7 .Sh SYNOPSIS
	8 .Nm
	9 .Op Fl d Ar time
	10 .Op Fl u
	11 .Oo
	12 .Cm + Ns Ar format \|
	13 .Sm off
	14 .Ar mmddHHMM Oo Oo Ar CC Oc Ar yy Oc
	15 .Sm on
	16 .Oc
	17 .Sh DESCRIPTION
	18 .Nm
	19 prints the date and time according to
	20 .Xr locale 7
	21 or
	22 .Ar format
	23 using
	24 .Xr strftime 3
	25 or sets the date.
	26 .Sh OPTIONS
	27 .Bl -tag -width Ds
	28 .It Fl d Ar time
	29 Print
	30 .Ar time
	31 given as the number of seconds since the
	32 Unix epoch 1970-01-01T00:00:00Z.
	33 .It Fl u
	34 Print or set UTC time instead of local time.
	35 .El
	36 .Pp
	37 An operand with a leading plus
	38 .Pq Cm +
	39 sign signals a user-defined format string using
	40 .Xr strftime 3
	41 conversion specifications.
	42 .Pp
	43 An operand without a leading plus sign is interpreted as a value
	44 for setting the system's current date and time.
	45 The canonical representation for setting the date and time is:
	46 .Pp
	47 .Bl -tag -width Ds -compact -offset indent
	48 .It Ar mm
	49 The month of the year, from 01 to 12.
	50 .It Ar dd
	51 The day of the month, from 01 to 31.
	52 .It Ar HH
	53 The hour of the day, from 00 to 23.
	54 .It Ar MM
	55 The minute of the hour, from 00 to 59.
	56 .It Ar CC
	57 The first two digits of the year (the century).
	58 .It Ar yy
	59 The second two digits of the year.
	60 If
	61 .Ar yy
	62 is specified, but
	63 .Ar CC
	64 is not, a value for
	65 .Ar yy
	66 between 69 and 99 results in a
	67 .Ar CC
	68 value of 19.
	69 Otherwise, a
	70 .Ar CC
	71 value of 20 is used.
	72 .El
	73 .Pp
	74 The century and year are optional.
	75 The default is the current year.
	76 .Sh STANDARDS
	77 The
	78 .Nm
	79 utility is compliant with the
	80 .St -p1003.1-2013
	81 specification.
	82 .Pp
	83 The
	84 .Op Fl d
	85 flag is an extension to that specification.