Flower

← Alle Module · Hilfsmittel

datum

Das Modul liefert und verarbeitet Datums- und Zeitwerte: aktuellen Zeitpunkt holen, Datumsangaben formatieren oder einlesen, rechnen (addieren, subtrahieren, Differenz), Wochentag und Kalenderwoche bestimmen sowie Werktage und Feiertage prüfen. So lassen sich Termine, Fristen und Zeitstempel in Workflows automatisch berechnen.

Aktionen

jetztlesend

Liefert den aktuellen Zeitpunkt (Datum + Uhrzeit) der angegebenen Zeitzone.

Eingaben

FeldTypPflichtBeschreibung
zeitzoneTextZeitzone, in der der Zeitpunkt geliefert wird (Standard: 'system', also die PC-Zeitzone).

Ausgaben (über ergebnis:)

ergebnisAktueller Zeitpunkt als Datumswert mit Uhrzeit.

heutelesend

Liefert das heutige Datum (auf Mitternacht gesetzt) der angegebenen Zeitzone.

Eingaben

FeldTypPflichtBeschreibung
zeitzoneTextZeitzone, in der das heutige Datum bestimmt wird (Standard: 'system').

Ausgaben (über ergebnis:)

ergebnisHeutiges Datum als Datumswert.

formatierenlesend

Wandelt einen Datumswert nach einer Vorlage in einen lesbaren Text um.

Eingaben

FeldTypPflichtBeschreibung
datumDatumjaDer zu formatierende Datumswert.
vorlageTextFormat-Vorlage, z. B. 'dd.MM.yyyy HH:mm' (Standard: 'dd.MM.yyyy HH:mm').
kulturTextSprach-/Länderkennung für Namen und Trenner, z. B. 'de-DE' (Standard: 'de-DE').

Ausgaben (über ergebnis:)

ergebnisDer formatierte Datums-Text.

parsenlesend

Liest einen Datums-Text ein und wandelt ihn in einen Datumswert um (mit Auto-Erkennung, wenn keine Vorlage angegeben ist).

Eingaben

FeldTypPflichtBeschreibung
textTextjaDer einzulesende Datums-Text, z. B. '24.12.2026'.
vorlageTextErwartete Format-Vorlage; leer = automatische Erkennung deutsch/englisch/ISO (Standard: leer).
kulturTextSprach-/Länderkennung für die Auswertung (Standard: 'de-DE').

Ausgaben (über ergebnis:)

ergebnisDer eingelesene Datumswert.

addierenlesend

Addiert eine Zeitspanne (Sekunden bis Jahre) zu einem Datumswert; negative Werte sind erlaubt.

Eingaben

FeldTypPflichtBeschreibung
datumDatumjaAusgangs-Datumswert.
sekundenZahlAnzahl Sekunden (Standard: 0).
minutenZahlAnzahl Minuten (Standard: 0).
stundenZahlAnzahl Stunden (Standard: 0).
tageZahlAnzahl Tage (Standard: 0).
wochenZahlAnzahl Wochen (Standard: 0).
monateZahlAnzahl Monate (Standard: 0).
jahreZahlAnzahl Jahre (Standard: 0).

Ausgaben (über ergebnis:)

ergebnisDer neue Datumswert nach der Addition.

subtrahierenlesend

Zieht eine Zeitspanne (Sekunden bis Jahre) von einem Datumswert ab; negative Werte sind erlaubt.

Eingaben

FeldTypPflichtBeschreibung
datumDatumjaAusgangs-Datumswert.
sekundenZahlAnzahl Sekunden (Standard: 0).
minutenZahlAnzahl Minuten (Standard: 0).
stundenZahlAnzahl Stunden (Standard: 0).
tageZahlAnzahl Tage (Standard: 0).
wochenZahlAnzahl Wochen (Standard: 0).
monateZahlAnzahl Monate (Standard: 0).
jahreZahlAnzahl Jahre (Standard: 0).

Ausgaben (über ergebnis:)

ergebnisDer neue Datumswert nach der Subtraktion.

differenzlesend

Berechnet den Abstand zwischen zwei Datumswerten in der gewählten Einheit.

Eingaben

FeldTypPflichtBeschreibung
startDatumjaStart-Zeitpunkt.
endeDatumjaEnd-Zeitpunkt.
einheitTextEinheit des Ergebnisses: 'sekunden' (Standard), 'minuten', 'stunden', 'tage' oder 'wochen'.

