Files
Betriebsf-hrungssoftware/src/domain/kalender.ts

124 lines
4.4 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// Feiertage Schleswig-Holstein und Arbeitstage des Betriebs.
// Regel aus V70: gearbeitet wird Montag bis Donnerstag. Freitag ist immer frei
// (Büro, Aufräumen, Reserve), Wochenende und Feiertage zählen nicht.
import { type Datum, datum, plusTage, wochentag, jahrVon } from "./datum.js";
export interface Feiertag {
datum: Datum;
name: string;
}
/** Ostersonntag nach der Gaußschen Osterformel (gregorianisch, anonymer Algorithmus). */
export function ostersonntag(jahr: number): Datum {
const a = jahr % 19;
const b = Math.floor(jahr / 100);
const c = jahr % 100;
const d = Math.floor(b / 4);
const e = b % 4;
const f = Math.floor((b + 8) / 25);
const g = Math.floor((b - f + 1) / 3);
const h = (19 * a + b - d - g + 15) % 30;
const i = Math.floor(c / 4);
const k = c % 4;
const l = (32 + 2 * e + 2 * i - h - k) % 7;
const m = Math.floor((a + 11 * h + 22 * l) / 451);
const monat = Math.floor((h + l - 7 * m + 114) / 31);
const tag = ((h + l - 7 * m + 114) % 31) + 1;
return datum(jahr, monat, tag);
}
const cache = new Map<number, Feiertag[]>();
/** Gesetzliche Feiertage in Schleswig-Holstein. Reformationstag gilt seit 2018. */
export function feiertageSH(jahr: number): Feiertag[] {
const vorhanden = cache.get(jahr);
if (vorhanden) return vorhanden;
const ostern = ostersonntag(jahr);
const liste: Feiertag[] = [
{ datum: datum(jahr, 1, 1), name: "Neujahr" },
{ datum: plusTage(ostern, -2), name: "Karfreitag" },
{ datum: plusTage(ostern, 1), name: "Ostermontag" },
{ datum: datum(jahr, 5, 1), name: "Tag der Arbeit" },
{ datum: plusTage(ostern, 39), name: "Christi Himmelfahrt" },
{ datum: plusTage(ostern, 50), name: "Pfingstmontag" },
{ datum: datum(jahr, 10, 3), name: "Tag der Deutschen Einheit" },
...(jahr >= 2018 ? [{ datum: datum(jahr, 10, 31), name: "Reformationstag" }] : []),
{ datum: datum(jahr, 12, 25), name: "1. Weihnachtstag" },
{ datum: datum(jahr, 12, 26), name: "2. Weihnachtstag" },
];
liste.sort((x, y) => x.datum.localeCompare(y.datum));
cache.set(jahr, liste);
return liste;
}
export function feiertag(d: Datum): Feiertag | undefined {
return feiertageSH(jahrVon(d)).find((f) => f.datum === d);
}
export interface Arbeitswoche {
/** Wochentage 1 = Montag … 7 = Sonntag, an denen gearbeitet wird */
tage: number[];
}
export const STANDARDWOCHE: Arbeitswoche = { tage: [1, 2, 3, 4] };
export function istArbeitstag(d: Datum, woche: Arbeitswoche = STANDARDWOCHE): boolean {
return woche.tage.includes(wochentag(d)) && !feiertag(d);
}
/** Bankarbeitstag (Mo–Fr ohne Feiertag), z. B. für Steuerfälligkeiten. Freitagsregel gilt hier nicht. */
export function istBankarbeitstag(d: Datum): boolean {
return wochentag(d) <= 5 && !feiertag(d);
}
/** Der Tag selbst, falls Arbeitstag, sonst der nächste Arbeitstag. */
export function naechsterArbeitstag(d: Datum, woche: Arbeitswoche = STANDARDWOCHE): Datum {
let x = d;
for (let i = 0; i < 400; i++) {
if (istArbeitstag(x, woche)) return x;
x = plusTage(x, 1);
}
throw new Error("Kein Arbeitstag gefunden");
}
export function naechsterBankarbeitstag(d: Datum): Datum {
let x = d;
while (!istBankarbeitstag(x)) x = plusTage(x, 1);
return x;
}
/**
* Verschiebt um n Arbeitstage (n darf negativ sein). Ausgangspunkt ist der Tag selbst;
* n = 0 liefert ihn unverändert.
*/
export function verschiebeArbeitstage(d: Datum, n: number, woche: Arbeitswoche = STANDARDWOCHE): Datum {
let x = d;
const schritt = n >= 0 ? 1 : -1;
let rest = Math.abs(n);
while (rest > 0) {
x = plusTage(x, schritt);
if (istArbeitstag(x, woche)) rest--;
}
return x;
}
/**
* Letzter Arbeitstag eines Vorgangs, der am Start (bzw. dem nächsten Arbeitstag) beginnt
* und `dauer` Arbeitstage dauert. Dauer 0 ist ein Meilenstein: Ende = Start.
*/
export function endeNachDauer(start: Datum, dauer: number, woche: Arbeitswoche = STANDARDWOCHE): Datum {
if (!Number.isInteger(dauer) || dauer < 0) throw new Error(`Ungültige Dauer: ${dauer}`);
const beginn = naechsterArbeitstag(start, woche);
if (dauer === 0) return beginn;
return verschiebeArbeitstage(beginn, dauer - 1, woche);
}
/** Anzahl Arbeitstage von `von` bis `bis`, beide eingeschlossen. 0, wenn bis vor von liegt. */
export function arbeitstageZwischen(von: Datum, bis: Datum, woche: Arbeitswoche = STANDARDWOCHE): number {
if (bis < von) return 0;
let n = 0;
for (let x = von; x <= bis; x = plusTage(x, 1)) if (istArbeitstag(x, woche)) n++;
return n;
}