Auf dieser Seite

Datums- und Uhrzeitfunktionen

Funktionen zum Extrahieren von Datums- und Uhrzeitbestandteilen sowie für Datumsberechnungen.

Mit Timestamps arbeiten

In ProcessMind werden Timestamps als Zahlen gespeichert, die Millisekunden seit dem 1. Januar 1970 (Unix-Epoche) darstellen. Die Datumsfunktionen verarbeiten diese Timestamp-Werte.

Gängige Muster

  • Datumsbestandteile extrahieren:

    year(StartTime)       // 2024
    month(StartTime)      // 3 (March)
    day(StartTime)        // 15
  • Dauer berechnen:

    dateDiff(StartTime, EndTime, "minute")
    dateDiff(StartTime, EndTime, "hour")
    dateDiff(StartTime, EndTime, "day")
  • Zeitintervalle erstellen:

    bucket(hour(StartTime), 6, "Night", 12, "Morning", 18, "Afternoon", "Evening")
  • Zeit zu einem Datum addieren:

    dateAdd(StartTime, 7, "day")     // Add 7 days
    dateAdd(StartTime, -1, "month")  // Subtract 1 month

now

()

Gibt den aktuellen UTC-Timestamp in Millisekunden seit der Unix-Epoche zurück.

Rückgabewert Zahl
Beispiele
now() → 1708963200000

Aktueller Timestamp

year

(timestamp)

Extrahiert das Jahr aus einem Timestamp.

Parameter
timestamp number Timestamp-Wert
Rückgabewert Zahl
Beispiele
year(StartTime) → 2024
Siehe auch

month

(timestamp)

Extrahiert den Monat (1–12) aus einem Timestamp.

Parameter
timestamp number Timestamp-Wert
Rückgabewert Zahl
Beispiele
month(StartTime) → 3

März

Siehe auch

day

(timestamp)

Extrahiert den Tag des Monats (1–31) aus einem Timestamp.

Parameter
timestamp number Timestamp-Wert
Rückgabewert Zahl
Beispiele
day(StartTime) → 18
Siehe auch

hour

(timestamp)

Extrahiert die Stunde (0–23) aus einem Timestamp.

Parameter
timestamp number Timestamp-Wert
Rückgabewert Zahl
Beispiele
hour(StartTime) → 14

14 Uhr

Siehe auch

minute

(timestamp)

Extrahiert die Minute (0–59) aus einem Timestamp.

Parameter
timestamp number Timestamp-Wert
Rückgabewert Zahl
Beispiele
minute(StartTime) → 30
Siehe auch

second

(timestamp)

Extrahiert die Sekunde (0–59) aus einem Timestamp.

Parameter
timestamp number Timestamp-Wert
Rückgabewert Zahl
Beispiele
second(StartTime) → 45
Siehe auch

dayOfWeek

(timestamp)

Gibt den Wochentag eines Timestamps zurück, wobei 1 für Montag und 7 für Sonntag steht.

Parameter
timestamp number Timestamp-Wert
Rückgabewert Zahl
Beispiele
dayOfWeek(StartTime) → 1

Montag

Siehe auch

dayName

(timestamp)

Gibt den Namen des Wochentags für einen Timestamp zurück.

Parameter
timestamp number Timestamp-Wert
Rückgabewert Zeichenfolge
Beispiele
dayName(StartTime) → Montag
Siehe auch

monthName

(timestamp)

Gibt den Monatsnamen für einen Timestamp zurück.

Parameter
timestamp number Timestamp-Wert
Rückgabewert Zeichenfolge
Beispiele
monthName(StartTime) → März
Siehe auch

quarter

(timestamp)

Gibt das Quartal (1–4) für einen Timestamp zurück.

Parameter
timestamp number Timestamp-Wert
Rückgabewert Zahl
Beispiele
quarter(StartTime) → 1

Q1 (Jan.–März)

Siehe auch

weekOfYear

(timestamp)

Gibt die ISO-Kalenderwochennummer (1–53) für einen Timestamp zurück.

Parameter
timestamp number Timestamp-Wert
Rückgabewert Zahl
Beispiele
weekOfYear(StartTime) → 12

Woche 12 des Jahres 2024

Siehe auch

dayOfYear

(timestamp)

Gibt den Tag des Jahres (1–366) für einen Timestamp zurück.

Parameter
timestamp number Timestamp-Wert
Rückgabewert Zahl
Beispiele
dayOfYear(StartTime) → 78

78. Tag des Jahres (18.03.2024)

Siehe auch

dateAdd

(timestamp, amount, unit)

Addiert eine angegebene Zeitspanne zu einem Timestamp.

Parameter
timestamp number Ausgangs-Timestamp
amount number Zu addierender Wert; kann negativ sein
unit string Einheit: 'year', 'month', 'day', 'hour', 'minute', 'second'
Rückgabewert Zahl
Beispiele
dateAdd(StartTime, 7, "day") → Timestamp + 7 Tage
dateAdd(StartTime, -1, "month") → Timestamp - 1 Monat
dateAdd(1710766245000, 1, "day") → 1710852645000

