cal.1 (1259B)
- .Dd 2015-10-08
- .Dt CAL 1
- .Os sbase
- .Sh NAME
- .Nm cal
- .Nd show calendar
- .Sh SYNOPSIS
- .Nm
- .Op Fl 1 | Fl 3 | Fl y | Fl n Ar num
- .Op Fl s | Fl m | Fl f Ar num
- .Op Fl c Ar num
- .Oo Oo Ar month Oc Ar year Oc
- .Sh DESCRIPTION
- .Nm
- writes a calendar of
- .Ar month
- and
- .Ar year
- or the current month to stdout.
- If
- .Ar year
- is given without
- .Ar month ,
- .Nm
- writes a 3-column calendar of the whole
- year to stdout.
- The date formatting is according to
- .Xr localtime 3 .
- .Pp
- The Julian calendar is used until Sep 2, 1752.
- The Gregorian calendar is used starting the next day on Sep 14, 1752.
- .Sh OPTIONS
- .Bl -tag -width Ds
- .It Fl 1
- Print current month.
- This is the default.
- .It Fl 3
- Print previous, current and next month.
- .It Fl c Ar num
- .Ar num
- calendars in a row.
- The default is 3.
- .It Fl f Ar num
- Set
- .Ar num
- (0 is Sunday, 6 is Saturday) as first day of week.
- .It Fl m
- Set Monday as first day of week.
- .It Fl n Ar num
- Output
- .Ar num
- months starting from and including the current month.
- .It Fl s
- Set Sunday as first day of week.
- .It Fl y
- Print the entire
- .Ar year
- or current year.
- .El
- .Sh SEE ALSO
- .Xr localtime 3
- .Sh STANDARDS
- The
- .Nm
- utility is compliant with the
- .St -p1003.1-2013
- specification.
- .Pp
- The flags
- .Op Fl 13cfmnsy
- are an extension to that specification.