Op deze pagina

> bronnen > documentatie > expressies > Datum en tijdfuncties

Datum- en tijdfuncties

Functies om onderdelen van datum en tijd op te halen en datumberekeningen uit te voeren.

Werken met timestamps

In ProcessMind worden timestamps opgeslagen als getallen die het aantal milliseconden sinds 1 januari 1970 aangeven (Unix-epoch). De datumfuncties werken met deze timestamp-waarden.

Veelgebruikte patronen

Datumonderdelen ophalen:

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 bij een datum optellen:

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	`getal`
Voorbeelden	`now()` → `1708963200000` Huidige timestamp

year

(timestamp)

Haalt het jaar uit een timestamp.

Parameters

timestamp number Timestampwaarde

Retourneert getal

Voorbeelden

year(StartTime) → 2024

Zie ook

month day quarter

month

(timestamp)

Haalt de maand (1-12) uit een timestamp.

Parameters

timestamp number Timestampwaarde

Retourneert getal

Voorbeelden

month(StartTime) → 3

Maart

Zie ook

year day monthName

day

(timestamp)

Haalt de dag van de maand (1-31) uit een timestamp.

Parameters

timestamp number Timestampwaarde

Retourneert getal

Voorbeelden

day(StartTime) → 18

Zie ook

year month dayOfWeek

hour

(timestamp)

Haalt het uur (0-23) uit een timestamp.

Parameters

timestamp number Timestampwaarde

Retourneert getal

Voorbeelden

hour(StartTime) → 14

14.00 uur

Zie ook

minute second

minute

(timestamp)

Haalt de minuut (0-59) uit een timestamp.

Parameters

timestamp number Timestampwaarde

Retourneert getal

Voorbeelden

minute(StartTime) → 30

Zie ook

hour second

second

(timestamp)

Haalt de seconde (0-59) uit een timestamp.

Parameters

timestamp number Timestampwaarde

Retourneert getal

Voorbeelden

second(StartTime) → 45

Zie ook

hour minute

dayOfWeek

(timestamp)

Geeft de dag van de week voor een timestamp terug, waarbij 1 maandag is en 7 zondag.

Parameters

timestamp number Timestampwaarde

Retourneert getal

Voorbeelden

dayOfWeek(StartTime) → 1

Maandag

Zie ook

dayName day

dayName

(timestamp)

Geeft de naam van de weekdag voor een timestamp terug.

Parameters

timestamp number Timestampwaarde

Retourneert string

Voorbeelden

dayName(StartTime) → Maandag

Zie ook

dayOfWeek monthName

monthName

(timestamp)

Geeft de maandnaam voor een timestamp terug.

Parameters

timestamp number Timestampwaarde

Retourneert string

Voorbeelden

monthName(StartTime) → Maart

Zie ook

month dayName

quarter

(timestamp)

Geeft het kwartaal (1-4) voor een timestamp terug.

Parameters

timestamp number Timestampwaarde

Retourneert getal

Voorbeelden

quarter(StartTime) → 1

K1 (jan-mrt)

Zie ook

year month

weekOfYear

(timestamp)

Geeft het ISO-weeknummer (1-53) voor een timestamp terug.

Parameters

timestamp number Timestampwaarde

Retourneert getal

Voorbeelden

weekOfYear(StartTime) → 12

Week 12 van 2024

Zie ook

dayOfYear year

dayOfYear

(timestamp)

Geeft de dag van het jaar (1-366) voor een timestamp terug.

Parameters

timestamp number Timestampwaarde

Retourneert getal

Voorbeelden

dayOfYear(StartTime) → 78

78e dag van het jaar (18 maart 2024)

Zie ook

weekOfYear day

dateAdd

(timestamp, amount, unit)

Telt een opgegeven tijdsduur op bij een timestamp.

Parameters

timestamp	`number`	Begintimestamp
amount	`number`	Op te tellen hoeveelheid; kan negatief zijn
unit	`string`	Eenheid: 'year', 'month', 'day', 'hour', 'minute', 'second'

Retourneert getal

Voorbeelden

dateAdd(StartTime, 7, "day") → timestamp + 7 dagen

dateAdd(StartTime, -1, "month") → timestamp - 1 maand

dateAdd(1710766245000, 1, "day") → 1710852645000

Tel 1 dag op bij 18 maart 2024

Zie ook

dateDiff

(startTimestamp, endTimestamp, unit)

