Ezen az oldalon

> erőforrások > dokumentáció > kifejezések > Dátum és időfüggvények

Dátum- és időfüggvények

A dátum- és időadatok részeinek kinyerésére, valamint dátumokkal végzett számításokra szolgáló függvények.

Időbélyegek használata

A ProcessMind az időbélyegeket számként tárolja. Ezek azt jelzik, hány ezredmásodperc telt el 1970. január 1. óta (Unix-korszak). A dátumfüggvények ezekkel az időbélyegértékekkel dolgoznak.

Gyakori minták

Dátumrészek kinyerése:

year(StartTime)       // 2024
month(StartTime)      // 3 (March)
day(StartTime)        // 15

Időtartam kiszámítása:

dateDiff(StartTime, EndTime, "minute")
dateDiff(StartTime, EndTime, "hour")
dateDiff(StartTime, EndTime, "day")

Időintervallumok létrehozása:

bucket(hour(StartTime), 6, "Night", 12, "Morning", 18, "Afternoon", "Evening")

Idő hozzáadása egy dátumhoz:

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

now

()

Az aktuális UTC-időbélyeget adja vissza, az Unix-korszak kezdete óta eltelt ezredmásodpercekben.

Visszatérési érték	`szám`
Példák	`now()` → `1708963200000` Aktuális időbélyeg

year

(timestamp)

Kinyeri az év értékét az időbélyegből.

Paraméterek

timestamp number Időbélyeg értéke

Visszatérési érték szám

Példák

year(StartTime) → 2024

Lásd még

month day quarter

month

(timestamp)

Kinyeri a hónap számát (1–12) az időbélyegből.

Paraméterek

timestamp number Időbélyeg értéke

Visszatérési érték szám

Példák

month(StartTime) → 3

Március

Lásd még

year day monthName

day

(timestamp)

Kinyeri a hónap napját (1–31) az időbélyegből.

Paraméterek

timestamp number Időbélyeg értéke

Visszatérési érték szám

Példák

day(StartTime) → 18

Lásd még

year month dayOfWeek

hour

(timestamp)

Kinyeri az órát (0–23) az időbélyegből.

Paraméterek

timestamp number Időbélyeg értéke

Visszatérési érték szám

Példák

hour(StartTime) → 14

14 óra

Lásd még

minute second

minute

(timestamp)

Kinyeri a percet (0–59) az időbélyegből.

Paraméterek

timestamp number Időbélyeg értéke

Visszatérési érték szám

Példák

minute(StartTime) → 30

Lásd még

hour second

second

(timestamp)

Kinyeri a másodpercet (0–59) az időbélyegből.

Paraméterek

timestamp number Időbélyeg értéke

Visszatérési érték szám

Példák

second(StartTime) → 45

Lásd még

hour minute

dayOfWeek

(timestamp)

Visszaadja az időbélyeghez tartozó hét napját, ahol 1 = hétfő, 7 = vasárnap.

Paraméterek

timestamp number Időbélyeg értéke

Visszatérési érték szám

Példák

dayOfWeek(StartTime) → 1

Hétfő

Lásd még

dayName day

dayName

(timestamp)

Visszaadja az időbélyeghez tartozó hét napjának nevét.

Paraméterek

timestamp number Időbélyeg értéke

Visszatérési érték szöveg

Példák

dayName(StartTime) → Hétfő

Lásd még

dayOfWeek monthName

monthName

(timestamp)

Visszaadja az időbélyeghez tartozó hónap nevét.

Paraméterek

timestamp number Időbélyeg értéke

Visszatérési érték szöveg

Példák

monthName(StartTime) → Március

Lásd még

month dayName

quarter

(timestamp)

Visszaadja az időbélyeghez tartozó negyedévet (1–4).

Paraméterek

timestamp number Időbélyeg értéke

Visszatérési érték szám

Példák

quarter(StartTime) → 1

Q1 (jan.–márc.)

Lásd még

year month

weekOfYear

(timestamp)

Visszaadja az időbélyeghez tartozó ISO-hét sorszámát (1–53).

Paraméterek

timestamp number Időbélyeg értéke

Visszatérési érték szám

Példák

weekOfYear(StartTime) → 12

2024 12. hete

Lásd még

dayOfYear year

dayOfYear

(timestamp)

Visszaadja az időbélyeghez tartozó év napjának sorszámát (1–366).

Paraméterek

timestamp number Időbélyeg értéke

Visszatérési érték szám

Példák

dayOfYear(StartTime) → 78

Az év 78. napja (2024. március 18.)

Lásd még

weekOfYear day

dateAdd

(timestamp, amount, unit)

A megadott időtartamot hozzáadja egy időbélyeghez.

Paraméterek

timestamp	`number`	Kezdő időbélyeg
amount	`number`	Hozzáadandó mennyiség, negatív is lehet
unit	`string`	Mértékegység: 'year', 'month', 'day', 'hour', 'minute', 'second'

