業務アプリケーション寄りのプログラマであれば一度は書いたであろう営業日判定のプログラム。
今回はBashで書いてみた。わりと汎用的に使えると思うので共有する。
開発動機
休日は実行しなくても良い夜間バッチがあった(休日に実行しても影響は無い)。
土日は実行しないようにcron
でスケジュールしていたが、リソースを節約したいので、できれば祝日も実行させたくない。
日本の祝日情報をどこから貰うか
Google Calendar APIを利用しようと思ったが、調べてみると、内閣府ホームページで祝日情報を公開しているようなので、それを使う。
curl -sL https://www8.cao.go.jp/chosei/shukujitsu/syukujitsu.csv | iconv -f cp932
URLの中に shukujitsu(ヘボン式)とsyukujitsu(訓令式)が混在しているが気にしないことにする。
将来URLが変わるかもしれないので、L
オプションでリダイレクトを有効にしておく。iconv
で指定する文字コードは sjis より cp932 の方が無難である。
国民の祝日・休日月日,国民の祝日・休日名称
1955/1/1,元日
1955/1/15,成人の日
1955/3/21,春分の日
1955/4/29,天皇誕生日
:
2020/7/24,スポーツの日
2020/8/10,山の日
2020/9/21,敬老の日
2020/9/22,秋分の日
2020/11/3,文化の日
2020/11/23,勤労感謝の日
日付の桁数も揃っていないが気にしないことにする。(2020/1/1
は2020/01/01
にならないのかという意味)
毎年2月になると官報に翌年の暦要項が掲載されるので、2021年のデータは2020年2月頃に追加されるのだろうか?
なお、このCSVファイルは、そのままExcelのWORKDAY関数に使えるので覚えておくと良い。
ちなみに・・・「スポーツの日」とは「体育の日」の名称が変わったものだが、2020年だけはオリンピック開会式の7月24日に移動するらしい。
シェルスクリプト
祝日情報を、内閣府のサーバに毎回問い合わせるのも忍びないので、ローカルにキャッシュする。
キャッシュが古くなれば更新される。
確実に祝日と言える場合のみ、終了ステータスに 0 がセットされる。
#!/bin/bash################################################################ 本邦休日判定スクリプト# @author MindWood# @param チェック日付を yyyymmdd で指定。省略すると今日を仮定# @return 0 ... 確実に祝日# 1 ... おそらく平日# 上記以外 ... エラー# @usage check_holiday.sh || ”平日に必ず実行させるジョブ”################################################################ 引数チェックif[$# -eq 0 ];then
CHECK_DATE=$(date +%s)elif[$# -eq 1 ];then
CHECK_DATE=$(date +%s --date$1)||exit 254
else
echo'Invalid argument'exit 255
fi
CACHE_PATH=/tmp # 内閣府提供の祝日ファイルをキャッシュするディレクトリHOLIDAY_FILE=$CACHE_PATH/holiday.csv # 祝日登録ファイル名LIMIT=$(date +%s --date'3 months ago')# 3ヶ月以上前は古い祝日登録ファイルとする# 祝日登録ファイルが無い、もしくは祝日登録ファイルの更新日が古くなった場合、再取得するif[!-f$HOLIDAY_FILE]||[$LIMIT-gt$(date +%s -r$HOLIDAY_FILE)];then
curl -sL https://www8.cao.go.jp/chosei/shukujitsu/syukujitsu.csv | iconv -f cp932 >$HOLIDAY_FILE||exit 250
fi# 祝日として登録されていれば 0 を返却して終了grep ^$(date-d @$CHECK_DATE +%Y/%-m/%-d)$HOLIDAY_FILE> /dev/null 2>&1 &&exit 0
# 土日なら 0 を返却して終了DAYOFWEEK=$(date-d @$CHECK_DATE +%u)[$DAYOFWEEK-eq 6 ]||[$DAYOFWEEK-eq 7 ]&&exit 0
# 年末年始(12月31日~1月3日)なら 0 を返却して終了MMDD=$(date-d @$CHECK_DATE +%m%d)[$MMDD-eq 1231 ]||[$MMDD-le 0103 ]&&exit 0
# 上記いずれでもなければ平日として終了exit 1
年末年始を休みとするかは会社によって異なるので適宜修正して欲しい。
2019年12月26日から2020年1月16日までの平日を表示させた結果が次の通りだ。
for((DATE=20191226;$DATE< 20200116;DATE=$(date-d"$DATE 1 day" +%Y%m%d)));do
./check_holiday.sh $DATE||echo"$DATEは恐らく平日です"done
20191226 は恐らく平日です
20191227 は恐らく平日です
20191230 は恐らく平日です
20200106 は恐らく平日です
20200107 は恐らく平日です
20200108 は恐らく平日です
20200109 は恐らく平日です
20200110 は恐らく平日です
20200114 は恐らく平日です
20200115 は恐らく平日です
平日なのに祝日と誤判定することは無いが、祝日なのに平日と誤判定することは有り得るため、「恐らく」と自信なげに書いている。
例えば、内閣府のサーバに接続できなければエラー終了となって ||
の後ろが実行されてしまうが、平日に必ず実行させるジョブがある場合は、安全で都合が良い。
cron定義例
業務開始前に実行させるジョブが、次のように定義されていたとする。
00 7 * * * python3 /usr/local/bin/app.py
この場合、次のように追記するだけで、休日は実行しないようにできる。
00 7 * * * /usr/local/bin/check_holiday.sh || python3 /usr/local/bin/app.py
さいごに
日本の行政機関が提供する Web APIに祝日情報も加えていただきたいと思う。