Na tej stronie

> zasoby > dokumentacja > wyrazenia > Funkcje daty i czasu

Funkcje daty i czasu

Funkcje do wyodrębniania składników daty i czasu oraz wykonywania obliczeń na datach.

Praca ze znacznikami czasu

W ProcessMind znaczniki czasu są przechowywane jako liczby oznaczające liczbę milisekund od 1 stycznia 1970 roku (epoki Unix). Funkcje daty działają na tych wartościach.

Typowe zastosowania

Wyodrębnianie składników daty:

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

Obliczanie czasu trwania:

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

Tworzenie przedziałów czasowych:

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

Dodawanie czasu do daty:

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

now

()

Zwraca bieżący znacznik czasu UTC w milisekundach od początku epoki Unix.

Zwracana wartość	`liczba`
Przykłady	`now()` → `1708963200000` Bieżący znacznik czasu

year

(timestamp)

Pobiera rok ze znacznika czasu.

Parametry

timestamp number Wartość znacznika czasu

Zwracana wartość liczba

Przykłady

year(StartTime) → 2024

Zobacz także

miesiąc dzień quarter

month

(timestamp)

Pobiera miesiąc (1–12) ze znacznika czasu.

Parametry

timestamp number Wartość znacznika czasu

Zwracana wartość liczba

Przykłady

month(StartTime) → 3

March

Zobacz także

rok dzień monthName

day

(timestamp)

Pobiera dzień miesiąca (1–31) ze znacznika czasu.

Parametry

timestamp number Wartość znacznika czasu

Zwracana wartość liczba

Przykłady

day(StartTime) → 18

Zobacz także

rok miesiąc dayOfWeek

hour

(timestamp)

Pobiera godzinę (0–23) ze znacznika czasu.

Parametry

timestamp number Wartość znacznika czasu

Zwracana wartość liczba

Przykłady

hour(StartTime) → 14

14:00

Zobacz także

minuta second

minute

(timestamp)

Pobiera minutę (0–59) ze znacznika czasu.

Parametry

timestamp number Wartość znacznika czasu

Zwracana wartość liczba

Przykłady

minute(StartTime) → 30

Zobacz także

godzina second

second

(timestamp)

Pobiera sekundę (0–59) ze znacznika czasu.

Parametry

timestamp number Wartość znacznika czasu

Zwracana wartość liczba

Przykłady

second(StartTime) → 45

Zobacz także

godzina minuta

dayOfWeek

(timestamp)

Zwraca dzień tygodnia na podstawie znacznika czasu, gdzie 1 = poniedziałek, a 7 = niedziela.

Parametry

timestamp number Wartość znacznika czasu

Zwracana wartość liczba

Przykłady

dayOfWeek(StartTime) → 1

Poniedziałek

Zobacz także

dayName dzień

dayName

(timestamp)

Zwraca nazwę dnia tygodnia na podstawie znacznika czasu.

Parametry

timestamp number Wartość znacznika czasu

Zwracana wartość ciąg znaków

Przykłady

dayName(StartTime) → Poniedziałek

Zobacz także

dayOfWeek monthName

monthName

(timestamp)

Zwraca nazwę miesiąca na podstawie znacznika czasu.

Parametry

timestamp number Wartość znacznika czasu

Zwracana wartość ciąg znaków

Przykłady

monthName(StartTime) → Marzec

Zobacz także

miesiąc dayName

quarter

(timestamp)

Zwraca kwartał (1–4) na podstawie znacznika czasu.

Parametry

timestamp number Wartość znacznika czasu

Zwracana wartość liczba

Przykłady

quarter(StartTime) → 1

I kwartał (styczeń–marzec)

Zobacz także

rok miesiąc

weekOfYear

(timestamp)

Zwraca numer tygodnia ISO (1–53) na podstawie znacznika czasu.

Parametry

timestamp number Wartość znacznika czasu

Zwracana wartość liczba

Przykłady

weekOfYear(StartTime) → 12

12. tydzień 2024 roku

Zobacz także

dayOfYear rok

dayOfYear

(timestamp)

Zwraca dzień roku (1–366) na podstawie znacznika czasu.

Parametry

timestamp number Wartość znacznika czasu

Zwracana wartość liczba

Przykłady

dayOfYear(StartTime) → 78

78. dzień roku (18 marca 2024 r.)

Zobacz także

weekOfYear dzień

dateAdd

(timestamp, amount, unit)

Dodaje określony czas do znacznika czasu.

Parametry

timestamp	`number`	Początkowy znacznik czasu
amount	`number`	Wartość do dodania; może być ujemna
unit	`string`	Jednostka: 'year', 'month', 'day', 'hour', 'minute', 'second'

Zwracana wartość liczba

Przykłady

dateAdd(StartTime, 7, "day") → znacznik czasu + 7 dni

dateAdd(StartTime, -1, "month") → znacznik czasu - 1 miesiąc

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

