NAME

cal − print calendar

SYNOPSIS

cal [[month] year]

DESCRIPTION

cal prints a calendar for the specified year.  If a month is also specified, a calendar just for that month is printed.  If neither is specified, a calendar for the present month is printed.  year can be between 1 and 9999.  month is a decimal number between 1 and 12.  The calendar produced is a Gregorian calendar. 

EXTERNAL INFLUENCES

Environment Variables

LANG determines the locale to use for the locale categories when both LC_ALL and the corresponding environment variable (beginning with LC_) do not specify a locale.  If LANG is not set or is set to the empty string, a default of "C" (see lang(5)) is used.

LC_CTYPE determines the locale for interpretation of sequences of bytes of text data as characters (e.g., single- verses multibyte characters in arguments and input files). 

LC_TIME determines the format and contents of the calendar. 

TZ determines the timezone used to calculate the value of the current month. 

If any internationalization variable contains an invalid setting, cal behaves as if all internationalization variables are set to "C".  See environ(5).

International Code Set Support

Single- and multi-byte character code sets are supported. 

EXAMPLES

The command:

cal 9 1850

prints the calendar for September, 1850 on the screen as follows:

     September 1850
S MTu WTh F S
1 2 3 4 5 6 7
8 91011121314
15161718192021
22232425262728
2930

However, for XPG4 the output looks like below:

    Sep 1850
SunMonTueWedThuFriSat
1 2 3 4 5 6 7
8 91011121314
15161718192021
22232425262728
2930

WARNINGS

The year is always considered to start in January even though this is historically naive. 

Beware that cal 83 refers to the early Christian era, not the 20th century. 

STANDARDS CONFORMANCE

cal: SVID2, SVID3, XPG2, XPG3, XPG4

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996