Datum- en tijdfuncties
Functies voor het uitlezen van datum- en tijdonderdelen en het uitvoeren van datumrekenwerk.
Werken met timestamps
In ProcessMind worden timestamps opgeslagen als getallen die het aantal milliseconden sinds 1 januari 1970 (Unix-epoch) weergeven. De datumfuncties werken met deze timestampwaarden.
Veelgebruikte patronen
-
Datumonderdelen uitlezen:
year(StartTime) // 2024 month(StartTime) // 3 (March) day(StartTime) // 15 -
Doorlooptijd berekenen:
dateDiff(StartTime, EndTime, "minute") dateDiff(StartTime, EndTime, "hour") dateDiff(StartTime, EndTime, "day") -
Tijdvakken maken:
bucket(hour(StartTime), 6, "Night", 12, "Morning", 18, "Afternoon", "Evening") -
Tijd aan een datum toevoegen:
dateAdd(StartTime, 7, "day") // Add 7 days dateAdd(StartTime, -1, "month") // Subtract 1 month
now
()Geeft de huidige UTC-timestamp terug, in milliseconden sinds de Unix-epoch.
| Retourneert | number |
| Voorbeelden | now() → 1708963200000 Huidige timestamp |
year
(timestamp)Haalt het jaar uit een timestamp.
| Parameters |
| |||
| Retourneert | number | |||
| Voorbeelden | year(StartTime) → 2024 | |||
| Zie ook |
month
(timestamp)Haalt de maand, 1-12, uit een timestamp.
| Parameters |
| |||
| Retourneert | number | |||
| Voorbeelden | month(StartTime) → 3 Maart | |||
| Zie ook |
day
(timestamp)Haalt de dag van de maand, 1-31, uit een timestamp.
| Parameters |
| |||
| Retourneert | number | |||
| Voorbeelden | day(StartTime) → 18 | |||
| Zie ook |
hour
(timestamp)Haalt het uur, 0-23, uit een timestamp.
| Parameters |
| |||
| Retourneert | number | |||
| Voorbeelden | hour(StartTime) → 14 14:00 uur | |||
| Zie ook |
minute
(timestamp)Haalt de minuut, 0-59, uit een timestamp.
| Parameters |
| |||
| Retourneert | number | |||
| Voorbeelden | minute(StartTime) → 30 | |||
| Zie ook |
second
(timestamp)Haalt de seconde, 0-59, uit een timestamp.
| Parameters |
| |||
| Retourneert | number | |||
| Voorbeelden | second(StartTime) → 45 | |||
| Zie ook |
dayOfWeek
(timestamp)Geeft de dag van de week terug, 1=maandag en 7=zondag, op basis van een timestamp.
| Parameters |
| |||
| Retourneert | number | |||
| Voorbeelden | dayOfWeek(StartTime) → 1 Maandag | |||
| Zie ook |
dayName
(timestamp)Geeft de naam van de dag van de week terug op basis van een timestamp.
| Parameters |
| |||
| Retourneert | string | |||
| Voorbeelden | dayName(StartTime) → Maandag | |||
| Zie ook |
monthName
(timestamp)Geeft de naam van de maand terug op basis van een timestamp.
| Parameters |
| |||
| Retourneert | string | |||
| Voorbeelden | monthName(StartTime) → Maart | |||
| Zie ook |
quarter
(timestamp)Geeft het kwartaal, 1-4, terug op basis van een timestamp.
| Parameters |
| |||
| Retourneert | number | |||
| Voorbeelden | quarter(StartTime) → 1 Q1 (jan-maart) | |||
| Zie ook |
weekOfYear
(timestamp)Geeft het ISO-weeknummer, 1-53, terug op basis van een timestamp.
| Parameters |
| |||
| Retourneert | number | |||
| Voorbeelden | weekOfYear(StartTime) → 12 Week 12 van 2024 | |||
| Zie ook |
dayOfYear
(timestamp)Geeft de dag van het jaar, 1-366, terug op basis van een timestamp.
| Parameters |
| |||
| Retourneert | number | |||
| Voorbeelden | dayOfYear(StartTime) → 78 78e dag van het jaar (18 maart 2024) | |||
| Zie ook |
dateAdd
(timestamp, amount, unit)Voegt een opgegeven hoeveelheid tijd toe aan een timestamp.
| Parameters |
| |||||||||
| Retourneert | number | |||||||||
| Voorbeelden | dateAdd(StartTime, 7, "day") → timestamp + 7 dagen dateAdd(StartTime, -1, "month") → timestamp - 1 maand dateAdd(1710766245000, 1, "day") → 1710852645000 1 dag toevoegen aan 18 maart 2024 | |||||||||
| Zie ook |
dateDiff
(startTimestamp, endTimestamp, unit)Berekent het verschil tussen twee timestamps in de opgegeven eenheid.
| Parameters |
| |||||||||
| Retourneert | number | |||||||||
| Voorbeelden | dateDiff(StartTime, EndTime, "minute") → 150 Duur in minuten dateDiff(StartTime, EndTime, "hour") → 2.5 | |||||||||
| Notities | Geeft een decimale waarde terug die het exacte verschil weergeeft. | |||||||||
| Zie ook |
isBusinessDay
(timestamp)Controleert of een timestamp op een werkdag valt, van maandag tot en met vrijdag.
| Parameters |
| |||
| Retourneert | boolean | |||
| Voorbeelden | isBusinessDay(StartTime) → true Als StartTime een weekdag is | |||
| Zie ook |
workingDaysBetween
(startTimestamp, endTimestamp)Telt de werkdagen, van maandag tot en met vrijdag, tussen twee timestamps.
| Parameters |
| ||||||
| Retourneert | number | ||||||
| Voorbeelden | workingDaysBetween(StartTime, EndTime) → Aantal weekdagen tussen de datums workingDaysBetween(1710766245000, 1711371045000) → 5 5 werkdagen tussen maandag 18 maart en maandag 25 maart 2024 | ||||||
| Notities | Benaderende helper voor backend en bedrijfskalender. Houdt geen rekening met feestdagen, alleen met weekenden. | ||||||
| Zie ook |
toUtc
(timestamp, offsetHours)Converteert een lokale timestamp naar UTC door de offset af te trekken.
| Parameters |
| ||||||
| Retourneert | number | ||||||
| Voorbeelden | toUtc(StartTime, 2) → StartTime - 2 uur Converteren vanuit UTC+2 toUtc(1710766245000, 2) → 1710759045000 Timestamp converteren van UTC+2 naar UTC | ||||||
| Notities | Timezoneconversie ondersteunt momenteel numerieke UTC-offsets in uren, geen IANA-timezonenamen. | ||||||
| Zie ook |
toLocal
(timestamp, offsetHours)Converteert een UTC-timestamp naar lokale tijd door de offset op te tellen.
| Parameters |
| ||||||
| Retourneert | number | ||||||
| Voorbeelden | toLocal(StartTime, -5) → StartTime - 5 uur Converteren naar EST toLocal(1710766245000, -5) → 1710748245000 UTC-timestamp converteren naar EST (UTC-5) | ||||||
| Notities | Timezoneconversie ondersteunt momenteel numerieke UTC-offsets in uren, geen IANA-timezonenamen. | ||||||
| Zie ook |
convertTimezone
(timestamp, fromOffset, toOffset)Converteert een timestamp van de ene tijdzone naar een andere.
| Parameters |
| |||||||||
| Retourneert | number | |||||||||
| Voorbeelden | convertTimezone(StartTime, 1, -5) → timestamp aangepast met -6 uur CET naar EST convertTimezone(1710766245000, 1, -5) → 1710744645000 Converteren van UTC+1 naar UTC-5 | |||||||||
| Notities | Timezoneconversie ondersteunt momenteel numerieke UTC-offsets in uren, geen IANA-timezonenamen. | |||||||||
| Zie ook |
Gerelateerde onderwerpen
- Overzicht van expressies: alle expressiefuncties.