Dodaj 1 dzień do 18 marca 2024 r.

Zobacz także

dateDiff

(startTimestamp, endTimestamp, unit)

Oblicza różnicę między dwoma znacznikami czasu w wybranej jednostce.

Parametry

startTimestamp	`number`	Początkowy znacznik czasu
endTimestamp	`number`	Końcowy znacznik czasu
unit	`string`	Jednostka: 'day', 'hour', 'minute', 'second'

Zwracana wartość liczba

Przykłady

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

Czas trwania w minutach

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

Uwagi

Zwraca liczbę dziesiętną odpowiadającą dokładnej różnicy.

Zobacz także

dateAdd

isBusinessDay

(timestamp)

Sprawdza, czy znacznik czasu przypada na dzień roboczy (od poniedziałku do piątku).

Parametry

timestamp number Sprawdzany znacznik czasu

Zwracana wartość wartość logiczna

Przykłady

isBusinessDay(StartTime) → true

Jeśli StartTime przypada w dzień roboczy

Zobacz także

workingDaysBetween dayOfWeek

workingDaysBetween

(startTimestamp, endTimestamp)

Zlicza dni robocze (od poniedziałku do piątku) między dwoma znacznikami czasu.

Parametry

startTimestamp	`number`	Początkowy znacznik czasu
endTimestamp	`number`	Końcowy znacznik czasu

Zwracana wartość liczba

Przykłady

workingDaysBetween(StartTime, EndTime) → Liczba dni roboczych między datami

workingDaysBetween(1710766245000, 1711371045000) → 5

5 dni roboczych między poniedziałkiem 18 marca a poniedziałkiem 25 marca 2024 r.

Uwagi

Przybliżona funkcja pomocnicza działająca po stronie backendu i uwzględniająca dni robocze. Nie bierze pod uwagę świąt, tylko weekendy.

Zobacz także

isBusinessDay dateDiff

toUtc

(timestamp, offsetHours)

Przekształca lokalny znacznik czasu na UTC, odejmując przesunięcie strefy czasowej.

Parametry

timestamp	`number`	Lokalny znacznik czasu
offsetHours	`number`	Przesunięcie strefy czasowej w godzinach

Zwracana wartość liczba

Przykłady

toUtc(StartTime, 2) → StartTime - 2 godziny

Przekształcenie z UTC+2

toUtc(1710766245000, 2) → 1710759045000

Przekształć znacznik czasu z UTC+2 na UTC

Uwagi

Przekształcanie stref czasowych obsługuje obecnie przesunięcie UTC podane jako liczba godzin, ale nie nazwy stref IANA.

Zobacz także

toLocal convertTimezone

toLocal

(timestamp, offsetHours)

Przekształca znacznik czasu UTC na czas lokalny, dodając przesunięcie strefy czasowej.

Parametry

timestamp	`number`	Znacznik czasu UTC
offsetHours	`number`	Przesunięcie strefy czasowej w godzinach

Zwracana wartość liczba

Przykłady

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

Przekształcenie na EST

toLocal(1710766245000, -5) → 1710748245000

Przekształć znacznik czasu UTC na EST (UTC-5)

Uwagi

Przekształcanie stref czasowych obsługuje obecnie przesunięcie UTC podane jako liczba godzin, ale nie nazwy stref IANA.

Zobacz także

toUtc convertTimezone

convertTimezone

(timestamp, fromOffset, toOffset)

Przekształca znacznik czasu z jednej strefy czasowej na inną.

Parametry

timestamp	`number`	Znacznik czasu do przekształcenia
fromOffset	`number`	Przesunięcie źródłowej strefy czasowej w godzinach
toOffset	`number`	Przesunięcie docelowej strefy czasowej w godzinach

Zwracana wartość liczba

Przykłady

convertTimezone(StartTime, 1, -5) → znacznik czasu przesunięty o -6 godzin

CET na EST

convertTimezone(1710766245000, 1, -5) → 1710744645000

Przekształć z UTC+1 na UTC-5

Uwagi

Przekształcanie stref czasowych obsługuje obecnie przesunięcie UTC podane jako liczba godzin, ale nie nazwy stref IANA.

Zobacz także

toUtc toLocal

Powiązane tematy

Przegląd wyrażeń: wszystkie funkcje wyrażeń.

Projektuj lepsze procesy. Buduj spójną architekturę. Zachowaj kontrolę.

Uzyskaj dostęp od razu, bez karty kredytowej i czekania. Przedstaw sposób działania organizacji w postaci przejrzystych, powiązanych modeli procesów.

Buduj architekturę procesów, określaj właścicieli i mechanizmy kontroli oraz uzgadniaj role i zakresy odpowiedzialności na każdym poziomie.

Rozpocznij okres próbny i stwórz solidną podstawę do nadzorowania, zarządzania i ciągłego doskonalenia procesów.

Rozpocznij okres próbny