名称

calendar — カレンダサービス

書式

calendar

[ -A num][ -a][ -B num][ -D moon|sun][ -d][ -F friday][ -f calendarfile][ -l longitude][ -t dd[ . mm[ . year]]][ -U UTC-offset][ -W num]

解説

calendar ユーティリティは、 calendar と名前が付けられたファイルがカレントディレクトリにあるかチェックして、指定された日付の範囲に一致する行を表示します。週末の前日 (通常金曜日) には、次の 3 日間のイベントを表示します。

次のオプションが、利用可能です:

-A num: 今日から、次の num 日 (今後の将来) の行を印刷します。
-a: すべてのユーザの ``calendar'' ファイルを処理し、結果を各ユーザにメールします。これは、スーパユーザの特権を必要とします。
-B num: 今日から、以前の num (後方の過去) の行を印刷します。
-D moon|sun: UTC オフセット、経度 (longitude) および月または太陽の情報を印刷 (表示) します。
-d: デバッグオプション: 現在の日付情報を印刷 (表示) します。
-F friday: 週のどの日が ``金曜日'' (週末が始まる前の日) であるかを指定します。デフォルトは、5 です。
-f calendarfile: デフォルトの calendar ファイルとして calendarfile を使用します。
-l longitude: この経度 (longitude) から月と太陽の計算を実行します。経度 (longitude) も UTC オフセットも指定されないなら、計算は、UTC 時間とローカルタイムの違いに基づきます。両方が指定されるなら、UTC オフセットが、経度 (longitude) に優先します。
-t dd[ . mm[ . year]]: テストの目的のみに: 直接、引数の値に日付を設定します。
-U UTC-offset: この UTC オフセットから月と太陽の計算を実行します。 UTC オフセットも経度 (longitude) も指定されないなら、計算は、UTC 時間とローカルタイムの違いに基づきます。両方が指定されるなら、UTC オフセットが、経度 (longitude) に優先します。
-W num: 今日から、次の num 日 (今後の将来) の行を印刷します。日数を計算するとき、週末を無視します。

ファイル形式

利用者の国のコードテーブルでカレンダを扱うために、利用者は、カレンダファイルのできるだけ始めのほうに“LANG=<locale_name>”を指定することができます。

ローカル名のシーケンスを扱うために、次のように指定できます: できるだけ早くカレンダファイルで、“SEQUENCE=<first> <second> <third> <fourth> <fifth> <last>”

次の特別な日の名前が認識されます:

これらの名前は、カレンダファイルで“Easter=Pasen”のような代入でそれらのローカル名に再割り当てされます。

他の行は、月と日で始まるべきです。それらは、数値または文字列として、ほとんど任意の形式で入力できます。適切なロケールが設定されているなら、その国の月と週の名前を使用することができます。単一のアスタリスク (``*'') は、すべての月にマッチします。月がない日付は、毎週の日付にマッチします。日付のない月は、その月の 1 日にマッチします。日付のあとに続いた 2 つの数値は、月とみなします。先導するタブがある行は、単一の日付に対して複数の行で記述することができる、直前に入力された日付の続きとみなされます。

認識される特別な日の名前は、次のように、正または負の整数が続くかもしれません: “Easter+3”または“Paskha-4”。

``4 月の最後の月曜日'' のような変動する行事のために、平日の後に ``-4'' ... ``+5'' (最後、最初、2 番目、3 番目、4 番目の別名) を続けることができます。

慣例により、アスタリスクが続く日付は、固定ではありません、すなわち、年ごとに変更されます。

その日の記述は、行の最初 <タブ>文字の後から始まります。行に <タブ>文字を含んでいないなら、表示されません。行の最初の文字が <タブ>文字であるなら、前の行の継続として扱われます。

calendar ファイルは、会社の休日またはミーティングのリストのような共有ファイルをインクルードすることができるように、内部的に cpp(1) の制限されたサブセットによって前処理されます。この制限のあるサブセットは、 #include #ifndef #endif と #define から成ります。共有ファイルがフルパス名によって参照されていなら、 calendar(1) は、最初にカレント (またはホーム) ディレクトリを検索し、次にディレクトリ /usr/share/calendar を検索します。空の行と C のコメントの構文 ( /* ... */) によって保護された行は、無視されます。

いくつかの指定できる calendar エントリは、次の通りです (<タブ>文字は、 \t シーケンスよって強調されています):

LANG=C 
Easter=Ostern 
 
#include <calendar.usholiday> 
#include <calendar.birthday> 
 
6/15\tJune 15 (if ambiguous, will default to month/day). 
Jun. 15\tJune 15. 
15 June\tJune 15. 
Thursday\tEvery Thursday. 
June\tEvery June 1st. 
15 *\t15th of every month. 
2010/4/15\t15 April 2010 
 
May Sun+2\tsecond Sunday in May (Muttertag) 
04/SunLast\tlast Sunday in April, 
\tsummer time in Europe 
Easter\tEaster 
Ostern-2\tGood Friday (2 days before Easter) 
Paskha\tOrthodox Easter

互換性

以前に、 calendar プログラムは、行のどこにでも正しい日付がある行を選択していました。これは、もはや正しくありません、日付は、行の始めにある場合のみ認識されます。

歴史

calendar コマンドは、 Version 7 AT&T UNIX で登場しました。

注

中国の正月は、おおよそ中国の東海岸に対応する、グリニッジの 120 度東で計算されます。中国の西の人々に関しては、これは、中国の正月の始まりと関連する新月が異なる結果となるかもしれません。

月の位相と太陽の経度は、グリニッジの方向の時差の 30 度の時刻に対応するローカルな位置に対して計算されます。

新月と満月は、次に示された日に起こります: それらは、夜早い時間または深夜の期間に起こるかもしれません。それらが、その日の夜に始まることを示していません。

使用される公式の出力とインターネットの他のソースとのわずかな相違点のために、 Druids と Werewolves は、太陽と月のイベントの始めと終わりの時間を 2 重にチェックをするべきです。

バグ

calendar の内部的な cpp は、正確に #ifndef を行わず、#ifndef がトリガされるなら、ファイルの残りを廃棄します。また、それは、最大 50 のインクルードファイルおよび 100 の #define があり、 #include、#define と #ifndef のみ解釈します。

太陽と月の計算に必要なローカル位置を適切に指定することができません。

YOS OPENSONAR

名称

書式

解説

ファイル形式

関連ファイル

互換性

関連項目

歴史

注

バグ