Bu sayfada
> kaynaklar > belgeler > ifadeler > Tarih ve saat işlevleri

Tarih ve saat işlevleri

Tarih ve saat bileşenlerini almak ve tarih aritmetiği yapmak için kullanılan işlevler.

Zaman damgalarıyla çalışma

ProcessMind’de zaman damgaları, 1 Ocak 1970’ten (Unix epoch) bu yana geçen milisaniyeleri gösteren sayılar olarak saklanır. Tarih işlevleri bu zaman damgası değerleriyle çalışır.

Yaygın örüntüler

  • Tarih bileşenlerini alma:

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

  • Süreyi hesaplama:

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

  • Zaman aralıkları oluşturma:

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

  • Tarihe zaman ekleme:

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

now

()

Geçerli UTC zaman damgasını, Unix epoch başlangıcından itibaren milisaniye cinsinden döndürür.

Döndürülen değer sayı
Örnekler
now() → 1708963200000

Geçerli zaman damgası

year

(timestamp)

Bir zaman damgasından yılı çıkarır.

Parametreler
timestamp number Zaman damgası değeri
Döndürülen değer sayı
Örnekler
year(StartTime) → 2024
Ayrıca bkz.
monthdayquarter

month

(timestamp)

Bir zaman damgasından ayı (1-12) çıkarır.

Parametreler
timestamp number Zaman damgası değeri
Döndürülen değer sayı
Örnekler
month(StartTime) → 3

Mart
Ayrıca bkz.
yeardaymonthName

day

(timestamp)

Bir zaman damgasından ayın gününü (1-31) çıkarır.

Parametreler
timestamp number Zaman damgası değeri
Döndürülen değer sayı
Örnekler
day(StartTime) → 18
Ayrıca bkz.
yearmonthdayOfWeek

hour

(timestamp)

Bir zaman damgasından saati (0-23) çıkarır.

Parametreler
timestamp number Zaman damgası değeri
Döndürülen değer sayı
Örnekler
hour(StartTime) → 14

14:00
Ayrıca bkz.
minutesecond

minute

(timestamp)

Bir zaman damgasından dakikayı (0-59) çıkarır.

Parametreler
timestamp number Zaman damgası değeri
Döndürülen değer sayı
Örnekler
minute(StartTime) → 30
Ayrıca bkz.
hoursecond

second

(timestamp)

Bir zaman damgasından saniyeyi (0-59) çıkarır.

Parametreler
timestamp number Zaman damgası değeri
Döndürülen değer sayı
Örnekler
second(StartTime) → 45
Ayrıca bkz.
hourminute

dayOfWeek

(timestamp)

Bir zaman damgasından haftanın gününü döndürür; 1 Pazartesi, 7 Pazar anlamına gelir.

Parametreler
timestamp number Zaman damgası değeri
Döndürülen değer sayı
Örnekler
dayOfWeek(StartTime) → 1

Pazartesi
Ayrıca bkz.
dayNameday

dayName

(timestamp)

Bir zaman damgasındaki haftanın gününün adını döndürür.

Parametreler
timestamp number Zaman damgası değeri
Döndürülen değer dize
Örnekler
dayName(StartTime) → Pazartesi
Ayrıca bkz.
dayOfWeekmonthName

monthName

(timestamp)

Bir zaman damgasındaki ayın adını döndürür.

Parametreler
timestamp number Zaman damgası değeri
Döndürülen değer dize
Örnekler
monthName(StartTime) → Mart
Ayrıca bkz.
monthdayName

quarter

(timestamp)

Bir zaman damgasındaki çeyreği (1-4) döndürür.

Parametreler
timestamp number Zaman damgası değeri
Döndürülen değer sayı
Örnekler
quarter(StartTime) → 1

1. çeyrek (Ocak-Mart)
Ayrıca bkz.
yearmonth

weekOfYear

(timestamp)

Bir zaman damgasının ISO hafta numarasını (1-53) döndürür.

Parametreler
timestamp number Zaman damgası değeri
Döndürülen değer sayı
Örnekler
weekOfYear(StartTime) → 12

2024'ün 12. haftası
Ayrıca bkz.
dayOfYearyear

dayOfYear

(timestamp)

Bir zaman damgasının yılın kaçıncı günü olduğunu (1-366) döndürür.

Parametreler
timestamp number Zaman damgası değeri
Döndürülen değer sayı
Örnekler
dayOfYear(StartTime) → 78

Yılın 78. günü (18 Mart 2024)
Ayrıca bkz.
weekOfYearday

dateAdd

(timestamp, amount, unit)

Bir zaman damgasına belirtilen süreyi ekler.

Parametreler
timestamp number Başlangıç zaman damgası
amount number Eklenecek miktar; negatif olabilir
unit string Birim: 'year', 'month', 'day', 'hour', 'minute', 'second'
Döndürülen değer sayı
Örnekler
dateAdd(StartTime, 7, "day") → zaman damgası + 7 gün
dateAdd(StartTime, -1, "month") → zaman damgası - 1 ay
dateAdd(1710766245000, 1, "day") → 1710852645000