Ausgaben (über ergebnis:)

ergebnisDer Abstand (ende minus start) als Zahl in der gewählten Einheit.

wochentaglesend

Bestimmt den Wochentag eines Datums als Name und als ISO-Zahl (Mo=1 ... So=7).

Eingaben

FeldTypPflichtBeschreibung
datumDatumjaDer auszuwertende Datumswert.
kulturTextSprach-/Länderkennung für den Wochentagsnamen (Standard: 'de-DE').

Ausgaben (über ergebnis:)

ergebnisName des Wochentags, z. B. 'Donnerstag'.
ergebnis-zahlISO-Wochentagszahl (Montag=1 bis Sonntag=7).

kalenderwochelesend

Ermittelt die ISO-Kalenderwoche und das zugehörige ISO-Jahr eines Datums.

Eingaben

FeldTypPflichtBeschreibung
datumDatumjaDer auszuwertende Datumswert.

Ausgaben (über ergebnis:)

ergebnisDie ISO-Kalenderwoche als Zahl (1-53).
ergebnis-jahrDas ISO-Jahr, zu dem die Kalenderwoche gehört.

ist-werktaglesend

Prüft, ob ein Datum ein Werktag ist (Mo-Fr, abzüglich der Feiertage des gewählten Profils).

Eingaben

FeldTypPflichtBeschreibung
datumDatumjaDer zu prüfende Datumswert.
feiertageTextFeiertags-Profil: 'de-bw' (Standard), 'de-by', 'de-nw', 'de-sn' oder 'keine' (Feiertage ignorieren).

Ausgaben (über ergebnis:)

ergebnisWahr, wenn das Datum ein Werktag ist, sonst Falsch.

nächster-werktaglesend

Liefert den nächsten Werktag nach dem angegebenen Datum (Wochenenden und Feiertage werden übersprungen).

Eingaben

FeldTypPflichtBeschreibung
datumDatumjaAusgangs-Datumswert.
feiertageTextFeiertags-Profil wie bei 'ist-werktag' (Standard: 'de-bw').

Ausgaben (über ergebnis:)

ergebnisDer nächste Werktag als Datumswert.

monats-endelesend

Liefert den letzten Tag des Monats, in dem das Datum liegt.

Eingaben

FeldTypPflichtBeschreibung
datumDatumjaDer auszuwertende Datumswert.

Ausgaben (über ergebnis:)

ergebnisDatumswert des letzten Tages dieses Monats.

bestandteilelesend

Zerlegt ein Datum in seine Einzelteile (Jahr, Monat, Tag, Uhrzeit, Wochentag, Kalenderwoche).

Eingaben

FeldTypPflichtBeschreibung
datumDatumjaDer zu zerlegende Datumswert.

Ausgaben (über ergebnis:)

ergebnisObjekt mit jahr, monat, tag, stunde, minute, sekunde, wochentag (Name) und kalenderwoche.

Beispiele

Frist auf 14 Tage setzen und formatieren

Holt das heutige Datum, addiert 14 Tage und gibt die Frist als deutschen Text aus.

datum
heute
ergebnisheute
datum
addieren
datumheute
tage14
ergebnisfrist
datum
formatieren
datumfrist
vorlagedd.MM.yyyy
ergebnisfrist-text
- datum:
    aktionen:
      - heute:
          ergebnis: heute
      - addieren:
          datum: heute
          tage: 14
          ergebnis: frist
      - formatieren:
          datum: frist
          vorlage: "dd.MM.yyyy"
          ergebnis: frist-text

Nächsten Werktag und Kalenderwoche bestimmen

Liest ein Datum aus Text ein, ermittelt den nächsten Werktag (Baden-Württemberg) und dessen Kalenderwoche.

datum
parsen
text24.12.2026
ergebnisheiligabend
datum
nächster-werktag
datumheiligabend
feiertagede-bw
ergebnisnaechster
datum
kalenderwoche
datumnaechster
ergebniskw
- datum:
    aktionen:
      - parsen:
          text: "24.12.2026"
          ergebnis: heiligabend
      - nächster-werktag:
          datum: heiligabend
          feiertage: "de-bw"
          ergebnis: naechster
      - kalenderwoche:
          datum: naechster
          ergebnis: kw