Calendar options

`-n|N[-]'

`--holiday-list[=long|short]'

`--descending-holiday-list[=long|short]'

Display the eternal holiday list. See section Eternal Holidays, for additional information.

`-n'

`--holiday-list=long'

Display all holidays of eternal holiday list -- this means, all legal holidays and all further memorial days -- sorted in ascending order.

`-n-'

`--descending-holiday-list=long'

Display all holidays of eternal holiday list -- this means, all legal holidays and all further memorial days -- sorted in descending order.

`-N'

`--holiday-list=short'

Display legal holidays only of eternal holiday list, sorted in ascending order.

`-N-'

`--descending-holiday-list=short'

Display legal holidays only of eternal holiday list, sorted in descending order.

`-X'

`--exclude-holiday-list-title'

Suppress the title text line of the eternal holiday list.

`--without-standard-holidays'

Suppress all standard holidays in the eternal holiday list. Furthermore, all days of the eternal holiday list which are highlighted by default are no longer highlighted in the calendar sheets, too.

`--christian-holidays'

Provide the eternal holiday list additionally with Christian holidays. Furthermore, all additionally highlighted days of the eternal holiday list are highlighted in the calendar sheets, too.

`-q cc[+...]'

`--cc-holidays=cc[+...]'

Provide the eternal holiday list additionally with country specific holidays. Furthermore, all additionally highlighted days of the eternal holiday list are highlighted in the calendar sheets, too. The cc argument is a two-letter territory or country code as defined by the ISO-3166 like `GB' for Great Britain or `US' for the U.S.A. See the pertinent literature for more details. You can use more than one country code cc by connecting them with a `+' character, e.g.:

`--cc-holidays=ca+DE+fr+it' resp.,
`-q ca+DE+fr+it'

includes all the country specific holidays given in the preceding argument into the eternal holiday list, i.e. Canadian, German, French and Italian holidays. Actually, Gcal respects the following country codes:

at

Austria

au

Australia

be

Belgium

ca

Canada

ch

Switzerland

cz

Czech Republic

de

Germany

dk

Denmark

es

Spain

fi

Finland

fr

France

gb

Great Britain

gr

Greece

hu

Hungary

it

Italy

mx

Mexico

nl

Netherlands

no

Norway

pl

Poland

pt

Portugal

se

Sweden

si

Slovenia

th

Thailand

us

U.S.A.

`-i[-]'

`--type=special|standard'

To get the standard calendar format (14), start Gcal omitting the `-i[-]' option because it is set by default. See section Aspects in Internationalization, for more details. Or start Gcal with the `-i-' respectively the `--type=standard' option to force the output of a calendar sheet:

$ gcal -i-
-|
-|    September 1994
-| Su Mo Tu We Th Fr Sa
-|              1  2  3
-|  4  5  6  7  8  9 10
-| 11 12 13 14 15 16 17
-| 18 19 20 21 22 23 24
-| 25 26 27 28 29 30   

To get the special calendar format and to force the output of a calendar sheet, start Gcal with the `-i' respectively the `--type=special' option:

$ gcal -i
-|
-| September 1994
-|
-| Sunday          4 11 18 25
-| Monday          5 12 19 26
-| Tuesday         6 13 20 27
-| Wednesday       7 14 21 28
-| Thursday     1  8 15 22 29
-| Friday       2  9 16 23 30
-| Saturday     3 10 17 24

`-O'

`--orthodox-calendar'

Use the leap year rule as used by the Eastern orthodox churches. Without specifying the --orthodox-calendar option, Gcal is unable to display Gregorian years later than 2799 in the correct way for the Eastern churches, because they use a different scheme for calculating the leap years. The method for computing leap years within the common Gregorian calendar, which Gcal uses by default, is as follows:

A leap year is any year, which number can be divided by 4 without a remainder, and years ending in hundrets are no leap years unless they are divisible by 400.

But the Eastern orthodox churches compute leap years within the Gregorian calendar by using another rule:

A leap year is any year, which number can be divided by 4 without a remainder, and years ending in hundrets are leap years, if a remainder of 2 or 6 occurs when such a year is divided by 9.

The first difference therefore occurs in the year 2800, which is a leap year in the common Gregorian calendar, but an ordinary year only in the calendar as used by the Eastern orthodox churches.

`-K'

`--with-week-number'

Provide the calendar sheet with ISO-8601:1988 week numbers. Please note:
The methods of ISO-8601:1988 are used for detecting week numbers; this means a week begins with a Monday, and the first week of a year is the one which includes the first Thursday; equivalently, the one which includes 4th January. If the starting day of week is not set to Monday (see section Calendar options), the week numbers are not represented correctly in most cases. If you use this option, you should take care of setting Monday as the starting day of the week! See section Aspects in Internationalization, for more details.

`-u'

`--suppress-calendar'

Suppress output of calendar sheet explicitly.

`-b number'

`--blocks=number'

