システムで祝日の判定を使用することは、多くのエンジニアが一度は通る道ではないか思います。
\n自分もついにその判定を実装することになったので、どのように実装するべきか、あらためて Web 上の情報をまとめました。
\n祝日の判定方法には、大きく 3 種類の方針があります。
\n以下、この 3 つの方針について順に解説していきます。
\nまずは何らかの方法で祝日一覧のデータを入手して、それを元に API やライブラリ (または関数など) を実装する方法についてです。
\n祝日を判定する API やライブラリを独自実装する場合、元データをどこから入手するのかという問題があります。
\n元データの取得元としては、大きく 2 パターンあります。
\nの 2 つです。
\n日本における国民の祝日について、内閣府の Web サイトの「国民の祝日について」というページで解説されています。
\nこのページからは国民の祝日の一覧が CSV 形式でダウンロード可能で、プログラムなどで祝日を判定する際の元データとして利用可能です。
\nこのデータを使う場合、祝日の判定のたびに内閣府の Web サイトにアクセスするのはよろしくないため、自前で CSV データ (またはそれを変換したデータ) を管理する必要があります。
\n内閣府の「国民の祝日について」のデータを元データとして使うメリット・デメリットは以下のようになります。
\nメリット
\nデメリット
\n参考
\n続いて、Google Calendar API を使って祝日のデータを取得する方法です。
\nGoogle Calendar API は Google が提供する API の 1 つで、ここから日本の祝日を取得することができます。
\n利用するには API にアクセスするためのトークンを払い出し、リクエスト時に送信する必要があります。
\nGoogle Calendar API を元データとして使うメリット・デメリットは以下のようになります。
\nメリット
\nデメリット
\n参考
\n次に、祝日の判定に Web API を判定のたびに叩く方法です。
\n祝日の判定が必要になるたびに API を叩く方針にすることで、元データをどこかに保存する手間を省いたり、判定ロジックの実装を不要化または簡易化することが可能になります。
\n一方、判定のたびに API を叩く場合、レートリミットやサービスレベルに注意する必要があります。\nまた、独自実装やライブラリの使用と異なり、インターネットを経由した通信が発生するため、レイテンシを許容する必要も出てきます。
\nざっと調べた範囲では、祝日の判定に使える Web API として
\nの 3 つが見つかりました。
\nGoogle Calendar API は、上に書いたように元データの取得元として使うのではなく、祝日の判定が必要になるたびに叩くことも可能です。
\n他の API と比べたメリット・デメリットは以下のようになります。
\nメリット
\nデメリット
\nちなみに、Google Calendar API は GAS からだと非常に簡単に使えます。
\n参考
\n\nHolidays JP API は、Google Calendar API を元データとして提供されている API です。
\nGoogle Calendar API のデータを祝日の判定に使いやすい形式に変換したものと考えてください。
\nメリット
\nデメリット
\n参考
\n祝日判定web API は、内閣府の Web データを元に提供されている API で、APIbank にも登録されています。
\nメリット
\nデメリット
\n最後に、各プログラミング言語のライブラリを使う方法です。
\nなど、各種プログラミング言語で祝日判定用のライブラリが存在するようです。
\nこういったライブラリを使えば、元データを独自に加工するプログラムを書く必要もありませんし、Web API を使う場合のようにレートリミットやサービスレベル、レイテンシなどを気にする必要もありません。
\nただし、祝日データを更新するため、定期的にライブラリをバージョンアップするなどの対応が必要になります。\nライブラリのバージョンアップが必要な日が迫ったらアラートが上がるようにしておくといいかもしれません。
\n以上を踏まえて、祝日の判定についてどの方法を採用すべきか、自分の考えをまとめます。
\nまず、使用している言語に信頼できる祝日判定ライブラリがある場合、ライブラリの利用を第一に考えるべきでしょう。
\n他の方法と比べて実装コストがはるかに低いうえ、Web API を使う場合のようにレートリミットやサービスレベル、レイテンシなどを気にする必要もありません。
\nただし、ライブラリを使う場合はバージョンアップが必要な日が迫ったらアラートが上がるような仕組みを入れておくと良さそうです。
\n良さそうなライブラリが見つからなかった場合、独自実装か Web API のどちらかを選ぶことになります。
\n個人開発など、祝日の判定の頻度が低く、レートリミットやサービスレベル、レイテンシも気にならないといった場合は、Web API を必要なタイミングで叩く方法でいいのではないかと思います。
\nどの API を使うかという観点では、Google Calendar API が信頼度が高いですが、より簡易的に済ませたい場合は Holidays JP API でもいいと思います。
\nレートリミットやサービスレベル、レイテンシについて気にかけたい場合は、内閣府の「国民の祝日について」か Google Calendar API を元データとして独自実装することになります。
\n実務上は、API を適宜叩くよりも、この選択をとることが多くなると思います。
\nGoogle Calendar API を使う際の API キーの管理の手間も考えると、内閣府の「国民の祝日について」のデータの方が気軽に使えます。
\n祝日のマスタデータを登録する仕組みだけシステムに用意しておいて、年に一度程度マスタデータを更新する方針でも十分でしょう。
","fields":{"slug":"/posts/holiday-judgment","tagSlugs":["/tag/tips/"],"autoRecommendPosts":["language-in-audio-data","game-engines-libraries-cloud-services-for-xr-development","rest-graphql-grpc-books","udemy-web-application-development-with-javascript"]},"frontmatter":{"date":"2020-08-26T03:54:28.953Z","description":"祝日の判定方法には「元データを入手して独自に API やライブラリを実装する」、「Web API を判定のたびに叩く」、「ライブラリを使う」の 3 種類の方針があります。\nこの 3 つの方針について順に解説していきます。","tags":["tips"],"title":"プログラムによる祝日の判定方法まとめ【独自実装・Web API・ライブラリ】","socialImage":null,"recommendPosts":["https://www.kanzennirikaisita.com/posts/software-developer-books-index"]}}},"pageContext":{"slug":"/posts/holiday-judgment"}},"staticQueryHashes":["251939775","3942705351","401334301"]}