unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



cal(1)								       cal(1)



NAME

  cal -	Displays a calendar

SYNOPSIS

  cal [month [year]]

STANDARDS

  Interfaces documented	on this	reference page conform to industry standards
  as follows:

  cal:	XCU5.0

  Refer	to the standards(5) reference page for more information	about indus-
  try standards	and associated tags.

OPTIONS

  None

OPERANDS

  month
      Names the	month for which	you want the calendar.	It can be a number
      between 1	and 12 for January through December, respectively.  If month
      is not specified,	cal displays a calendar	for the	entire year, unless
      year is also omitted.

  year
      Names the	year for which you want	the calendar. Because cal can display
      a	calendar for any year from 1 to	9999, enter the	full year rather than
      just the last two	digits.	 If year is not	specified, cal uses the
      current year.

  If no	operands are specified,	cal displays a calendar	for the	current
  month.

DESCRIPTION

  The cal command writes to standard output a Gregorian	calendar for the
  specified year or month.

  For historical reasons, the cal command's Gregorian calendar is discontinu-
  ous. The display for September 1752 (cal 9 1752) jumps from Wednesday	the
  2nd to Thursday the 14th.

  The cal command checks the LC_TIME environment variable and uses the
  correct headers for the current locale. If LC_TIME is	not set, cal checks
  the value of LANG. If	neither	variable is set, you receive English headers.



EXIT STATUS

  The following	exit values are	returned:

  0   Successful completion.

  >>0  An error occurred.

EXAMPLES

   1.  To display a calendar for February 1990,	enter:
	    cal	2 1990

   2.  To display a calendar for the year 84 A.D., enter:
	    cal	84

   3.  To display a calendar for the current month, enter:
	    cal



ENVIRONMENT VARIABLES

  The following	environment variables affect the execution of *cmd*:

  LANG
      Provides a default value for the internationalization variables that
      are unset	or null. If LANG is unset or null, the corresponding value
      from the default locale is used.	If any of the internationalization
      variables	contain	an invalid setting, the	utility	behaves	as if none of
      the variables had	been defined.

  LC_ALL
      If set to	a non-empty string value, overrides the	values of all the
      other internationalization variables.

  LC_CTYPE
      Determines the locale for	the interpretation of sequences	of bytes of
      text data	as characters (for example, single-byte	as opposed to multi-
      byte characters in arguments).

  LC_MESSAGES
      Determines the locale for	the format and contents	of diagnostic mes-
      sages written to standard	error.

  LC_TIME
      Determines the format and	contents of the	calendar.

  NLSPATH
      Determines the location of message catalogues for	the processing of
      LC_MESSAGES.

  TZ  Determines the time zone used to calculate the value of the current
      month.

SEE ALSO

  Commands:  date(1)

  Files:  locale(4)

  Standards:  standards(5)

  Command and Shell User's Guide