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