Next: Fixed date options, Previous: Global options, Up: Options [Contents][Index]
Display the eternal holiday list. By default, there are no entries in the eternal holiday list. You have to choose country specific holidays or holidays from other calendar systems to provide the eternal holiday list with entries. See Eternal Holidays, and Calendar option --cc-holidays=cc[+…], for additional information.
Display all holidays of eternal holiday list —this means, all legal holidays and all further memorial days— sorted in ascending order.
Display all holidays of eternal holiday list —this means, all legal holidays and all further memorial days— sorted in descending order.
Display legal holidays only of eternal holiday list, sorted in ascending order.
Display legal holidays only of eternal holiday list, sorted in descending order.
Suppress displaying of the blank line which is always leading an eternal holiday list.
Suppress the title text line of the eternal holiday list.
Provide the eternal holiday list additionally with some astronomical data, and that the Full and New Moon phases, waning and waxing Half Moon phases, solar and lunar eclipses, and the solstices and equinoxes. See Calendar option --time-offset=argument, how to change the timezone respectively base time for which the astronomical data is calculated.
Provide the eternal holiday list additionally with Bahá’ì holidays (only for dates after AD 1843).
Provide the eternal holiday list additionally with Celtic holidays. See Calendar option --time-offset=argument, how to change the timezone for which the Celtic holidays are calculated.
Provide the eternal holiday list additionally with Chinese holidays, that are determined in a flexible manner (only for dates after AD 1644). See Calendar option --time-offset=argument, how to change the timezone for which the Chinese holidays are calculated in a flexible manner. See Preface, for further details.
Provide the eternal holiday list additionally with Chinese holidays (only for dates after AD 1644). For dates until AD 1928 all computations done are depending fixed on Beijing local time, for later dates fixed on the timezone GMT-8. See Preface, for further details.
Provide the eternal holiday list additionally with Christian holidays.
Provide the eternal holiday list additionally with Hebrew holidays.
Provide the eternal holiday list additionally with Islamic holidays (only for dates after AD 621), that are based on the civil Islamic calendar. See Preface, for further details.
Provide the eternal holiday list additionally with Japanese holidays, that are determined in a flexible manner (only for dates after AD 1644). See Calendar option --time-offset=argument, how to change the timezone for which the Japanese holidays are calculated in a flexible manner.
Provide the eternal holiday list additionally with Japanese holidays (only for dates after AD 1644). For dates until AD 1887 all computations done are depending fixed on Beijing local time, for later dates fixed on the timezone GMT-9.
Provide the eternal holiday list additionally with multicultural New Year holidays. See Calendar option --time-offset=argument, how to change the timezone for which the multicultural New Year holidays are calculated.
Provide the eternal holiday list additionally with Orthodox new calendar holidays, and it is assumed that the Gregorian Reformation has occurred from 10th till 22nd March 1924. See Calendar option --orthodox-calendar, for further details.
Provide the eternal holiday list additionally with Orthodox new calendar holidays, and it is assumed that the Gregorian Reformation has occurred from 10th till 22nd March 1924. See Calendar option --orthodox-calendar, for further details.
Provide the eternal holiday list additionally with Persian holidays (only for dates after AD 621), which are based on the Persian Jalaali calendar. All computations done are depending on the timezone GMT-3.5.
Provide the eternal holiday list additionally with zodiacal marker holidays, i.e. the dates when the Sun enters a zodiac sign or when the Sun reaches the turning-point in the zodiac sign. See Calendar option --time-offset=argument, how to change the timezone for which the zodiacal marker holidays are calculated.
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 country code as defined by the ISO-316616 like ‘BE’ for Belgium or ‘ES’ for Spain. See the pertinent literature for more details.
In some cases, such a country code may be trailed by a two-letter territory code tt for better specification, which is separated by a ‘_’ character from the country code.
You can use more than one country code cc[_tt] by connecting them with a ‘+’ character, e.g.:
--cc-holidays=be+Fr+IT resp.,
-q be+Fr+IT
includes all the country specific holidays given in the preceding argument into the eternal holiday list, i.e. Belgian, French and Italian holidays.
Actually, Gcal respects the following country codes, at which countries marked by a ‘#’ character have only an incomplete recording of holidays:
ADAndorra
AEUnited Arab Emirates
AFAfghanistan
AGAntigua and Barbuda
AIAnguilla
ALAlbania
AMArmenia
AN_BONetherlands Antilles/Bonaire
AN_CUNetherlands Antilles/Curaçao
AN_MANetherlands Antilles/St Maarten
AN_SANetherlands Antilles/Saba and Statia
AOAngola #
ARArgentina
ASAmerican Samoa
ATAustria
AU_CTAustralia/Canberra
AU_NTAustralia/Northern Territory
AU_QUAustralia/Queensland
AU_SAAustralia/Southern Australia
AU_SWAustralia/New South Wales
AU_TAAustralia/Tasmania
AU_VIAustralia/Victoria
AU_WAAustralia/Western Australia
AWAruba
AZAzerbaijan
BABosnia-Herzegovina
BBBarbados
BDBangladesh #
BEBelgium
BFBurkina Faso
BGBulgaria
BHBahrain
BIBurundi #
BJBenin #
BMBermuda
BNBrunei
BOBolivia
BRBrazil
BSBahamas
BTBhutan #
BVBouvet Island
BWBotswana
BYBelarus
BZBelize
CA_ALCanada/Alberta
CA_BCCanada/British Columbia
CA_MACanada/Manitoba
CA_NBCanada/New Brunswick
CA_NFCanada/Newfoundland and Labrador
CA_NSCanada/Nova Scotia
CA_NWCanada/Northwest Territories
CA_ONCanada/Ontario
CA_PECanada/Prince Edward Island
CA_QUCanada/Québec
CA_SACanada/Saskatchewan
CA_YUCanada/Yukon
CCCocos Islands (Keeling)
CDDemocratic Republic of Congo #
CFCentral African Republic #
CGRepublic of Congo #
CH_AGSwitzerland/Aargau
CH_AISwitzerland/Appenzell Innerrhoden
CH_ARSwitzerland/Appenzell Ausserrhoden
CH_BESwitzerland/Bern
CH_BLSwitzerland/Basel-Land
CH_BSSwitzerland/Basel-Stadt
CH_FRSwitzerland/Fribourg
CH_GESwitzerland/Genève
CH_GLSwitzerland/Glarus
CH_GRSwitzerland/Graubünden
CH_JUSwitzerland/Jura
CH_LUSwitzerland/Luzern
CH_NESwitzerland/Neuchâtel
CH_NWSwitzerland/Nidwalden
CH_OWSwitzerland/Obwalden
CH_SGSwitzerland/St Gallen
CH_SHSwitzerland/Schaffhausen
CH_SOSwitzerland/Solothurn
CH_SZSwitzerland/Schwyz
CH_TGSwitzerland/Thurgau
CH_TISwitzerland/Ticino
CH_URSwitzerland/Uri
CH_VDSwitzerland/Vaud
CH_VSSwitzerland/Valais
CH_ZGSwitzerland/Zug
CH_ZHSwitzerland/Zürich
CICôte d’Ivoire
CKCook Islands
CLChile
CMCameroon
CNChina
COColombia
CRCosta Rica
CUCuba
CVCape Verde
CXChristmas Islands
CYCyprus
CZCzech Republic
DE_BBGermany/Brandenburg
DE_BEGermany/Berlin
DE_BWGermany/Baden-Württemberg
DE_BYGermany/Bavaria
DE_HBGermany/Bremen
DE_HEGermany/Hesse
DE_HHGermany/Hamburg
DE_MVGermany/Mecklenburg-West Pomerania
DE_NIGermany/Lower Saxony
DE_NWGermany/North Rhine-Westphalia
DE_RPGermany/Rhineland Palatinate
DE_SHGermany/Schleswig-Holstein
DE_SLGermany/Saar
DE_SNGermany/Saxony
DE_STGermany/Saxony-Anhalt
DE_THGermany/Thuringia
DJDjibouti
DKDenmark
DMDominica
DODominican Republic
DZAlgeria
ECEcuador
EEEstonia
EGEgypt
EHWestern Sahara
EREritrea
ESSpain
ETEthiopia
FIFinland
FJFiji #
FKFalkland Islands (Malvinas)
FMFederated States of Micronesia
FOFaroes
FRFrance
GAGabon #
GB_ENGreat Britain/England and Wales
GB_NIGreat Britain/Northern Ireland
GB_SLGreat Britain/Scotland
GDGrenada
GEGeorgia
GFFrench Guiana
GHGhana
GIGibraltar
GLGreenland
GMGambia
GNGuinea
GPGuadeloupe
GQEquatorial Guinea
GRGreece
GSSouth Georgia and South Sandwich Islands
GTGuatemala
GUGuam
GWGuinea-Bissau #
GYGuyana #
HKHong Kong
HMHeard and Mc Donald Islands
HNHonduras
HRCroatia
HTHaiti
HUHungary
IDIndonesia #
IEIreland
ILIsrael
INIndia #
IQIraq
IRIslamic Republic of Iran
ISIceland
ITItaly
JMJamaica
JOJordan
JPJapan
KEKenya #
KGKyrgyzstan
KHCambodia #
KIKiribati #
KMComoros
KNSt Kitts and Nevis
KPDemocratic People’s Republic of Korea #
KRRepublic of Korea
KWKuwait
KYCayman Islands
KZKazakhstan
LALaos People’s Democratic Republic #
LBLebanon
LCSt Lucia
LILiechtenstein
LKSri Lanka #
LRLiberia
LSLesotho
LTLithuania
LULuxembourg
LVLatvia
LYLibyan Arab Jamahiriya (Libya)
MAMorocco
MCMonaco
MDRepublic of Moldova
MGMadagascar #
MHMarshall Islands
MKFormer Yugoslav Republic of Macedonia
MLMali
MNMongolia #
MOMacau
MPNorthern Marian Islands (Saipan)
MQMartinique
MRMauritania
MSMontserrat
MTMalta
MUMauritius
MVMaldives
MWMalawi
MXMexico
MYMalaysia #
MZMozambique
NANamibia
NCNew Caledonia
NENiger
NFNorfolk Island
NGNigeria
NINicaragua
NLNetherlands
NMMyanmar (Burma) #
NONorway
NPNepal #
NRNauru
NUNiue
NZNew Zealand
OMOman
PAPanama
PEPeru
PFFrench Polynesia
PGPapua New Guinea
PHPhilippines
PKPakistan
PLPoland
PMSaint-Pierre and Miquelon
PNPitcairn
PRPuerto Rico
PTPortugal
PWPalau
PYParaguay
QAQatar
RERéunion
RORomania
RURussian Federation
RWRwanda
SASaudi Arabia
SBSolomon Islands
SCSeychellen
SDSudan
SESweden
SGSingapore #
SHSt Helena
SISlovenia
SJSvalbard and Jan Mayen Islands
SKSlovakia
SLSierra Leone
SMSan Marino
SNSenegal
SOSomalia
SRSuriname #
STSao Tomé and Principe
SVEl Salvador
SYSyrian Arab Republic (Syria)
SZSwaziland
TCTurks and Caicos Islands
TDChad
TGTogo #
THThailand #
TJTajikistan
TKTokelau
TMTurkmenistan
TNTunisia
TOTonga
TRTurkey
TTTrinidad and Tobago #
TVTuvalu
TWTaiwan
TZTanzania
UAUkraine
UGUganda
US_AKUnited States/Alaska
US_ALUnited States/Alabama
US_ARUnited States/Arkansas
US_AZUnited States/Arizona
US_CAUnited States/California
US_COUnited States/Colorado
US_CTUnited States/Connecticut
US_DCUnited States/District of Columbia
US_DEUnited States/Delaware
US_FLUnited States/Florida
US_GAUnited States/Georgia
US_HIUnited States/Hawaii
US_IAUnited States/Iowa
US_IDUnited States/Idaho
US_ILUnited States/Illinois
US_INUnited States/Indiana
US_KSUnited States/Kansas
US_KYUnited States/Kentucky
US_LAUnited States/Louisiana
US_MAUnited States/Massachusetts
US_MDUnited States/Maryland
US_MEUnited States/Maine
US_MIUnited States/Michigan
US_MNUnited States/Minnesota
US_MOUnited States/Missouri
US_MSUnited States/Mississippi
US_MTUnited States/Montana
US_NCUnited States/North Carolina
US_NDUnited States/North Dakota
US_NEUnited States/Nebraska
US_NHUnited States/New Hampshire
US_NJUnited States/New Jersey
US_NMUnited States/New Mexico
US_NVUnited States/Nevada
US_NYUnited States/New York
US_OHUnited States/Ohio
US_OKUnited States/Oklahoma
US_ORUnited States/Oregon
US_PAUnited States/Pennsylvania
US_RIUnited States/Rhode Island
US_SCUnited States/South Carolina
US_SDUnited States/South Dakota
US_TNUnited States/Tennessee
US_TXUnited States/Texas
US_UTUnited States/Utah
US_VAUnited States/Virginia
US_VTUnited States/Vermont
US_WAUnited States/Washington
US_WIUnited States/Wisconsin
US_WVUnited States/West Virginia
US_WYUnited States/Wyoming
UYUruguay
UZUzbekistan
VCSt Vincent and Grenadines
VEVenezuela
VGBritish Virgin Islands
VIU.S. Virgin Islands
VNViet Nam
VUVanuatu
WFWallis and Futuna Islands
WSSamoa
YEYemen
YTMayotte
YUSerbia and Montenegro
ZASouth Africa
ZMZambia
ZWZimbabwe
Provide the eternal holiday list additionally with the starting dates of the common and leap months, as they result from the Bahá’ì calendar. See Calendar option --bahai-holidays, for further details.
Provide the eternal holiday list additionally with the starting dates of the common and leap months, as they result from the Chinese calendar, that is determined in a flexible manner. See Calendar option --chinese-flexible-holidays, for further details.
Provide the eternal holiday list additionally with the starting dates of the common and leap months, as they result from the Chinese calendar. See Calendar option --chinese-holidays, for further details.
Provide the eternal holiday list additionally with the starting dates of the common and leap months, as they result from the Coptic calendar (only for dates after AD 283).
Provide the eternal holiday list additionally with the starting dates of the common and leap months, as they result from the Ethiopic calendar.
Provide the eternal holiday list additionally with the starting dates of the common and leap months, as they result from the French Revolutionary calendar (only for dates after AD 1791).
Provide the eternal holiday list additionally with the starting dates of the common and leap months, as they result from the Hebrew calendar.
Provide the eternal holiday list additionally with the starting dates of the common and leap months, as they result from the civil Indian calendar (only for dates after AD 1956).
Provide the eternal holiday list additionally with the starting dates of the common and leap months, as they result from the civil Islamic calendar. See Calendar option --islamic-civil-holidays, for further details.
Provide the eternal holiday list additionally with the starting dates of the common and leap months, as they result from the Japanese calendar, that is determined in a flexible manner. See Calendar option --japanese-flexible-holidays, for further details.
Provide the eternal holiday list additionally with the starting dates of the common and leap months, as they result from the Japanese calendar. See Calendar option --japanese-holidays, for further details.
Provide the eternal holiday list additionally with the starting dates of the common and leap months, as they result from the Old-Armenic calendar (only for dates after AD 551).
Provide the eternal holiday list additionally with the starting dates of the common and leap months, as they result from the Old-Egyptic calendar.
Provide the eternal holiday list additionally with the starting dates of the common and leap months, as they result from the Persian Jalaali calendar. See Calendar option --persian-jalaali-holidays, for further details.
To obtain the standard calendar format17, either start Gcal omitting the -i[-] option because it is set by default, Aspects in Internationalization, or start Gcal with the -i- respectively --type=standard option:
$ 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 obtain the special calendar format, start Gcal with the -i respectively --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
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 hundreds 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 hundreds 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.
Provide the calendar sheet with week numbers. See Calendar option --starting-day=argument, Calendar option --iso-week-number=yes|no, and Aspects in Internationalization, for further details.
Determine the type of week numbers which are used in the calendar sheet, in the fixed date list and by the %date actual date modifier. See Calendar option --starting-day=argument, and Aspects in Internationalization, for more details.
The methods of the ISO-8601:1988 are used for detecting week numbers; this means a week starts on Mondays, and the first week of a year is the one which includes the first Thursday; equivalently, the one which includes the 4th January. This method is called ISO week number in the further context. If the starting day of the week is not set to Monday, 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!
Weeks start on the respective starting day of the week, and the days in a new year that are preceding the first starting day of the week are in the last week of the previous year, respectively in week zero of the new year. This method is called standard week number in the further context.
Suppress output of calendar sheet explicitly.
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!
Displays one block with twelve months at a time.
Displays two blocks with six months at a time.
Displays three blocks with four months at a time.
Displays four blocks with three months at a time.
Displays six blocks with two months at a time.
Displays twelve blocks with one month at a time.
Use alternative date format in calendar sheet instead of the default standard format which displays the days of month in consecutive manner.
Display the calendar sheet by using the special date format. This means, the days of year are displayed in consecutive manner instead of the days of month.
Display the calendar sheet by using both the standard date format and special date format.
Use alternative date format in eternal holiday list instead of the default standard format which displays the days of month in consecutive manner. See Calendar option --holiday-list[=long|short].
Display the eternal holiday list by using the special date format. This means, the days of year are displayed in consecutive manner instead of the days of month.
Display the eternal holiday list by using both the standard date format and special date format.
Use alternative date format in fixed date list instead of the default standard format which displays the days of month in consecutive manner. See Fixed date option --list-of-fixed-dates[=short|long].
Display the fixed date list by using the special date format. This means, the days of year are displayed in consecutive manner instead of the days of month.
Display the fixed date list by using both the standard date format and special date format.
Set the starting day of the 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 the week is set to the actual weekday as it is delivered by the system date. See Aspects in Internationalization, for more details.
Change the base time of the astronomical functions (valid argument: t|@|[t|@][+|-]mmmm|hh:[mm]).
If no --time-offset=argument option is given, the astronomical data that is inserted into the eternal holiday list by the --astronomical-holidays option (see Calendar option --astronomical-holidays), and all Sun and Moon related special texts are always calculated for 0 o’clock Universal time (UTC/GMT), thus civil midnight time.
See Sun data, and Moon data, likewise Moon phase, for further information.
The argument is either the ‘t’ or the ‘@’ character
—where ‘t’ means a relation to the actual local time18 and ‘@’ denotes a
relation to the actual Universal time—, or one of these characters followed
by a displacement value, or only a displacement value which has to be
specified either by using the
[+|-]mmmm format or the
[+|-]hh:[mm] format.
[+|-]mmmm adds respectively subtracts
the specified amount of minutes mmmm from the base time value 0
o’clock Universal time (range 0…9999), while
[+|-]hh:[mm] adds respectively
subtracts the given amount of hours hh (range 0…99)
and minutes mm (range 0…59) from the base time value
0 o’clock Universal time. The displacement value is always added to the
base time value 0 o’clock Universal time in case it is specified without
a +|- sign.
For example, the --time-offset=+1: option causes that while displaying eternal holiday lists and fixed date lists, the time 0 o’clock of the timezone GMT-1 (≡ CET) is used as the base time by the astronomical functions instead of the base time 0 o’clock Universal time (≡ GMT).
For example, the --time-offset=t-2: option causes that while displaying eternal holiday lists and fixed date lists, the time that is two hours earlier than the actual local time is used as the base time by the astronomical functions instead of the base time 0 o’clock Universal time (≡ GMT). For such a kind of relation, the term relative time offset value will be used in the further context.
Change the base year of calendar (valid argument: -9999…[+]9999).
For example, the --transform-year=-543 option causes that while displaying calendar sheets, eternal holiday lists and fixed date lists, the year 543 BC is used as the base year of the calendar instead of the year AD 1. This results in the case that —for example— for the year 1999 (Christian era), the year number 1999 is not used in the above mentioned outputs, but the year number 2542 which is used in the western oriented Thai calendar.
Nevertheless, Gcal does not respect the --transform-year=argument option when using the actual date modifier %date (see Actual date modifier), the commands (see Commands), and the fixed date entries in a resource file (see Date part of a line). There, all references made to a definite year are always treated in the way that the year AD 1 is the base year of the calendar, so in fact it is only possible to use references based on the Christian era.
Set the period which was skipped during the Gregorian Reformation. By default, Gcal runs in the hybrid calendar mode, i.e. Gcal automatically changes from the Julian calendar system to the Gregorian calendar system if output is related to dates after the Gregorian Reformation has happened. See 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 has occurred from 5th till 14th October 1582.
If Gcal is called with the --gregorian-reform=1700 option, it assumes the Gregorian Reformation has occurred from 19th till 28th February 1700.
If Gcal is called with the --gregorian-reform=1752 option, it assumes the Gregorian Reformation has occurred from 3rd till 13th September 1752.
If Gcal is called with the --gregorian-reform=1753 option, it assumes the Gregorian Reformation has occurred from 18th till 28th February 1753.
In case another period shall be respected, it can be arranged by the option argument like ‘yyyyy,mm,first-day,last-day’. If the Gregorian Reformation has occurred for example on the 7th till the 17th April 1802, this can be arranged as follows:
--gregorian-reform=1802,4,7,17
Gcal is able to represent so-called proleptic calendars of a definite calendar system. This means, Gcal only uses a definite calendar system during a definite period, although there was a change to another calendar system in the historic reality during this definite period. The following proleptic calendar systems are actually supported by Gcal:
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 has occurred) if the argument of the --gregorian-reform option is not used with care.
Set the date format which affects the ordering and representation of a displayed date. See 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 day-of-year numbers instead of the day-of-month numbers must be displayed, or both types of numbers are used in a combined manner.
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 ‘%<2#K, %1%>2*D%2 %<3#U %>04*Y’ date format text is used.
This result in that a date is displayed by using the
‘ww, dd mmm yyyy’ ordering, for
example ‘Sa, 28 Aug 1999’.
If Gcal is called with the --date-format=us option,
the ‘%<3#K, %<3#U %1%>2&*D%2 %>04*Y’ date format text is used.
This result in that a date is displayed by using the
‘www, mmm dd yyyy’ ordering, for
example ‘Sat, Aug 28th 1999’.
If Gcal is called with the --date-format=gb option,
the ‘%<3#K, %1%>2&*D%2 %<3#U %>04*Y’ date format text is used.
This result in that a date is displayed by using the
‘www, dd mmm yyyy’ ordering, for
example ‘Sat, 28th Aug 1999’.
In case another format text shall be respected, this format
text can either be set in the GCAL_DATE_FORMAT environment
variable20, or it can be arranged by the option argument text. For
example, ‘--date-format='%Y %D %>02*M ; %1(%>5u#K)%2'’
displays a date by using the
‘[[[y]y]y]y [d]d mm ; (wwwww)’
ordering, thus for example ‘1999 28 08 ; (SATUR)’.
See Environment Variable GCAL_DATE_FORMAT,
for further information.
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 elements which are transformed into their according values at run-time. Some format elements may have a format instruction which is called format in the further context. See Format Instruction, for the detailed description of the format instruction and its components.
A minimum date format text must contain the following format elements minimum:
The day number, one component of the month group, the year number and both components of the highlighting group.
A weekday name format element may be included optionally into the date format text. The following format elements and character replacement instructions are currently supported:
%[format]DDay number (must be defined)
%[format]YYear number (must be defined)
%[format]KWeekday name (may be defined)
Month group (exactly one member must be defined):
%[format]MMonth number
%[format]UMonth name
Highlighting group (all members must be defined and %1
must be specified before %2):
%1Start of highlighting sequence / marking character
%2End of highlighting sequence / marking character
Character replacement instructions:
_Space/blank character ‘’
\_Underscore character ‘_’
\%Percent character ‘%’
\\Backslash character ‘\’
See Table of Obsolete Date Formats, and Table of Obsolete Date Format Elements, for further information.
Define the country specific special character pairs which are respected or translated by a style format instruction component, respectively. See Format Instruction, for the detailed description of the format instruction and its components. The country specific special character pairs are arranged by the text option argument as a sequence of single character pairs, and that in any number and order. The upper-case representation of the country specific special character has to be specified at first, and after that its lower-case representation. Country specific special characters which do not have an upper-case resp., lower-case representation in the character set used, like e.g. the ‘ß’-character which is very usual in the German character set, are also specified as a special character pair (here: ‘ßß’), otherwise these special characters are not recognized and they are converted incorrectly by the style format instruction component. In case the lower-case representation of the country specific special character is specified at first, and after that its upper-case representation, this option does not cause any further affects to the style format instruction component; resulting, the country specific special characters specified are not recognized as such and they remain untranslated therefore.
For example, a ‘ÄäÖöÜüßß’ option argument causes the correct conversion of the preceding special characters in an individual date format, which has a style format instruction component, and that, how they are used by the character set used in Germany.
Next: Fixed date options, Previous: Global options, Up: Options [Contents][Index]