会社の年末年始の休みを選ぶと、有給を何日とると何連休になるか、どの日に有給をとればいいかが出る計算機を、AI(Claude)で作って note で売っています。この記事では、有給の置き場所をどう数えたか、答えが合っているかをどう確かめたかを、作る人向けに書きます。
作ったもの
「年末年始の連休 計算機」という、ブラウザで動く計算機です。
年末年始の連休 計算機のお試し版(無料)をブラウザで開いて試せます。お使いの端末で、必要な項目と表示を確認してください。
完全版の機能と購入条件は、noteの案内(運営者の有料アプリ)をご確認ください。
- お試し版(無料):2026年12月〜2027年1月。会社の年末年始の休みを選んで、有給0〜3日のいちばん長い連休と、有給にする日をカレンダーで見る。ふだんの休みは土日と祝日
- 完全版(note・300円):ふだんの休みの曜日、祝日に出勤するか、日ごとの出勤・休み(土曜出勤など)、有給10日まで、同じ日数のほかの案、2027年12月〜2028年1月、コピー・カレンダー用ファイル(.ics)・A4の印刷・設定をURLに残す
題材の選び方:早見表はあるが、会社の休みが入らない
年末年始の連休は、毎年たくさんの記事が「有給1日で9連休」のような早見表を出します。連休のシミュレーターも見つかりました。ただ、見つかったものは、年末年始の休みを全員同じ日として数えるもので、会社の休みの日付や、ふだんの休みの曜日を入れる欄はありませんでした。
実際の休みは会社ごとに違います。12月30日からの会社、1月4日まで休みの会社、土曜出勤がある会社、平日が休みのシフト。早見表の「9連休」は、その人の答えとは限りません。そこで、会社の休みと曜日を入れて数える道具にしました。
数え方を、コードの前に文章で決める
先に仕様書(SPEC.md)に、休みの決め方と連休の数え方を書きました。AIに渡す指示も、点検も、記事も、この章を正にします。
- 休みかどうかは、日ごとの指定 → 会社の年末年始の休み → ふだんの休みの曜日 → 祝日、の順に、最初に当てはまったもので決める
- 有給は出勤日を休みにする日。休みの日には使わない
- 数えるのは、会社の年末年始の休みと1日でも重なる連休(休みが無いときは12月29日〜1月3日と重なるもの)
- 同じ長さなら、はじまりの早いものを「いちばんの案」、残りを「同じ日数のほかの案」にする
数え方:左端を決めて、右へのばす
連休の左端は、前の日が出勤日のところにしか来ません(前の日が休みなら、もっと左にのばせるからです)。そこで、左端の候補ごとに、右へ出勤日を k 日まで有給にしながらのばし、それ以上のばせなくなったところで止めます。全部の候補のうち、年末年始と重なるいちばん長いものが答えです。
数える範囲(窓)は11月20日〜2月10日です。有給にする日はこの中から選びます。連休が窓の端に届いたときは、窓の外の休み(ふだんの休みの曜日と祝日)を、出勤日に当たるまで数え足します(extL・extR)。窓の端に届くのは、出勤が週2日以下で有給が多いときや、日ごとの指定で12月・1月の出勤日を多く休みにしたときです(日ごとの指定を使わなければ、週3日以上の出勤では届きません)。
function candidates(B, k){
const {W0, off, T, extL, extR} = B, N = off.length, out = [];
for(let i = 0; i < N; i++){
if(i > 0 && off[i - 1]) continue; // 左にのばせるところからは始めない
let u = 0, j = i;
const yu = [];
for(; j < N; j++){
if(!off[j]){ if(u === k) break; u++; yu.push(W0 + j); }
}
const b = j - 1;
if(b < i) continue;
const a = W0 + i - (i === 0 ? extL : 0), bb = W0 + b + (b === N - 1 ? extR : 0); // 窓の端なら外の休みを足す
if(bb < T[0] || a > T[1]) continue; // 年末年始と重ならない
out.push({a, b: bb, L: bb - a + 1, u, yu});
}
out.sort((x, y) => y.L - x.L || x.a - y.a);
return out;
}
有給を1日足すと、となりの出勤日を休みにできるので、連休は少なくとも1日のびます。なので答えは、ほとんどの設定で有給を全部使います。使い切らないのは、窓の中の出勤日を全部有給にしても足りないときだけで、そのときは「有給は◯日で足ります」と出します。効くのは「休みと休みのあいだの出勤日」をうめる1日で、会社の休みが12月29日〜1月3日なら、2026年の年末は12月28日(月)の1日で、6連休が9連休になります。
日付は「1970年からの日数」で持つ
日付を Date のまま足し引きすると、端末の時差や夏時間で1日ずれることがあります。このアプリは日付を Date.UTC から割った「日数」の整数で持ち、曜日も UTC で取ります。カレンダーの何月何日も、.ics の日付も、この整数から作ります。
答え合わせ:別の作りの「総当たり」と突き合わせる
アプリと同じ考え方でテストを書くと、同じまちがいを見逃します。そこでテストのほうは、窓の中のすべての区間[a, b]を総当たりで調べ、「出勤日が k 日以下」「左右にのばせない」「年末年始と重なる」を満たすものからいちばん長いものを選ぶ、別のやり方で書きました(Python)。窓の端に届いた区間は、窓の外の休みを1日ずつ見て足します。
会社の休み7通り・曜日・祝日の休み・日ごとの指定・2つの年末年始をでたらめに組み合わせ、有給0〜10日について、いちばんの案とほかの案の全部をアプリ(ブラウザで動かしたもの)と比べました。完全版4,350件・お試し版596件、それに窓の端に届きやすい設定(出勤が週1〜2日など)1,657件で、食い違いは0件でした。仕様書に書いた例(有給0日で6連休、1日で9連休、6日で17連休など)と、窓の端の例(月曜だけ出勤・有給10日で11月17日〜2月14日の90連休など)も、手で数えた答えと比べています。
1つのソースから、お試し版と完全版を作る
お試し版と完全版は、1枚のHTMLから作ります。完全版だけの部分を、行だけの印(<!–#full–> と <!–#end–>)ではさみ、作る道具(build.py)が印を見て2つに分けます。印の入れ子や閉じ忘れがあると止まるので、完全版の機能がお試し版に混ざりません。書体は、ページに出る字だけに切り出して埋め込み、外から何も読みません。
設定はURLに入れる
完全版は、入れた設定を端末に残さず、ページのURLの「#」のあとに入れます(例:#s=2026&h=1229&w=1000001&r=1&k=6)。ブックマークすると同じ設定で開け、読めないURLのときは最初の設定に戻して知らせます。
まとめ
年末年始の連休は、早見表で分かる人と、自分の会社の休みで数え直さないと分からない人がいます。後の人に向けて、会社の休み・曜日・日ごとの出勤を入れて数える道具にしました。数え方は先に文章で決め、別の作りの総当たりで答え合わせをしています。
完全版(曜日・日ごとの出勤と休み・有給10日まで・2027年〜2028年・カレンダー用ファイル)は note で売っています。


コメント