Na této stránce

> zdroje > dokumentace > vyrazy > Funkce pro datum a čas

Funkce pro datum a čas

Funkce pro získávání částí data a času a pro výpočty s daty.

Práce s časovými značkami

ProcessMind ukládá časové značky jako čísla představující počet milisekund od 1. ledna 1970 (Unix epoch). Funkce pro datum pracují s těmito hodnotami.

Běžné postupy

Získání částí data:

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

Výpočet trvání:

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

Vytvoření časových intervalů:

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

Přičtení času k datu:

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

now

()

Vrátí aktuální časové razítko UTC v milisekundách od začátku Unixové epochy.

Návratová hodnota	`číslo`
Příklady	`now()` → `1708963200000` Aktuální časové razítko

year

(timestamp)

Z časového razítka získá rok.

Parametry

timestamp number Hodnota časového razítka

Návratová hodnota číslo

Příklady

year(StartTime) → 2024

Viz také

měsíc den quarter

month

(timestamp)

Z časového razítka získá měsíc (1–12).

Parametry

timestamp number Hodnota časového razítka

Návratová hodnota číslo

Příklady

month(StartTime) → 3

March

Viz také

rok den monthName

day

(timestamp)

Z časového razítka získá den v měsíci (1–31).

Parametry

timestamp number Hodnota časového razítka

Návratová hodnota číslo

Příklady

day(StartTime) → 18

Viz také

rok měsíc dayOfWeek

hour

(timestamp)

Z časového razítka získá hodinu (0–23).

Parametry

timestamp number Hodnota časového razítka

Návratová hodnota číslo

Příklady

hour(StartTime) → 14

14:00

Viz také

minuta second

minute

(timestamp)

Z časového razítka získá minutu (0–59).

Parametry

timestamp number Hodnota časového razítka

Návratová hodnota číslo

Příklady

minute(StartTime) → 30

Viz také

hodina second

second

(timestamp)

Z časového razítka získá sekundu (0–59).

Parametry

timestamp number Hodnota časového razítka

Návratová hodnota číslo

Příklady

second(StartTime) → 45

Viz také

hodina minuta

dayOfWeek

(timestamp)

Vrátí den v týdnu podle časového razítka, kde 1 = pondělí a 7 = neděle.

Parametry

timestamp number Hodnota časového razítka

Návratová hodnota číslo

Příklady

dayOfWeek(StartTime) → 1

Pondělí

Viz také

dayName den

dayName

(timestamp)

Vrátí název dne v týdnu podle časového razítka.

Parametry

timestamp number Hodnota časového razítka

Návratová hodnota řetězec

Příklady

dayName(StartTime) → Pondělí

Viz také

dayOfWeek monthName

monthName

(timestamp)

Vrátí název měsíce podle časového razítka.

Parametry

timestamp number Hodnota časového razítka

Návratová hodnota řetězec

Příklady

monthName(StartTime) → Březen

Viz také

měsíc dayName

quarter

(timestamp)

Vrátí čtvrtletí (1–4) podle časového razítka.

Parametry

timestamp number Hodnota časového razítka

Návratová hodnota číslo

Příklady

quarter(StartTime) → 1

1. čtvrtletí (leden–březen)

Viz také

rok měsíc

weekOfYear

(timestamp)

Vrátí číslo týdne podle ISO (1–53) pro dané časové razítko.

Parametry

timestamp number Hodnota časového razítka

Návratová hodnota číslo

Příklady

weekOfYear(StartTime) → 12

12. týden roku 2024

Viz také

dayOfYear rok

dayOfYear

(timestamp)

Vrátí pořadový den v roce (1–366) podle časového razítka.

Parametry

timestamp number Hodnota časového razítka

Návratová hodnota číslo

Příklady

dayOfYear(StartTime) → 78

78. den roku (18. března 2024)

Viz také

weekOfYear den

dateAdd

(timestamp, amount, unit)

Přičte k časovému razítku zadaný časový úsek.

Parametry

timestamp	`number`	Počáteční časové razítko
amount	`number`	Hodnota, kterou chcete přičíst; může být záporná
unit	`string`	Jednotka: 'year', 'month', 'day', 'hour', 'minute', 'second'

Návratová hodnota číslo

Příklady

dateAdd(StartTime, 7, "day") → časové razítko + 7 dní

dateAdd(StartTime, -1, "month") → časové razítko − 1 měsíc

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

