ローテシフト勤務表

無効な範囲、存在しない暦日、範囲外のサイクル項目はinvalid_inputで失敗し、課金されません。

一人の就業者にとっての勤務／休暇ローテサイクルの意味

cycle_offsetが0のとき、サイクルの0日目は勤務ブロックの初日です。start_dateから数えた0始まりの日インデックスiについて、day_in_cycleはiにcycle_offsetを加えた値をcycle_lengthで割った余りであり、cycle_lengthはon_daysとoff_daysの和です。その余りがon_days未満ならその日はon、そうでなければoffです。典型的な4勤4休はon_daysが4、off_daysが4で8日周期となり、長期の労働比率は2分の1です。off_daysを0にすると期間内の全日がonとなり、常時出勤の基準表として使うことがあります。

入力契約、応答形状、検証規則

formula欄は監査用に剰余規則を平文で再掲します。必須4項目と任意2項目を含むJSONボディをPOSTしてください。start_dateとend_dateは厳密なYYYY-MM-DD形式の実在するグレゴリオ暦日で、範囲は両端含み、end_dateはstart_dateより前であってはなりません。両端含む期間は最大366日までとし、ブラウザとAPIクライアントの応答サイズを抑えます。on_daysは1から90の正の整数、off_daysは0から90の整数です。cycle_offsetの既定は0で、指定時は0からcycle_length-1の間にあり、入社途中の位相がサイクル末尾を超えないようにします。worker_nameは成功時に返す最大120文字の任意ラベルです。利便のための別名として、start_dateにfrom/begin、end_dateにto/until、on_daysにwork_days、off_daysにrest_days、cycle_offsetにoffset/phase、worker_nameにname/employeeを受け付けます。成功時は正規化した日付とサイクルパラメータ、four-on slash four-offのような短いpattern、total_days、days_on、days_off、6桁までhalf-up丸めしたwork_ratio、date・day_in_cycle・status（on/off）を持つroster配列、素早い絞り込み用のon_datesとoff_datesを返します。4月31日のような不可能日、負の期間、上限超過、0や非整数のon_days、cycle_length以上のcycle_offsetはフィールド名付きのinvalid_inputとなり、前払い残高は消費しません。成功呼び出しの料金は単位itemの定額$0.002です。

ローテ勤務表展開が役立つ場面

4勤4休の月を組む現場監督は、掲示板を出す前に技術者がどの暦日に勤務するかをすぐ一覧したいと考えます。ローテシフト勤務表や4勤4休で検索されるSEOランディングは、共有lib上で有料自動化経路とバイト一致するライブ無料計算機の恩恵を受けます。問いが一人分の純粋なサイクル展開であるときに本機能を選び、複数クルーの公平性、労使規則、スキル混合、休暇カレンダーはより本格的なworkforce管理製品が必要です。検証失敗は無料なので、探索用クライアントは無効なオフセットや不正日付を安全に試せます。人事の入社フローでは、入社日をstart_dateとし、0でないcycle_offsetを渡すことで、新規者が日0からやり直すのではなく既存ローテの途中位相に合流できます。給与前処理は支払期間内のdays_onを数え、残業規則の前に想定通常日数を突合します。人員シミュレータは2勤2休・4勤4休・5勤2休など候補パターンのwork_ratioを、毎回専用スクリプトを書かずに比較します。連携チームはAPIを社内ツールに埋め込み、計画者が剰余表を手入力しないようにします。要求は366日上限内に保ち、複数年計画では年ウィンドウごとにエンドポイントを呼びクライアント側で結合してください。