Berekent het verschil tussen twee timestamps in de opgegeven eenheid.

Parameters

startTimestamp	`number`	Starttimestamp
endTimestamp	`number`	Eindtijdstip
unit	`string`	Eenheid: 'day', 'hour', 'minute', 'second'

Retourneert getal

Voorbeelden

dateDiff(StartTime, EndTime, "minute") → 150

Duur in minuten

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

Opmerkingen

Geeft een decimaal getal terug dat het exacte verschil weergeeft.

Zie ook

dateAdd

isBusinessDay

(timestamp)

Controleert of een timestamp op een werkdag valt (maandag tot en met vrijdag).

Parameters

timestamp number Te controleren timestamp

Retourneert boolean

Voorbeelden

isBusinessDay(StartTime) → true

Als StartTime op een doordeweekse dag valt

Zie ook

workingDaysBetween dayOfWeek

workingDaysBetween

(startTimestamp, endTimestamp)

Telt het aantal werkdagen (maandag tot en met vrijdag) tussen twee timestamps.

Parameters

startTimestamp	`number`	Starttimestamp
endTimestamp	`number`	Eindtijdstip

Retourneert getal

Voorbeelden

workingDaysBetween(StartTime, EndTime) → Aantal werkdagen tussen de datums

workingDaysBetween(1710766245000, 1711371045000) → 5

5 werkdagen tussen maandag 18 maart en maandag 25 maart 2024

Opmerkingen

Benadering van een helper voor de backend/werkdagkalender. Houdt geen rekening met feestdagen, alleen met weekenden.

Zie ook

isBusinessDay dateDiff

toUtc

(timestamp, offsetHours)

Zet een lokale timestamp om naar UTC door het tijdzoneverschil af te trekken.

Parameters

timestamp	`number`	Lokale timestamp
offsetHours	`number`	Tijdzoneverschil in uren

Retourneert getal

Voorbeelden

toUtc(StartTime, 2) → StartTime - 2 uur

Omzetten vanuit UTC+2

toUtc(1710766245000, 2) → 1710759045000

Timestamp omzetten van UTC+2 naar UTC

Opmerkingen

Tijdzoneconversie ondersteunt momenteel numerieke UTC-verschillen in uren, geen IANA-tijdzonenamen.

Zie ook

toLocal convertTimezone

toLocal

(timestamp, offsetHours)

Zet een UTC-timestamp om naar lokale tijd door het tijdzoneverschil op te tellen.

Parameters

timestamp	`number`	UTC-timestamp
offsetHours	`number`	Tijdzoneverschil in uren

Retourneert getal

Voorbeelden

toLocal(StartTime, -5) → StartTime - 5 uur

Omzetten naar EST

toLocal(1710766245000, -5) → 1710748245000

UTC-timestamp omzetten naar EST (UTC-5)

Opmerkingen

Tijdzoneconversie ondersteunt momenteel numerieke UTC-verschillen in uren, geen IANA-tijdzonenamen.

Zie ook

toUtc convertTimezone

convertTimezone

(timestamp, fromOffset, toOffset)

Zet een timestamp om van de ene tijdzone naar een andere.

Parameters

timestamp	`number`	Om te zetten timestamp
fromOffset	`number`	Verschil met de brontijdzone in uren
toOffset	`number`	Verschil met de doeltijdzone in uren

Retourneert getal

Voorbeelden

convertTimezone(StartTime, 1, -5) → timestamp aangepast met -6 uur

CET naar EST

convertTimezone(1710766245000, 1, -5) → 1710744645000

Omzetten van UTC+1 naar UTC-5

Opmerkingen

Tijdzoneconversie ondersteunt momenteel numerieke UTC-verschillen in uren, geen IANA-tijdzonenamen.

Zie ook

toUtc toLocal

Gerelateerde onderwerpen

Overzicht van expressies: alle expressiefuncties.

Verbeter processen. Bouw aan een samenhangende architectuur. Houd de regie.

Krijg meteen toegang, zonder creditcard of wachttijd. Maak van de manier waarop je organisatie werkt heldere, samenhangende procesmodellen.

Breng de procesarchitectuur in kaart, leg verantwoordelijkheden en beheersmaatregelen vast en stem rollen en taken op elk niveau op elkaar af.

Start je gratis proefperiode en bouw een betrouwbare basis om processen te beheren en continu te verbeteren.

Start vandaag je gratis proefperiode