cal(1)

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

For information about the UNIX Standard environment, see standards(5).

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    M   Tu    W   Th    F    S 
  2    3    4    5    6    7 
  9   10   11   12   13   14 
 16   17   18   19   20   21 
 23   24   25   26   27   28 
 30 

However, for UNIX Standard (see standards(5)), the output looks like below:

              Sep 1850 
Sun  Mon  Tue  Wed  Thu  Fri  Sat 
  2    3    4    5    6    7 
  9   10   11   12   13   14 
 16   17   18   19   20   21 
 23   24   25   26   27   28 
 30 

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