Rotierenden Schichtplan erstellen

Ungültige Bereiche, unmögliche Kalendertage und Zyklusfelder außerhalb des zulässigen Bereichs scheitern mit invalid_input und werden nie berechnet.

Was ein rotierender Dienst-/Ruhezyklus für eine Person bedeutet

Rotierende Schichtmuster wie vier Dienst und vier frei, zwei und zwei oder sieben und sieben sind in Dauerbetrieben üblich, in denen die Abdeckung gleichmäßig über Kalendertage rollen muss, ohne immer dieselben Wochentage festzuschreiben. Das Modell hier ist bewusst einfach und transparent: Jeder Zyklus ist ein Block aufeinanderfolgender Arbeitstage, gefolgt von einem Block aufeinanderfolgender Ruhetage; das Paar wiederholt sich ab dem Start des angeforderten Fensters. Was es liefert, ist eine reproduzierbare Einzelpersonen-Expansion, die Sie in Tabellen, Stempeluhren-Importe oder Entgeltvorschauen exportieren können, ohne die modulare Arithmetik in jedem Client neu zu implementieren. Tag null des Zyklus ist der erste Tag eines Dienstblocks, wenn cycle_offset null ist. Für jeden Tagesindex i ab start_date (nullbasiert) ist day_in_cycle der Rest von i plus cycle_offset geteilt durch cycle_length, wobei cycle_length on_days plus off_days ist. Ist dieser Rest streng kleiner als on_days, ist der Tag on; sonst off. Klassisches 4-an/4-aus nutzt daher on_days vier und off_days vier, einen Acht-Tage-Zyklus und eine langfristige Arbeitsquote von einem Halben. 2-an/2-aus nutzt zwei und zwei. Ein 5-an/2-aus-Muster nutzt fünf und zwei und ergibt eine Quote nahe fünf Siebtel—nützlich, wenn Sie mehr Arbeitsdichte als eine reine Halbzeitrotation wünschen. off_days auf null setzt jeden Tag im Fenster auf Dienst und eignet sich gelegentlich als Basisplan ständiger Verfügbarkeit. Dieses Werkzeug weist keine mehreren benannten Crews zu, überspringt keine Feiertage, kodiert keine Nacht- versus Tagschicht-Labels jenseits des binären on/off-Status und gleicht Stunden nicht gegen gesetzliche Höchstgrenzen aus—diese Schichten gehören in Ihr HR-System.

Eingabevertrag, Antwortform und Validierungsregeln

Senden Sie per POST einen JSON-Body mit vier Pflichtfeldern und zwei optionalen. start_date und end_date müssen echte gregorianische Kalenderzeichenketten im strikten Format YYYY-MM-DD sein; der Bereich ist an beiden Enden inklusiv und end_date darf start_date nicht vorausgehen. Die inklusive Spanne darf höchstens dreihundertsechsundsechzig Tage betragen, damit die Antwortgröße für Browser und API-Clients begrenzt bleibt. on_days ist eine positive Ganzzahl von eins bis neunzig; off_days ist eine Ganzzahl von null bis neunzig. cycle_offset ist standardmäßig null und muss, wenn angegeben, zwischen null und cycle_length minus eins liegen, damit eine Eintrittsphase mitten im Zyklus nicht über das Zyklusende hinaus zeigt. worker_name ist ein optionales Label mit höchstens einhundertzwanzig Zeichen, das bei Erfolg zurückgegeben wird, wenn vorhanden. Aliasnamen sind aus Ergonomiegründen akzeptiert: from oder begin für start_date, to oder until für end_date, work_days für on_days, rest_days für off_days, offset oder phase für cycle_offset sowie name oder employee für worker_name. Bei Erfolg liefert der Body die normalisierten Daten und Zyklusparameter, pattern als kurze Zeichenkette wie four-on slash four-off, total_days, days_on, days_off, work_ratio half-up auf sechs Dezimalen gerundet, ein roster-Array von Objekten mit date, day_in_cycle und status on oder off sowie parallele on_dates- und off_dates-Arrays zum schnellen Filtern. Das Feld formula stellt die Modulregel im Klartext für Audit-Spuren dar. Unmögliche Daten wie der einunddreißigste April, eine negative Spanne, eine Spanne über dem Maximum, ein null oder nicht ganzzahliges on_days oder ein cycle_offset gleich oder größer als cycle_length scheitern mit invalid_input unter Nennung des Feldes; diese Fehler verbrauchen kein vorausbezahltes Guthaben. Der Preis erfolgreicher Aufrufe ist pauschal $0.002 mit Einheit item.

Wo die Expansion des rotierenden Dienstplans Nutzen stiftet

HR-Onboarding-Abläufe können das Eintrittsdatum als start_date mit einem cycle_offset ungleich null übergeben, damit die neue Person in die bestehende Rotation mitten im Zyklus einsteigt statt bei Tag null neu zu starten. Entgelt-Vorprozessoren zählen days_on in einem Abrechnungszeitraum, um erwartete Regelstunden zu prüfen, bevor Überstundenregeln greifen. Personal-Simulatoren vergleichen work_ratio über Kandidatenmuster—2-an/2-aus versus 4-an/4-aus versus 5-an/2-aus—ohne jedes Mal eigene Skripte zu schreiben. Integrationsteams betten die API in interne Werkzeuge ein, damit Planer modulare Tabellen nie von Hand abtippen.