レシピ——「書けない」と言われてきたスケジュールの実用形
cron・Quartz・iCalendar RRULE で「書けない」と長く言われてきたスケジュール要求を、 1 要求 1 ページの実用形で示す。各ページは「何が起きるか(出典つき)→ Kairos の式 (実行検証済み)→ ブラウザで試す」の順——答えを最初に、経緯は後に。
| ページ | 要求 |
|---|---|
| 月末・月末最終営業日 | cron 最頻出の挫折点。営業日版まで |
| イースターの日付 | RRULE が書けない移動祝日の代表。データゼロの純算術 |
| 4-4-5 会計暦とは | 定義・4-5-4/5-4-4 の変種・第 53 週の扱い・2026 年の期間表。繰上げ規則は定義の形から出る |
| 15 日に最も近い平日 | Quartz 15W の一般形。祝日対応まで |
| 米国の選挙日・ブラックフライデー・感謝祭の次の日曜 | 計算で決まる日を基準にした相対日。RRULE の BYMONTHDAY=2..8 符号化を法律の言葉の順に |
| Windows Update の日(Patch Tuesday) | 太平洋時間の第 2 火曜 10 時を各地の時刻で。定義は 1 つ・表示 tz だけ変える。「日本では第 2 水曜 3 時」がなぜ 8/12 か月で外れるか |
| Windows 管理者のための Kairos | PowerShell とタスク スケジューラだけで動かす。定義→list→--json→毎日の判定→Outlook の .ics。開発はしない人向け |
| Excel の WORKDAY・EOMONTH で書きにくいスケジュール | 月末最終営業日・25 日払い・第 10 営業日・四半期末の 3 営業日前を Excel の式と並べる。祝日表の期限切れを黙らせない。結果は TSV で Excel へ |
| 休配日と着日——物流の営業日カレンダー | 日祝・年末年始・お盆の休配日から営業日を作り、着日(出荷日+N 営業日)・15 時の締め・定期便・年末年始の帯を定義から出す。営業日マスタと休配日マスタを TSV で。年次更新は再生成と検算で |
| カレンダー(穴埋め→月めくり→印刷・.ics) | 暮らしの予定 5 本(資源ごみ・燃えるごみ・給料日・目覚まし・習い事)を穴埋めで決める。式は裏で組む(折りたたみで見える)。月めくり(週の始まりは式の wkst)・A4 に 1 月 1 枚の印刷・.ics・Playground との往復 |
- コード例はすべてリファレンス実装の doctest(
impl/test/doctest.test.ts)が実行検証する。# eval:が評価範囲・#=>が期待値(規約は reference)。@JPを使う例には標準前提(Gregorian・Asia/Tokyo・wkst: Mon・2026 年の確定祝日つき カレンダー実体)が自動で前置される。 - 各ページの Playground リンクは前提込みの自己完結形——ブラウザでそのまま実行・編集できる (Playground はリファレンス実装をそのまま動かす。サーバー送信なし)。
- 収集した「書けない」実例の全カタログ(32 項目・出典つき)と三分類は 調査研究 11。本レシピ集はその実測節の 実用形への再構成。
- 言語自体の説明は言語仕様・語彙は記述語リファレンス。
共有 URL の形
Playground の「URL に固定」とカレンダーの共有 URL は同じ形。 式と評価範囲を URL のハッシュに載せる——サーバーも保存もない。この 4 項目と符号化は公開の約束(2026-10-30)で、以後変えない。
https://kairos-lang.org/playground/#s=<source>&f=<from>&t=<to>&z=<tz>
| 項目 | 意味 | 形 |
|---|---|---|
s |
ソース全文(前文込みの自己完結形) | UTF-8 のバイト列を base64url(RFC 4648 §5・+→-・/→_・末尾の = なし) |
f |
評価範囲の始点(含む) | YYYY-MM-DD |
t |
評価範囲の終点(含まない=半開 [f, t)) |
YYYY-MM-DD |
z |
表示と範囲の端の tz | IANA 名(例 Asia/Tokyo)。省略時は Asia/Tokyo |
- カレンダーは同じハッシュに
e=<例の id>&v=<穴の値をカンマ区切り>を添える(カレンダーだけが読む。Playground はs・f・t・zだけを読む)。 - ブラウザで作る・戻す関数は
playground/core.jsのb64e/b64d。Node ならBuffer.from(src, 'utf8').toString('base64url')と同じ値。 - 購読(webcal)や利用者ごとの保存は言語側のページでは行わない——式と範囲をこの形で渡す先(供給側)が持つ。