Visszatérési érték szám

Példák

dateAdd(StartTime, 7, "day") → időbélyeg + 7 nap

dateAdd(StartTime, -1, "month") → időbélyeg - 1 hónap

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

Adjon hozzá 1 napot 2024. március 18-ához

Lásd még

dateDiff

(startTimestamp, endTimestamp, unit)

Kiszámítja két időbélyeg különbségét a megadott mértékegységben.

Paraméterek

startTimestamp	`number`	Kezdő időbélyeg
endTimestamp	`number`	Záró időbélyeg
unit	`string`	Mértékegység: 'day', 'hour', 'minute', 'second'

Visszatérési érték szám

Példák

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

Időtartam percben

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

Megjegyzések

A pontos különbséget tizedes értékként adja vissza.

Lásd még

dateAdd

isBusinessDay

(timestamp)

Ellenőrzi, hogy az időbélyeg munkanapra (hétfőtől péntekig) esik-e.

Paraméterek

timestamp number Ellenőrizendő időbélyeg

Visszatérési érték logikai érték

Példák

isBusinessDay(StartTime) → true

Ha a StartTime hétköznapra esik

Lásd még

workingDaysBetween dayOfWeek

workingDaysBetween

(startTimestamp, endTimestamp)

Megszámolja a két időbélyeg közötti munkanapokat (hétfőtől péntekig).

Paraméterek

startTimestamp	`number`	Kezdő időbélyeg
endTimestamp	`number`	Záró időbélyeg

Visszatérési érték szám

Példák

workingDaysBetween(StartTime, EndTime) → A dátumok közötti hétköznapok száma

workingDaysBetween(1710766245000, 1711371045000) → 5

5 munkanap 2024. március 18., hétfő és március 25., hétfő között

Megjegyzések

Közelítő, háttérben használt munkanap-számító segédfüggvény. Az ünnepnapokat nem veszi figyelembe, csak a hétvégéket.

Lásd még

isBusinessDay dateDiff

toUtc

(timestamp, offsetHours)

A helyi időbélyeget az időzóna-eltolás levonásával UTC-re alakítja.

Paraméterek

timestamp	`number`	Helyi időbélyeg
offsetHours	`number`	Időzóna-eltolás órában

Visszatérési érték szám

Példák

toUtc(StartTime, 2) → StartTime - 2 óra

Átalakítás UTC+2 időzónából

toUtc(1710766245000, 2) → 1710759045000

Időbélyeg átalakítása UTC+2-ről UTC-re

Megjegyzések

Az időzóna-átalakítás jelenleg órában megadott, számszerű UTC-eltolásokat támogat, IANA-időzónaneveket nem.

Lásd még

toLocal convertTimezone

toLocal

(timestamp, offsetHours)

A UTC-időbélyeget az időzóna-eltolás hozzáadásával helyi időre alakítja.

Paraméterek

timestamp	`number`	UTC-időbélyeg
offsetHours	`number`	Időzóna-eltolás órában

Visszatérési érték szám

Példák

toLocal(StartTime, -5) → StartTime - 5 óra

Átalakítás EST-re

toLocal(1710766245000, -5) → 1710748245000

UTC-időbélyeg átalakítása EST-re (UTC-5)

Megjegyzések

Az időzóna-átalakítás jelenleg órában megadott, számszerű UTC-eltolásokat támogat, IANA-időzónaneveket nem.

Lásd még

toUtc convertTimezone

convertTimezone

(timestamp, fromOffset, toOffset)

Az időbélyeget egyik időzónából a másikba alakítja.

Paraméterek

timestamp	`number`	Átalakítandó időbélyeg
fromOffset	`number`	Forrás-időzóna eltolása órában
toOffset	`number`	Cél-időzóna eltolása órában

Visszatérési érték szám

Példák

convertTimezone(StartTime, 1, -5) → időbélyeg 6 órával korábbra állítva

CET-ről EST-re

convertTimezone(1710766245000, 1, -5) → 1710744645000

Átalakítás UTC+1-ről UTC-5-re

Megjegyzések

Az időzóna-átalakítás jelenleg órában megadott, számszerű UTC-eltolásokat támogat, IANA-időzónaneveket nem.

Lásd még

toUtc toLocal

Kapcsolódó témák

Kifejezések áttekintése: az összes kifejezésfüggvény.

Tervezzen jobb folyamatokat. Építsen összekapcsolt architektúrát. Tartsa kézben a működést.

Azonnal hozzáférhet, bankkártya és várakozás nélkül. Alakítsa szervezete működését világos, összekapcsolt folyamatmodellekké.

Építse fel folyamatarchitektúráját, határozza meg a felelősségi köröket és az ellenőrzéseket, és hangolja össze a szerepeket minden szinten.

Indítsa el az ingyenes próbaverziót, és teremtsen megbízható alapot folyamatainak irányításához, kezeléséhez és folyamatos fejlesztéséhez.

Indítsa el ingyenes próbaverzióját