営業日数API by udcxx.

日本の各月ごとの営業日や祝日などの日数を取得することができるAPIです。

目次

URL

https://app.udcxx.me/api/workday/

HTTPメソッド

GET

文字コード

UTF-8

リクエストパラメーター

パラメーター値必須内容
y1960 以上 2100 以下の数値No年を指定します
m1 以上 12 以下の数値No月を指定します
c項目の省略名No取得したい項目を指定します

データの項目

項目名省略名内容
daydayその月の日数（例：30）
weekenddayendその月の土日の数（例：9）
holidayholその月の祝日数（例：1）
weekend_and_holidaywahその月の土日数 + 祝日数（例：10）
祝日が土日に被る場合は重複してカウントしません。
weekdayweekその月の日数 - 土日祝数（例：20）
workdayworkその月の営業日数（例：20）
12/29 - 1/3 が含まれる場合、平日数から引かれます
estimatedest政府からの正式な発表前の祝日かどうか（論理値）（例：False）
Trueの場合、推定値のため、変更される可能性があります。

実行例

2023年の1年分のデータを取得する場合

リクエスト

https://app.udcxx.me/api/workday/?y=2023

レスポンス

レスポンス内容を確認する 
                
{
    "1": {
        "day": 31,
        "weekendday": 9,
        "holiday": 3,
        "weekend_and_holiday": 11,
        "weekday": 20,
        "workday": 19,
        "estimated": "FALSE"
    },
    "2": {
        "day": 28,
        "weekendday": 8,
        "holiday": 2,
        "weekend_and_holiday": 9,
        "weekday": 19,
        "workday": 19,
        "estimated": "FALSE"
    },
    "3": {
        "day": 31,
        "weekendday": 8,
        "holiday": 1,
        "weekend_and_holiday": 9,
        "weekday": 22,
        "workday": 22,
        "estimated": "FALSE"
    },
    "4": {
        "day": 30,
        "weekendday": 10,
        "holiday": 1,
        "weekend_and_holiday": 10,
        "weekday": 20,
        "workday": 20,
        "estimated": "FALSE"
    },
    "5": {
        "day": 31,
        "weekendday": 8,
        "holiday": 3,
        "weekend_and_holiday": 11,
        "weekday": 20,
        "workday": 20,
        "estimated": "FALSE"
    },
    "6": {
        "day": 30,
        "weekendday": 8,
        "holiday": 0,
        "weekend_and_holiday": 8,
        "weekday": 22,
        "workday": 22,
        "estimated": "FALSE"
    },
    "7": {
        "day": 31,
        "weekendday": 10,
        "holiday": 1,
        "weekend_and_holiday": 11,
        "weekday": 20,
        "workday": 20,
        "estimated": "FALSE"
    },
    "8": {
        "day": 31,
        "weekendday": 8,
        "holiday": 1,
        "weekend_and_holiday": 9,
        "weekday": 22,
        "workday": 22,
        "estimated": "FALSE"
    },
    "9": {
        "day": 30,
        "weekendday": 9,
        "holiday": 2,
        "weekend_and_holiday": 10,
        "weekday": 20,
        "workday": 20,
        "estimated": "FALSE"
    },
    "10": {
        "day": 31,
        "weekendday": 9,
        "holiday": 1,
        "weekend_and_holiday": 10,
        "weekday": 21,
        "workday": 21,
        "estimated": "FALSE"
    },
    "11": {
        "day": 30,
        "weekendday": 8,
        "holiday": 2,
        "weekend_and_holiday": 10,
        "weekday": 20,
        "workday": 20,
        "estimated": "FALSE"
    },
    "12": {
        "day": 31,
        "weekendday": 10,
        "holiday": 0,
        "weekend_and_holiday": 10,
        "weekday": 21,
        "workday": 20,
        "estimated": "FALSE"
    }
}

2023年9月のデータを取得する場合

リクエスト

https://app.udcxx.me/api/workday/?y=2023&m=9

レスポンス

            
{
    "day": 30,
    "weekendday": 9,
    "holiday": 2,
    "weekend_and_holiday": 10,
    "weekday": 20,
    "workday": 20,
    "estimated": "FALSE"
}

2023年9月の営業日数のみを取得する場合

リクエスト

https://app.udcxx.me/api/workday/?y=2023&m=9&c=work

レスポンス

            
20

データについて

内閣府が発表する国民の祝日に基づいてデータを作成しています。（国民の祝日について - 内閣府）

内閣府から発表前の年のデータや、年末年始の休業日については、以下の判定条件をもとに祝日や営業日を推定しています。
なお、推定した祝日を元にしたデータについては、 est 項目が True になります。

祝日と発生要因

祝日名発生要因
元日1月1日
成人の日1月の第2月曜日
建国記念の日2月11日
天皇誕生日2月23日
春分の日春分日
昭和の日4月29日
憲法記念日5月3日
みどりの日5月4日
こどもの日5月5日
海の日7月の第3月曜日
山の日8月11日
敬老の日9月の第3月曜日
秋分の日秋分日
スポーツの日10月の第2月曜日
文化の日11月3日
勤労感謝の日11月23日

年初営業日について

1月1日から1月3日を営業日から除外する日として、1月1日の曜日に応じて営業日数を調整します。
1月1日は祝日となることに留意します。

年末営業日について

12月29日から12月31日を営業日から除外する日として、12月31日の曜日に応じて営業日数を調整します。

ライセンス

MITライセンス

個人、商用含め自由にご利用いただけます。
なお、データの誤りや、サービスの停止をはじめ、いかなる理由により利用者に損害等が発生しても、提供者は一切責任を負いません。

お問い合わせ

お気づきの点などがありましたら、お気軽に コンタクトフォーム からお問い合わせください

更新履歴

日付更新内容
2023-09-06公開