Unix/Linux Go Back    


NetBSD 6.1.5 - man page for cal (netbsd section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


CAL(1)				   BSD General Commands Manual				   CAL(1)

NAME
     cal -- displays a calendar

SYNOPSIS
     cal [-3hjry] [-A after] [-B before] [-d day-of-week] [-R reform-spec] [[month] year]

DESCRIPTION
     cal displays a simple calendar.  If arguments are not specified, the current month is dis-
     played.  The options are as follows:

     -3      Same as ``-A 1 -B 1''.

     -A after
	     Display after months after the specified month.

     -B before
	     Display before months before the specified month.

     -d day-of-week
	     Specifies the day of the week on which the calendar should start.	Valid values are
	     0 through 6, presenting Sunday through Saturday, inclusively.  The default output
	     starts on Sundays.

     -h      Highlight the current day, if present in the displayed calendar.  If output is to a
	     terminal, then the appropriate terminal sequences are used, otherwise overstriking
	     is used.  If more than one -h is used and output is to a terminal, the current date
	     will be highlighted in inverse video instead of bold.

     -j      Display Julian dates (days one-based, numbered from January 1).

     -R reform-spec
	     Selects an alternate Gregorian reform point from the default of September 3rd, 1752.
	     The reform-spec can be selected by one of the built-in names (see NOTES for a list)
	     or by a date of the form YYYY/MM/DD.  The date and month may be omitted, provided
	     that what is specified uniquely selects a given built-in reform point.  If an exact
	     date is specified, then that date is taken to be the first missing date of the Gre-
	     gorian Reform to be applied.

     -r      Display the month in which the Gregorian Reform adjustment was applied, if no other
	     month or year information is given.  If used in conjunction with -y, then the entire
	     year is displayed.

     -y      Display a calendar for the current year.

     If no parameters are specified, the current month's calendar is displayed.  A single parame-
     ter specifies the year and optionally the month in ISO format: ``cal 2007-12'' Two parame-
     ters denote the month (1 - 12) and year.  Note that the century must be included in the
     year.

     A year starts on Jan 1.

NOTES
     In the USA and Great Britain the Gregorian Reformation occurred in 1752.  By this time, most
     countries had recognized the reformation (although a few did not recognize it until the
     1900's.)  Eleven days following September 2, 1752 were eliminated by the reformation, so the
     calendar for that month is a bit unusual.

     In view of the chaotic way the Gregorian calendar was adopted throughout the world in the
     years between 1582 and 1928 make sure to take into account the date of the Gregorian Refor-
     mation in your region if you are checking a calendar for a very old date.

     cal has a decent built-in list of Gregorian Reform dates and the names of the countries
     where the reform was adopted:

	     Italy	     Oct.  5, 1582   Denmark	     Feb. 19, 1700
	     Spain	     Oct.  5, 1582   Great Britain   Sep.  3, 1752
	     Portugal	     Oct.  5, 1582   Sweden	     Feb. 18, 1753
	     Poland	     Oct.  5, 1582   Finland	     Feb. 18, 1753
	     France	     Dec. 12, 1582   Japan	     Dec. 20, 1872
	     Luxembourg      Dec. 22, 1582   China	     Nov.  7, 1911
	     Netherlands     Dec. 22, 1582   Bulgaria	     Apr.  1, 1916
	     Bavaria	     Oct.  6, 1583   U.S.S.R.	     Feb.  1, 1918
	     Austria	     Jan.  7, 1584   Serbia	     Jan. 19, 1919
	     Switzerland     Jan. 12, 1584   Romania	     Jan. 19, 1919
	     Hungary	     Oct. 22, 1587   Greece	     Mar. 10, 1924
	     Germany	     Feb. 19, 1700   Turkey	     Dec. 19, 1925
	     Norway	     Feb. 19, 1700   Egypt	     Sep. 18, 1928

     The country known as Great Britain can also be referred to as England since that has less
     letters and no spaces in it.  This is meant only as a measure of expediency, not as a possi-
     ble slight to anyone involved.

HISTORY
     A cal command appeared in Version 6 AT&T UNIX.

BSD					December 21, 2007				      BSD
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 06:14 PM.