1 Tag zum 18. März 2024 addieren

Siehe auch

dateDiff

(startTimestamp, endTimestamp, unit)

Berechnet die Differenz zwischen zwei Timestamps in der angegebenen Einheit.

Parameter
startTimestamp number Start-Timestamp
endTimestamp number End-Timestamp
unit string Einheit: 'day', 'hour', 'minute', 'second'
Rückgabewert Zahl
Beispiele
dateDiff(StartTime, EndTime, "minute") → 150

Dauer in Minuten

dateDiff(StartTime, EndTime, "hour") → 2.5
Hinweise

Gibt einen Dezimalwert zurück, der die genaue Differenz angibt.

Siehe auch

isBusinessDay

(timestamp)

Prüft, ob ein Timestamp auf einen Werktag (Montag bis Freitag) fällt.

Parameter
timestamp number Zu prüfender Timestamp
Rückgabewert Boolescher Wert
Beispiele
isBusinessDay(StartTime) → true

Wenn StartTime auf einen Wochentag fällt

Siehe auch

workingDaysBetween

(startTimestamp, endTimestamp)

Zählt die Werktage (Montag bis Freitag) zwischen zwei Timestamps.

Parameter
startTimestamp number Start-Timestamp
endTimestamp number End-Timestamp
Rückgabewert Zahl
Beispiele
workingDaysBetween(StartTime, EndTime) → Anzahl der Wochentage zwischen den Datumsangaben
workingDaysBetween(1710766245000, 1711371045000) → 5

5 Werktage zwischen Mo., 18. März, und Mo., 25. März 2024

Hinweise

Ungefähre Hilfsfunktion für Backend und Geschäftskalender. Feiertage werden nicht berücksichtigt, nur Wochenenden.

Siehe auch

toUtc

(timestamp, offsetHours)

Wandelt einen lokalen Timestamp in UTC um, indem der Zeitzonenversatz abgezogen wird.

Parameter
timestamp number Lokaler Timestamp
offsetHours number Zeitzonenversatz in Stunden
Rückgabewert Zahl
Beispiele
toUtc(StartTime, 2) → StartTime - 2 Stunden

Aus UTC+2 umwandeln

toUtc(1710766245000, 2) → 1710759045000

Timestamp von UTC+2 in UTC umwandeln

Hinweise

Die Zeitzonenumwandlung unterstützt derzeit numerische UTC-Versätze in Stunden, aber keine IANA-Zeitzonennamen.

Siehe auch

toLocal

(timestamp, offsetHours)

Wandelt einen UTC-Timestamp in die Ortszeit um, indem der Zeitzonenversatz addiert wird.

Parameter
timestamp number UTC-Timestamp
offsetHours number Zeitzonenversatz in Stunden
Rückgabewert Zahl
Beispiele
toLocal(StartTime, -5) → StartTime - 5 Stunden

In EST umwandeln

toLocal(1710766245000, -5) → 1710748245000

UTC-Timestamp in EST (UTC-5) umwandeln

Hinweise

Die Zeitzonenumwandlung unterstützt derzeit numerische UTC-Versätze in Stunden, aber keine IANA-Zeitzonennamen.

Siehe auch

convertTimezone

(timestamp, fromOffset, toOffset)

Wandelt einen Timestamp von einer Zeitzone in eine andere um.

Parameter
timestamp number Umzuwandelnder Timestamp
fromOffset number Versatz der Quellzeitzone in Stunden
toOffset number Versatz der Zielzeitzone in Stunden
Rückgabewert Zahl
Beispiele
convertTimezone(StartTime, 1, -5) → Timestamp um 6 Stunden zurückgesetzt

MEZ in EST umwandeln

convertTimezone(1710766245000, 1, -5) → 1710744645000

Von UTC+1 in UTC-5 umwandeln

Hinweise

Die Zeitzonenumwandlung unterstützt derzeit numerische UTC-Versätze in Stunden, aber keine IANA-Zeitzonennamen.

Siehe auch

Verwandte Themen

Verbessern Sie Prozesse. Schaffen Sie eine vernetzte Architektur. Behalten Sie die Kontrolle.

Erhalten Sie sofort Zugriff, ohne Kreditkarte und Wartezeit. Bilden Sie die Arbeitsweise Ihrer Organisation in klaren, vernetzten Prozessmodellen ab.

Entwickeln Sie Ihre Prozessarchitektur, definieren Sie Zuständigkeiten und Kontrollen und stimmen Sie Rollen und Verantwortlichkeiten auf allen Ebenen ab.

Starten Sie Ihre kostenlose Testphase und schaffen Sie eine verlässliche Grundlage, um Ihre Prozesse zu steuern und kontinuierlich zu verbessern.