Datums- und Zeitfunktionen
Funktionen zum Extrahieren von Datums- und Zeitkomponenten sowie für Datumsberechnungen.
Arbeiten mit Timestamps
In ProcessMind werden Timestamps als Zahlen gespeichert, die die Millisekunden seit dem 1. Januar 1970 (Unix-Epoche) darstellen. Die Datumsfunktionen arbeiten mit diesen Timestamp-Werten.
Häufige Muster
-
Datumsteile 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") -
Zeitabschnitte 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 |
| |||
| Rückgabewert | Zahl | |||
| Beispiele | year(StartTime) → 2024 | |||
| Siehe auch |
month
(timestamp)Extrahiert den Monat, 1–12, aus einem Timestamp.
| Parameter |
| |||
| Rückgabewert | Zahl | |||
| Beispiele | month(StartTime) → 3 März | |||
| Siehe auch |
day
(timestamp)Extrahiert den Tag des Monats, 1–31, aus einem Timestamp.
| Parameter |
| |||
| Rückgabewert | Zahl | |||
| Beispiele | day(StartTime) → 18 | |||
| Siehe auch |
hour
(timestamp)Extrahiert die Stunde, 0–23, aus einem Timestamp.
| Parameter |
| |||
| Rückgabewert | Zahl | |||
| Beispiele | hour(StartTime) → 14 14 Uhr | |||
| Siehe auch |
minute
(timestamp)Extrahiert die Minute, 0–59, aus einem Timestamp.
| Parameter |
| |||
| Rückgabewert | Zahl | |||
| Beispiele | minute(StartTime) → 30 | |||
| Siehe auch |
second
(timestamp)Extrahiert die Sekunde, 0–59, aus einem Timestamp.
| Parameter |
| |||
| Rückgabewert | Zahl | |||
| Beispiele | second(StartTime) → 45 | |||
| Siehe auch |
dayOfWeek
(timestamp)Gibt den Wochentag aus einem Timestamp zurück, wobei 1 für Montag und 7 für Sonntag steht.
| Parameter |
| |||
| Rückgabewert | Zahl | |||
| Beispiele | dayOfWeek(StartTime) → 1 Montag | |||
| Siehe auch |
dayName
(timestamp)Gibt den Namen des Wochentags aus einem Timestamp zurück.
| Parameter |
| |||
| Rückgabewert | Zeichenfolge | |||
| Beispiele | dayName(StartTime) → Montag | |||
| Siehe auch |
monthName
(timestamp)Gibt den Monatsnamen aus einem Timestamp zurück.
| Parameter |
| |||
| Rückgabewert | Zeichenfolge | |||
| Beispiele | monthName(StartTime) → März | |||
| Siehe auch |
quarter
(timestamp)Gibt das Quartal, 1–4, aus einem Timestamp zurück.
| Parameter |
| |||
| Rückgabewert | Zahl | |||
| Beispiele | quarter(StartTime) → 1 Q1 (Jan.–März) | |||
| Siehe auch |
weekOfYear
(timestamp)Gibt die ISO-Kalenderwoche, 1–53, aus einem Timestamp zurück.
| Parameter |
| |||
| Rückgabewert | Zahl | |||
| Beispiele | weekOfYear(StartTime) → 12 Woche 12 des Jahres 2024 | |||
| Siehe auch |
dayOfYear
(timestamp)Gibt den Tag des Jahres, 1–366, aus einem Timestamp zurück.
| Parameter |
| |||
| Rückgabewert | Zahl | |||
| Beispiele | dayOfYear(StartTime) → 78 78. Tag des Jahres (18. März 2024) | |||
| Siehe auch |
dateAdd
(timestamp, amount, unit)Addiert einen bestimmten Zeitraum zu einem Timestamp.
| Parameter |
| |||||||||
| 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 |
| |||||||||
| 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 exakte Differenz darstellt. | |||||||||
| Siehe auch |
isBusinessDay
(timestamp)Prüft, ob ein Timestamp auf einen Arbeitstag von Montag bis Freitag fällt.
| Parameter |
| |||
| Rückgabewert | boolean | |||
| Beispiele | isBusinessDay(StartTime) → true Wenn StartTime auf einen Wochentag fällt | |||
| Siehe auch |
workingDaysBetween
(startTimestamp, endTimestamp)Zählt die Arbeitstage von Montag bis Freitag zwischen zwei Timestamps.
| Parameter |
| ||||||
| Rückgabewert | Zahl | ||||||
| Beispiele | workingDaysBetween(StartTime, EndTime) → Anzahl der Wochentage zwischen den Datumswerten workingDaysBetween(1710766245000, 1711371045000) → 5 5 Arbeitstage zwischen Montag, dem 18. März, und Montag, dem 25. März 2024 | ||||||
| Hinweise | Ungefähre Hilfsfunktion für Backend und Geschäftskalender. Feiertage werden nicht berücksichtigt, sondern nur Wochenenden. | ||||||
| Siehe auch |
toUtc
(timestamp, offsetHours)Konvertiert einen lokalen Timestamp in UTC, indem der Offset subtrahiert wird.
| Parameter |
| ||||||
| Rückgabewert | Zahl | ||||||
| Beispiele | toUtc(StartTime, 2) → StartTime − 2 Stunden Aus UTC+2 konvertieren toUtc(1710766245000, 2) → 1710759045000 Timestamp von UTC+2 in UTC konvertieren | ||||||
| Hinweise | Die Zeitzonenumrechnung unterstützt derzeit numerische UTC-Verschiebungen in Stunden, jedoch keine IANA-Zeitzonennamen. | ||||||
| Siehe auch |
toLocal
(timestamp, offsetHours)Konvertiert einen UTC-Timestamp in die lokale Zeit, indem der Offset addiert wird.
| Parameter |
| ||||||
| Rückgabewert | Zahl | ||||||
| Beispiele | toLocal(StartTime, -5) → StartTime minus 5 Stunden In EST umrechnen toLocal(1710766245000, -5) → 1710748245000 UTC-Timestamp in EST umrechnen (UTC-5) | ||||||
| Hinweise | Die Zeitzonenumrechnung unterstützt derzeit numerische UTC-Verschiebungen in Stunden, jedoch keine IANA-Zeitzonennamen. | ||||||
| Siehe auch |
convertTimezone
(timestamp, fromOffset, toOffset)Wandelt einen Timestamp von einer Zeitzone in eine andere um.
| Parameter |
| |||||||||
| Rückgabewert | Zahl | |||||||||
| Beispiele | convertTimezone(StartTime, 1, -5) → Timestamp um 6 Stunden angepasst CET in EST convertTimezone(1710766245000, 1, -5) → 1710744645000 Von UTC+1 in UTC-5 umrechnen | |||||||||
| Hinweise | Die Zeitzonenumrechnung unterstützt derzeit numerische UTC-Verschiebungen in Stunden, jedoch keine IANA-Zeitzonennamen. | |||||||||
| Siehe auch |
Verwandte Themen
- Expressions-Übersicht: alle Ausdrucksfunktionen.