@HOLIDAY
— returns
the date of a specific day of the week within a month (e.g., the second
Monday in October.) The date may be returned in
any output date format supported
by this plugin. If no output format is specified, it defaults to the
local date format with a four-digit year.
Syntax:
%@HOLIDAY[
index,
dow,
month,
year,
fmt,
offset]
index | the position of the day-of-the-week within month; 1 = first, 2 = second, 3 = third, 4 = fourth, 5 = final |
dow | the day of the week: 1 = Monday, 2 = Tuesday, etc.; or MON … SUN |
month | the month in which the holiday falls: 1 = January, 2 = February, etc., or JAN … DEC |
year | four digits, 1601 - 9999; * next occurrence; if omitted, defaults to the current year |
fmt | the date format used to return the date; defaults to 256 |
offset | optional number of days to add to (or subtract from) the resulting date; useful for e.g. Election Day |
For example, to see when Thanksgiving falls this year: (Thanksgiving Day is the fourth Thursday in November.)
qcal %@holiday[4,thu,nov]
If you specify an asterisk for the year,
@HOLIDAY
will return the next matching holiday after
today’s date.
• New: This function does not exist in Take Command.
A few U.S. federal holidays and other days: | |
Martin Luther King, Jr. Day | %@holiday[3,mon,jan] |
Washington’s Birthday | %@holiday[3,mon,feb] |
Daylight Saving Time begins | %@holiday[2,sun,mar] |
Mother’s Day | %@holiday[2,sun,may] |
Memorial Day | %@holiday[5,mon,may] |
Father’s Day | %@holiday[3,sun,jun] |
Labor Day | %@holiday[1,mon,sep] |
Columbus Day | %@holiday[2,mon,oct] |
Daylight Saving Time ends | %@holiday[1,sun,nov] |
Election Day (even years only) | %@holiday[1,mon,nov,,,1] |
Thanksgiving Day | %@holiday[4,thu,nov] |