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

Tarih ve saat işlevleri

Tarih ve saat bileşenlerini çıkarmaya ve tarih aritmetiği yapmaya yönelik işlevler.

Zaman damgalarıyla çalışma

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

Yaygın örüntüler

  • Tarih bölümlerini çıkarın:

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

  • Süreyi hesaplayın:

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

  • Zaman aralıkları oluşturun:

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

  • Bir tarihe zaman ekleyin:

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

now

()

Geçerli UTC zaman damgasını, Unix döneminden bu yana geçen milisaniye cinsinden döndürür.

Döndürür number
Ö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ür number
Örnekler
year(StartTime) → 2024
Ayrıca bkz.
monthdayquarter

month

(timestamp)

Bir zaman damgasından 1-12 aralığındaki ayı çıkarır.

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

Mart
Ayrıca bkz.
yeardaymonthName

day

(timestamp)

Bir zaman damgasından 1-31 aralığındaki ayın gününü çıkarır.

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

hour

(timestamp)

Bir zaman damgasından 0-23 aralığındaki saati çıkarır.

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

14:00
Ayrıca bkz.
minutesecond

minute

(timestamp)

Bir zaman damgasından 0-59 aralığındaki dakikayı çıkarır.

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

second

(timestamp)

Bir zaman damgasından 0-59 aralığındaki saniyeyi çıkarır.

Parametreler
timestamp number Zaman damgası değeri
Döndürür number
Ö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ür number
Örnekler
dayOfWeek(StartTime) → 1

Pazartesi
Ayrıca bkz.
dayNameday

dayName

(timestamp)

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

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

monthName

(timestamp)

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

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

quarter

(timestamp)

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

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

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

weekOfYear

(timestamp)

Bir zaman damgasından 1-53 aralığındaki ISO hafta numarasını döndürür.

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

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

dayOfYear

(timestamp)

Bir zaman damgasından yılın 1-366 aralığındaki gününü döndürür.

Parametreler
timestamp number Zaman damgası değeri
Döndürür number
Ö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ür number
Örnekler
dateAdd(StartTime, 7, "day") → Zaman damgasına 7 gün eklenir
dateAdd(StartTime, -1, "month") → Zaman damgasından 1 ay çıkarılır
dateAdd(1710766245000, 1, "day") → 1710852645000

18 Mart 2024'e 1 gün ekler
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ür number
Ö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 Pazartesi ile Cuma arasındaki iş günlerinden birine denk gelip gelmediğini kontrol eder.

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

StartTime bir hafta içi günündeyse
Ayrıca bkz.
workingDaysBetweendayOfWeek

workingDaysBetween

(startTimestamp, endTimestamp)

İki zaman damgası arasındaki Pazartesi-Cuma iş günlerini sayar.

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

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

Yaklaşık bir backend/iş takvimi yardımcı işlevidir. Resmî tatilleri hesaba katmaz, yalnızca hafta sonlarını dikkate alır.
Ayrıca bkz.
isBusinessDaydateDiff

toUtc

(timestamp, offsetHours)

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

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

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

toUtc(1710766245000, 2) → 1710759045000

Zaman damgasını UTC+2'den UTC’ye dönüştürür
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ı, farkı ekleyerek yerel saate dönüştürür.

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

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

toLocal(1710766245000, -5) → 1710748245000

UTC zaman damgasını EST’ye (UTC-5) dönüştürür
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 Kaynak saat diliminin saat cinsinden farkı
toOffset number Hedef saat diliminin saat cinsinden farkı
Döndürür number
Örnekler
convertTimezone(StartTime, 1, -5) → zaman damgası 6 saat geri ayarlanır

CET’den EST’ye

convertTimezone(1710766245000, 1, -5) → 1710744645000

UTC+1'den UTC-5'e dönüştürür
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