18 Mart 2024'e 1 gün ekleyin
Ayrıca bkz.
dateDiff

dateDiff

(startTimestamp, endTimestamp, unit)

Belirtilen birimde iki zaman damgası arasındaki farkı hesaplar.

Parametreler
startTimestamp number Başlangıç zaman damgası
endTimestamp number Bitiş zaman damgası
unit string Birim: 'day', 'hour', 'minute', 'second'
Döndürülen değer sayı
Örnekler
dateDiff(StartTime, EndTime, "minute") → 150

Dakika cinsinden süre

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

Kesin farkı gösteren ondalık bir değer döndürür.
Ayrıca bkz.
dateAdd

isBusinessDay

(timestamp)

Bir zaman damgasının iş gününe (pazartesiden cumaya) denk gelip gelmediğini kontrol eder.

Parametreler
timestamp number Kontrol edilecek zaman damgası
Döndürülen değer boolean
Örnekler
isBusinessDay(StartTime) → true

StartTime hafta içine denk geliyorsa
Ayrıca bkz.
workingDaysBetweendayOfWeek

workingDaysBetween

(startTimestamp, endTimestamp)

İki zaman damgası arasındaki iş günlerini (pazartesiden cumaya) sayar.

Parametreler
startTimestamp number Başlangıç zaman damgası
endTimestamp number Bitiş zaman damgası
Döndürülen değer sayı
Örnekler
workingDaysBetween(StartTime, EndTime) → Tarihler arasındaki hafta içi gün sayısı
workingDaysBetween(1710766245000, 1711371045000) → 5

18 Mart Pazartesi ile 25 Mart 2024 Pazartesi arasında 5 iş günü
Notlar

Yaklaşık sonuç veren, arka uç ve iş takvimi için yardımcı bir işlevdir. Resmî tatilleri hesaba katmaz, yalnızca hafta sonlarını dikkate alır.
Ayrıca bkz.
isBusinessDaydateDiff

toUtc

(timestamp, offsetHours)

Yerel zaman damgasını, saat dilimi farkını çıkararak UTC’ye dönüştürür.

Parametreler
timestamp number Yerel zaman damgası
offsetHours number Saat cinsinden saat dilimi farkı
Döndürülen değer sayı
Örnekler
toUtc(StartTime, 2) → StartTime - 2 saat

UTC+2'den dönüştürün

toUtc(1710766245000, 2) → 1710759045000

Zaman damgasını UTC+2'den UTC’ye dönüştürün
Notlar

Saat dilimi dönüşümü şu anda IANA saat dilimi adlarını değil, saat cinsinden sayısal UTC farklarını destekler.
Ayrıca bkz.
toLocalconvertTimezone

toLocal

(timestamp, offsetHours)

UTC zaman damgasını, saat dilimi farkını ekleyerek yerel saate dönüştürür.

Parametreler
timestamp number UTC zaman damgası
offsetHours number Saat cinsinden saat dilimi farkı
Döndürülen değer sayı
Örnekler
toLocal(StartTime, -5) → StartTime - 5 saat

EST’ye dönüştürün

toLocal(1710766245000, -5) → 1710748245000

UTC zaman damgasını EST’ye (UTC-5) dönüştürün
Notlar

Saat dilimi dönüşümü şu anda IANA saat dilimi adlarını değil, saat cinsinden sayısal UTC farklarını destekler.
Ayrıca bkz.
toUtcconvertTimezone

convertTimezone

(timestamp, fromOffset, toOffset)

Bir zaman damgasını bir saat diliminden diğerine dönüştürür.

Parametreler
timestamp number Dönüştürülecek zaman damgası
fromOffset number Saat cinsinden kaynak saat dilimi farkı
toOffset number Saat cinsinden hedef saat dilimi farkı
Döndürülen değer sayı
Örnekler
convertTimezone(StartTime, 1, -5) → zaman damgası 6 saat geri alındı

CET’ten EST’ye

convertTimezone(1710766245000, 1, -5) → 1710744645000

UTC+1'den UTC-5'e dönüştürün
Notlar

Saat dilimi dönüşümü şu anda IANA saat dilimi adlarını değil, saat cinsinden sayısal UTC farklarını destekler.
Ayrıca bkz.
toUtctoLocal

İlgili konular

Süreçlerinizi daha iyi tasarlayın. Bağlantılı bir mimari kurun. Kontrolü elinizde tutun.

Kredi kartı gerekmeden, beklemeden hemen erişin. Kuruluşunuzdaki çalışma biçimini net ve birbiriyle bağlantılı süreç tasarımlarına dönüştürün.

Süreç mimarinizi oluşturun, sahiplik ve kontrolleri tanımlayın; rol ve sorumlulukları her düzeyde uyumlu hâle getirin.

Ücretsiz denemeyi başlatın; süreçlerinizi yönetmek ve sürekli iyileştirmek için güvenilir bir temel oluşturun.

Ücretsiz denemeyi başlatın