Set number of calendar sheet blocks (valid arguments: `1|2|3|4|6|12'). The default number for the standard calendar format is `-b4 ' respectively `--blocks=4', and for the special calendar format `-b 3' respectively `--blocks=3'. If this option is found, the program sees that a year calendar output is desired!

`-b 1'

`--blocks=1'

Displays one block with twelve months at a time.

`-b 2'

`--blocks=2'

Displays two blocks with six months at a time.

`-b 3'

`--blocks=3'

Displays three blocks with four months at a time.

`-b 4'

`--blocks=4'

Displays four blocks with three months at a time.

`-b 6'

`--blocks=6'

Displays six blocks with two months at a time.

`-b 12'

`--blocks=12'

Displays twelve blocks with one month at a time.

`-j[b]'

`--calendar-dates=special|both'

Use alternative date format in calendar sheet instead of the default standard format which displays the days of month in consecutive manner.

`-j'

`--calendar-dates=special'

Display the calendar sheet using the special date format. This means, the days of year are displayed in consecutive manner instead of the days of month.

`-jb'

`--calendar-dates=both'

Display the calendar sheet using the standard and special date format.

`-jn[b]'

`--holiday-dates=special|both'

Use alternative date format in eternal holiday list instead of the default standard format which displays the days of month in consecutive manner. See section Calendar options.

`-jn'

`--holiday-dates=special'

Display the eternal holiday list using the special date format. This means, the days of year are displayed in consecutive manner instead of the days of month.

`-jnb'

`--holiday-dates=both'

Display the eternal holiday list using the standard and special date format.

`-jc[b]'

`--fixed-dates=special|both'

Use alternative date format in fixed date list instead of the default standard format which displays the days of month in consecutive manner. See section Fixed date options.

`-jc'

`--fixed-dates=special'

Display the fixed date list using the special date format. This means, the days of year are displayed in consecutive manner instead of the days of month.

`-jcb'

`--fixed-dates=both'

Display the fixed date list using the standard and special date format.

`-s argument'

`--starting-day=argument'

Set the starting day of week (valid argument: `0, 1...7 | today | weekday name'). For example:

--starting-day=Sunday or
--starting-day=7 or
-s SUNDAY or
-s sund or
-sSu or
-s 7 

thus all specifies the Sunday (1==Mon, 2==Tue ... 7==Sun). If the `-s today' option (or `--starting-day=today') or the `-s 0' option (or
`--starting-day=0') is given, the starting day of week is set to the actual weekday which is delivered by the system date. See section Aspects in Internationalization, for more details.

`--gregorian-reform=1582|1700|1752|1753|argument'

Set the period which was skipped during the Gregorian Reformation. See section Aspects in Internationalization, for more details. Actually, four fixed default periods are supported, and that of the year 1582, of the year 1700, of the year 1752 and of the year 1753. If Gcal is called with the `--gregorian-reform=1582' option, it assumes the Gregorian Reformation have occurred from 5th till 14th October 1582. If Gcal is called with the `--gregorian-reform=1700' option, it assumes the Gregorian Reformation have occurred from 19th till 28th February 1700. If Gcal is called with the `--gregorian-reform=1752' option, it assumes the Gregorian Reformation have occurred from 3rd till 13th September 1752. If Gcal is called with the `--gregorian-reform=1753' option, it assumes the Gregorian Reformation have occurred from 18th till 28th February 1753. In case another period shall be respected, it can be arranged by the option argument like `yyyy,mm,first-day,last-day'. If the Gregorian Reformation have occurred for example on the 7th till the 17th April 1802, this can be arranged as follows:

--gregorian-reform=1802,4,7,17

Please note that it is possible to corrupt the calendars likewise the fixed date feature logically (which works correctly now for the year in which the Gregorian Reformation have occured) if argument is not used with care.

`--date-format=de|us|gb|text'

Set the date format which controls the ordering and representation of a displayed date. See section Aspects in Internationalization, for more details. The date format text is respected by Gcal in the eternal holiday list, in the fixed date list and the calendar sheets. Moreover, Gcal internally tries to obtain the best representation of a displayed date in case the days of the year instead of the days of the months must be displayed. Actually, three fixed default date formats are supported, and that for German users, U.S. American users and for users in Great Britain. If Gcal is called with the `--date-format=de' option, the `%w, %1%D%2 %b %y' format text is used. If Gcal is called with the `--date-format=us' option, the `%W, %b %1%U%2 %y' format text is used. If Gcal is called with the `--date-format=gb' option, the `%W, %1%U%2 %b %y' format text is used. In case another format text shall be respected, this format text can either be set in the GCAL_DATE_FORMAT environment variable (15), or it can be arranged by the option argument text, e.g.:

--date-format="%Y %D %m ; %1(%A)%2"

The format text may contain on the one hand all characters which can be managed by Gcal, and on the other hand character replacement instructions and format statements which are transformed into their according values at run-time. A minimum date format text must contain components from the day group, the month group, the year group and the highlighting group. A component of the weekday name group is optional. The following format statements and character replacement instructions are currently supported: Day group (exactly one member must be defined):

%d

Day number with leading zeroes

%D

Day number with leading spaces

%u

Day number with leading zeroes and trailing Ordinal Number suffix

%U

Day number with leading spaces and trailing Ordinal Number suffix

Month group (exactly one member must be defined):

%B

Complete month name

%b

Abbreviated month name (3 letters)

%m

Month number with leading zero

%M

Month number with leading space

Year group (exactly one member must be defined):

%y

Complete year number with leading zeroes

%Y

Complete year number with leading spaces

%z

Last two digits of year number with leading zero

%Z

Last two digits of year number with leading space

Weekday name group (one member may be defined):

%A

Complete weekday name

%W

Abbreviated weekday name (3 letters)

%w

Abbreviated weekday name (2 letters)

Highlighting group (all members must be defined and %1 must be specified before %2):

%1

Start of highlighting sequence / marking character

%2

End of highlighting sequence / marking character

Character replacement instructions:

_

Space/blank character ` '

\_

Underscore character `_'

\%

Percent character `%'

Go to the first, previous, next, last section, table of contents.