Japanese Calendar API

日本の祝日・販促イベント・六曜・暦注・営業日計算 API

祝日・販促向け一般イベント・六曜・旧暦・十干十二支・二十四節気、そして営業日計算を、ひとつの公開 API で提供します。祝日データは内閣府が公表する「国民の祝日について」CSV を Source of Truth とします。

Swagger UI OpenAPI JSON Holiday JSON

今日

Today —

—

六曜: —
イベント: —
干支: —
旧暦: —
節気: —

ダウンロード

iCalendar はカレンダーアプリにそのまま購読登録できます。CSV は Excel 互換のため UTF-8 BOM 付きです。

サンプル

# API_ORIGIN には利用中の公開 URL を指定してください
$ API_ORIGIN=https://your-domain.example

# 全期間の祝日マップ（holidays-jp/api 互換）
$ curl "$API_ORIGIN/v1/holidays.json"
{
  "2026-01-01": "元日",
  "2026-01-12": "成人の日",
  "2026-02-11": "建国記念の日",
  "2026-02-23": "天皇誕生日",
  ...
}

# 指定日の祝日判定
$ curl "$API_ORIGIN/v1/holidays/2026-05-03"
{ "date": "2026-05-03", "is_holiday": true, "name": "憲法記念日" }

# 指定日の販促向け一般イベント
$ curl "$API_ORIGIN/v1/events/2026-05-10"
{ "date": "2026-05-10", "events": [
  { "date": "2026-05-10", "id": "mothers-day", "name": "母の日",
    "category": "gift", "rule": "5月第2日曜日" }
] }

# 指定日の六曜
$ curl "$API_ORIGIN/v1/rokuyo/2026-05-03"
{ "date": "2026-05-03", "rokuyo": "先勝" }

# 指定日の旧暦
$ curl "$API_ORIGIN/v1/lunar/2026-05-03"
{ "date": "2026-05-03", "lunar": { "year": 2026, "month": 3, "day": 17,
  "is_leap_month": false, "month_name": "三", "day_name": "十七" } }

# 指定日の十干十二支
$ curl "$API_ORIGIN/v1/kanshi/2026-05-03"
{ "date": "2026-05-03", "kanshi": {
  "year":  { "stem": "丙", "branch": "午", "name": "丙午" },
  "month": { "stem": "壬", "branch": "辰", "name": "壬辰" },
  "day":   { "stem": "丁", "branch": "丑", "name": "丁丑" } } }

# 指定日の二十四節気（当日／前後）
$ curl "$API_ORIGIN/v1/solar-terms/2026-05-03"
{ "date": "2026-05-03", "solar_term": null,
  "previous": { "date": "2026-04-20", "name": "谷雨", "kind": "qi", "kind_name": "中" },
  "next":     { "date": "2026-05-05", "name": "立夏", "kind": "jie", "kind_name": "節" } }

# 期間内の営業日数（土日・祝日除く、最大 4000 日）
$ curl "$API_ORIGIN/v1/business-days?from=2026-04-01&to=2026-04-30"
{ "from": "2026-04-01", "to": "2026-04-30", "business_days": 21 }

# 営業日加算（休業日に当たる分だけ後ろへ繰り越す）
$ curl "$API_ORIGIN/v1/business-days/add?from=2026-04-24&days=3&closed=2026-04-28&exclude_weekends=true&exclude_holidays=true"
{ "from": "2026-04-24", "days": 3,
  "exclude_weekends": true, "exclude_holidays": true, "date": "2026-05-01",
  "calendar_days": 7, "skipped_days": [
    { "date": "2026-04-25", "reason": "weekend" },
    { "date": "2026-04-26", "reason": "weekend" },
    { "date": "2026-04-28", "reason": "custom_closed" },
    { "date": "2026-04-29", "reason": "holiday", "name": "昭和の日" }
  ] }

エンドポイント

祝日
`GET /v1/holidays.json`	全期間の祝日マップ
`GET /v1/holidays/{year}.json`	年別の祝日マップ
`GET /v1/holidays/{date}`	指定日（YYYY-MM-DD）の祝日判定
`GET /v1/holidays/next`	基準日以降で最も近い祝日
`GET /v1/between`	期間内の祝日配列
`GET /v1/business-days`	期間内の営業日数（最大 4000 日）
`GET /v1/business-days/add`	休業日に当たる分だけ後ろへ繰り越す営業日加算
イベント
`GET /v1/events`	母の日・ブラックフライデーなど販促向け一般イベントの年別一覧
`GET /v1/events/{date}`	指定日の販促向け一般イベント
`GET /v1/events/between`	期間内の販促向け一般イベント（最大 4000 日）
`GET /v1/events/next`	基準日以降で最も近い販促向け一般イベント。分類で絞り込み可能
暦
`GET /v1/rokuyo/{date}`	指定日の六曜（先勝・友引・先負・仏滅・大安・赤口）
`GET /v1/rokuyo/next`	基準日以降で最も近い指定六曜（大安など）
`GET /v1/lunar/{date}`	指定日の旧暦（年月日・閏月フラグ）
`GET /v1/kanshi/{date}`	指定日の十干十二支（年・月・日）
`GET /v1/solar-terms/{date}`	指定日の二十四節気と前後の節気

詳細は Swagger UI または openapi.json を参照してください。

運用

無料で公開しています。祝日データは内閣府「国民の祝日について」CSVを週次で自動取得します。