Přičte 1 den k 18. březnu 2024

Viz také

dateDiff

(startTimestamp, endTimestamp, unit)

Vypočítá rozdíl mezi dvěma časovými razítky v zadané jednotce.

Parametry

startTimestamp	`number`	Časové razítko začátku
endTimestamp	`number`	Koncové časové razítko
unit	`string`	Jednotka: 'day', 'hour', 'minute', 'second'

Návratová hodnota číslo

Příklady

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

Doba trvání v minutách

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

Poznámky

Vrátí desetinnou hodnotu představující přesný rozdíl.

Viz také

dateAdd

isBusinessDay

(timestamp)

Ověří, zda časové razítko připadá na pracovní den (pondělí až pátek).

Parametry

timestamp number Časové razítko k ověření

Návratová hodnota logická hodnota

Příklady

isBusinessDay(StartTime) → true

Pokud StartTime připadá na všední den

Viz také

workingDaysBetween dayOfWeek

workingDaysBetween

(startTimestamp, endTimestamp)

Spočítá pracovní dny (pondělí až pátek) mezi dvěma časovými razítky.

Parametry

startTimestamp	`number`	Časové razítko začátku
endTimestamp	`number`	Koncové časové razítko

Návratová hodnota číslo

Příklady

workingDaysBetween(StartTime, EndTime) → Počet všedních dnů mezi daty

workingDaysBetween(1710766245000, 1711371045000) → 5

5 pracovních dnů mezi pondělím 18. března a pondělím 25. března 2024

Poznámky

Přibližná pomocná funkce pro backend a pracovní kalendář. Nezohledňuje svátky, pouze víkendy.

Viz také

isBusinessDay dateDiff

toUtc

(timestamp, offsetHours)

Převede místní časové razítko na UTC odečtením časového posunu.

Parametry

timestamp	`number`	Místní časové razítko
offsetHours	`number`	Časový posun v hodinách

Návratová hodnota číslo

Příklady

toUtc(StartTime, 2) → StartTime − 2 hodiny

Převod z UTC+2

toUtc(1710766245000, 2) → 1710759045000

Převede časové razítko z UTC+2 na UTC

Poznámky

Převod časových pásem aktuálně podporuje číselné posuny UTC v hodinách, nikoli názvy časových pásem IANA.

Viz také

toLocal convertTimezone

toLocal

(timestamp, offsetHours)

Převede časové razítko UTC na místní čas přičtením časového posunu.

Parametry

timestamp	`number`	Časové razítko UTC
offsetHours	`number`	Časový posun v hodinách

Návratová hodnota číslo

Příklady

toLocal(StartTime, -5) → StartTime − 5 hodin

Převod na EST

toLocal(1710766245000, -5) → 1710748245000

Převede časové razítko UTC na EST (UTC−5)

Poznámky

Převod časových pásem aktuálně podporuje číselné posuny UTC v hodinách, nikoli názvy časových pásem IANA.

Viz také

toUtc convertTimezone

convertTimezone

(timestamp, fromOffset, toOffset)

Převede časové razítko z jednoho časového pásma do jiného.

Parametry

timestamp	`number`	Časové razítko k převodu
fromOffset	`number`	Posun zdrojového časového pásma v hodinách
toOffset	`number`	Posun cílového časového pásma v hodinách

Návratová hodnota číslo

Příklady

convertTimezone(StartTime, 1, -5) → časové razítko posunuté o −6 hodin

CET na EST

convertTimezone(1710766245000, 1, -5) → 1710744645000

Převod z UTC+1 na UTC−5

Poznámky

Převod časových pásem aktuálně podporuje číselné posuny UTC v hodinách, nikoli názvy časových pásem IANA.

Viz také

toUtc toLocal

Související témata

Přehled výrazů: všechny funkce pro výrazy.

Navrhujte lepší procesy. Propojte je do společné architektury. Mějte vše pod kontrolou.

Získejte přístup ihned, bez čekání a bez platební karty. Převádějte způsob práce ve své organizaci do přehledných a propojených návrhů procesů.

Vytvořte architekturu procesů, určete vlastníky a kontrolní mechanismy a slaďte role a odpovědnosti na všech úrovních.

Spusťte zkušební verzi a vytvořte spolehlivý základ pro řízení, správu a průběžné zlepšování procesů.

Získejte zkušební verzi zdarma