1CALENDAR(1) BSD General Commands Manual CALENDAR(1)
2
4 calendar — reminder service
5
7 calendar [-abw] [-A num] [-B num] [-f calendarfile] [-t [[[cc]yy]mm]dd]
8
10 The calendar utility checks the current directory or the directory speci‐
11 fied by the CALENDAR_DIR environment variable for a file named calendar
12 and displays lines that begin with either today's date or tomorrow's. On
13 Fridays, events on Friday through Monday are displayed.
14 The options are as follows:
16 -A num Print lines from today and next num days (forward, future).
18 -a Process the “calendar” files of all users and mail the results to
20 them. This requires superuser privileges.
21 -B num Print lines from today and previous num days (backward, past).
23 -b Enforce special date calculation mode for Cyrillic calendars.
25 -f calendarfile
27 Use calendarfile as the default calendar file.
28 -t [[[cc]yy]mm]dd
30 Act like the specified value is “today” instead of using the cur‐
31 rent date. If yy is specified, but cc is not, a value for yy
32 between 69 and 99 results in a cc value of 19. Otherwise, a cc
33 value of 20 is used.
34 -w Print day of the week name in front of each event.
36 To handle calendars in your national code table you can specify
38 “LANG=<locale_name>” in the calendar file as early as possible. To han‐
39 dle national Easter names in the calendars, “Easter=<national_name>” (for
40 Catholic Easter) or “Paskha=<national_name>” (for Orthodox Easter) can be
41 used.
42 The “CALENDAR” variable can be used to specify the style. Only ‘Julian’
44 and ‘Gregorian’ styles are currently supported. Use “CALENDAR=” to
45 return to the default (Gregorian).
46 To enforce special date calculation mode for Cyrillic calendars you
48 should specify “LANG=<local_name>” and “BODUN=<bodun_prefix>” where
49 <local_name> can be ru_RU.UTF-8, uk_UA.UTF-8 or by_BY.UTF-8.
50 Other lines should begin with a month and day. They may be entered in
52 almost any format, either numeric or as character strings. If proper
53 locale is set, national months and weekdays names can be used. A single
54 asterisk (`*') matches every month. A day without a month matches that
55 day of every week. A month without a day matches the first of that
56 month. Two numbers default to the month followed by the day. Lines with
57 leading tabs default to the last entered date, allowing multiple line
58 specifications for a single date. “Easter” (may be followed by a posi‐
59 tive or negative integer) is Easter for this year. “Paskha” (may be fol‐
60 lowed by a positive or negative integer) is Orthodox Easter for this
61 year. Weekdays may be followed by “-4” ... “+5” (aliases last, first,
62 second, third, fourth) for moving events like “the last Monday in April”.
63 By convention, dates followed by an asterisk (‘*’) are not fixed, i.e.,
65 change from year to year.
66 Day descriptions start after the first <tab> character in the line; if
68 the line does not contain a <tab> character, it isn't printed out. If
69 the first character in the line is a <tab> character, it is treated as
70 the continuation of the previous description.
71 The calendar file is preprocessed by cpp(1), allowing the inclusion of
73 shared files such as company holidays or meetings. If the shared file is
74 not referenced by a full pathname, cpp(1) searches in the current (or
75 home) directory first, and then in the directory /usr/share/calendar.
76 Empty lines and lines protected by the C commenting syntax (/* ... */)
77 are ignored.
78 Some possible calendar entries (a \t sequence denotes a <tab> character):
80 LANG=C
82 Easter=Ostern
83 #include <calendar.usholiday>
85 #include <calendar.birthday>
86 6/15\tJune 15 (if ambiguous, will default to month/day).
88 Jun. 15\tJune 15.
89 15 June\tJune 15.
90 Thursday\tEvery Thursday.
91 June\tEvery June 1st.
92 15 *\t15th of every month.
93 May Sun+2\tsecond Sunday in May (Muttertag)
95 04/SunLast\tlast Sunday in April,
96 \tsummer time in Europe
97 Easter\tEaster
98 Ostern-2\tGood Friday (2 days before Easter)
99 Paskha\tOrthodox Easter
100
102 calendar File in current directory.
103 ~/.calendar Directory in the user's home directory (which
104 calendar changes into, if it exists).
105 ~/.calendar/calendar File to use if no calendar file exists in the cur‐
106 rent directory.
107 ~/.calendar/nomail calendar will not send mail if this file exists.
108 calendar.all International and national calendar files.
109 calendar.birthday Births and deaths of famous (and not-so-famous)
110 people.
111 calendar.canada Canadian holidays.
112 calendar.christian Christian holidays (should be updated yearly by the
113 local system administrator so that roving holidays
114 are set correctly for the current year).
115 calendar.computer Days of special significance to computer people.
116 calendar.croatian Croatian calendar.
117 calendar.discord Discordian calendar (all rites reversed).
118 calendar.fictional Fantasy and fiction dates (mostly LOTR).
119 calendar.french French calendar.
120 calendar.german German calendar.
121 calendar.history Miscellaneous history.
122 calendar.holiday Other holidays (including the not-well-known,
123 obscure, and really obscure).
124 calendar.judaic Jewish holidays (should be updated yearly by the
125 local system administrator so that roving holidays
126 are set correctly for the current year).
127 calendar.music Musical events, births, and deaths (strongly ori‐
128 ented toward rock n' roll).
129 calendar.nz New Zealand calendar.
130 calendar.openbsd OpenBSD related events.
131 calendar.pagan Pagan holidays, celebrations and festivals.
132 calendar.russian Russian calendar.
133 calendar.space Cosmic history.
134 calendar.uk UK calendar.
135 calendar.ushistory U.S. history.
136 calendar.usholiday U.S. holidays.
137 calendar.world World wide calendar.
138
140 at(1), cal(1), cpp(1), mail(1), cron(8)
141
143 The calendar program previously selected lines which had the correct date
144 anywhere in the line. This is no longer true: the date is only recog‐
145 nized when it occurs at the beginning of a line.
146
148 A calendar command appeared in Version 7 AT&T UNIX.
149
151 calendar doesn't handle all Jewish holidays or moon phases.
152BSD June 20, 2019 BSD