Di halaman ini
> sumber daya > dokumentasi > ekspresi > Fungsi tanggal dan waktu

Fungsi tanggal dan waktu

Fungsi untuk mengambil komponen tanggal/waktu dan melakukan perhitungan tanggal.

Menggunakan timestamp

Di ProcessMind, timestamp disimpan sebagai angka yang menunjukkan milidetik sejak 1 Januari 1970 (Unix epoch). Fungsi tanggal menggunakan nilai timestamp ini.

Pola umum

  • Mengambil bagian tanggal:

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

  • Menghitung durasi:

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

  • Membuat kelompok waktu:

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

  • Menambahkan waktu ke tanggal:

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

now

()

Mengembalikan timestamp UTC saat ini dalam milidetik sejak Unix epoch.

Nilai yang dikembalikan angka
Contoh
now() → 1708963200000

Timestamp saat ini

year

(timestamp)

Mengambil tahun dari timestamp.

Parameter
timestamp number Nilai timestamp
Nilai yang dikembalikan angka
Contoh
year(StartTime) → 2024
Lihat juga
bulanhariquarter

month

(timestamp)

Mengambil bulan (1-12) dari timestamp.

Parameter
timestamp number Nilai timestamp
Nilai yang dikembalikan angka
Contoh
month(StartTime) → 3

Maret
Lihat juga
tahunharimonthName

day

(timestamp)

Mengambil tanggal dalam bulan (1-31) dari timestamp.

Parameter
timestamp number Nilai timestamp
Nilai yang dikembalikan angka
Contoh
day(StartTime) → 18
Lihat juga
tahunbulandayOfWeek

hour

(timestamp)

Mengambil jam (0-23) dari timestamp.

Parameter
timestamp number Nilai timestamp
Nilai yang dikembalikan angka
Contoh
hour(StartTime) → 14

14.00
Lihat juga
menitsecond

minute

(timestamp)

Mengambil menit (0-59) dari timestamp.

Parameter
timestamp number Nilai timestamp
Nilai yang dikembalikan angka
Contoh
minute(StartTime) → 30
Lihat juga
jamsecond

second

(timestamp)

Mengambil detik (0-59) dari timestamp.

Parameter
timestamp number Nilai timestamp
Nilai yang dikembalikan angka
Contoh
second(StartTime) → 45
Lihat juga
jammenit

dayOfWeek

(timestamp)

Mengambil hari dalam seminggu dari timestamp, dengan 1=Senin dan 7=Minggu.

Parameter
timestamp number Nilai timestamp
Nilai yang dikembalikan angka
Contoh
dayOfWeek(StartTime) → 1

Senin
Lihat juga
dayNamehari

dayName

(timestamp)

Mengambil nama hari dalam seminggu dari timestamp.

Parameter
timestamp number Nilai timestamp
Nilai yang dikembalikan string
Contoh
dayName(StartTime) → Senin
Lihat juga
dayOfWeekmonthName

monthName

(timestamp)

Mengambil nama bulan dari timestamp.

Parameter
timestamp number Nilai timestamp
Nilai yang dikembalikan string
Contoh
monthName(StartTime) → Maret
Lihat juga
bulandayName

quarter

(timestamp)

Mengambil kuartal (1-4) dari timestamp.

Parameter
timestamp number Nilai timestamp
Nilai yang dikembalikan angka
Contoh
quarter(StartTime) → 1

Q1 (Jan-Mar)
Lihat juga
tahunbulan

weekOfYear

(timestamp)

Mengambil nomor minggu ISO (1-53) dari timestamp.

Parameter
timestamp number Nilai timestamp
Nilai yang dikembalikan angka
Contoh
weekOfYear(StartTime) → 12

Minggu ke-12 tahun 2024
Lihat juga
dayOfYeartahun

dayOfYear

(timestamp)

Mengambil hari keberapa dalam setahun (1-366) dari timestamp.

Parameter
timestamp number Nilai timestamp
Nilai yang dikembalikan angka
Contoh
dayOfYear(StartTime) → 78

Hari ke-78 dalam setahun (18 Maret 2024)
Lihat juga
weekOfYearhari

dateAdd

(timestamp, amount, unit)

Menambahkan durasi tertentu ke timestamp.

Parameter
timestamp number Timestamp awal
amount number Jumlah yang ditambahkan, bisa bernilai negatif
unit string Satuan: 'year', 'month', 'day', 'hour', 'minute', 'second'
Nilai yang dikembalikan angka
Contoh
dateAdd(StartTime, 7, "day") → timestamp + 7 hari
dateAdd(StartTime, -1, "month") → timestamp - 1 bulan
dateAdd(1710766245000, 1, "day") → 1710852645000

Tambahkan 1 hari ke 18 Maret 2024
Lihat juga
dateDiff

dateDiff

(startTimestamp, endTimestamp, unit)

Menghitung selisih antara dua timestamp dalam satuan yang ditentukan.

Parameter
startTimestamp number Stempel waktu mulai
endTimestamp number Timestamp akhir
unit string Satuan: 'day', 'hour', 'minute', 'second'
Nilai yang dikembalikan angka
Contoh
dateDiff(StartTime, EndTime, "minute") → 150

Durasi dalam menit

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

Menghasilkan angka desimal yang menunjukkan selisih tepat.
Lihat juga
dateAdd

isBusinessDay

(timestamp)

Memeriksa apakah timestamp jatuh pada hari kerja (Senin sampai Jumat).

Parameter
timestamp number Timestamp yang diperiksa
Nilai yang dikembalikan boolean
Contoh
isBusinessDay(StartTime) → true

Jika StartTime jatuh pada hari kerja
Lihat juga
workingDaysBetweendayOfWeek

workingDaysBetween

(startTimestamp, endTimestamp)

Menghitung jumlah hari kerja (Senin sampai Jumat) di antara dua timestamp.

Parameter
startTimestamp number Stempel waktu mulai
endTimestamp number Timestamp akhir
Nilai yang dikembalikan angka
Contoh
workingDaysBetween(StartTime, EndTime) → Jumlah hari kerja di antara tanggal tersebut
workingDaysBetween(1710766245000, 1711371045000) → 5

5 hari kerja antara Senin, 18 Maret dan Senin, 25 Maret 2024
Catatan

Fungsi bantu perkiraan untuk kalender bisnis di backend. Tidak memperhitungkan hari libur, hanya akhir pekan.
Lihat juga
isBusinessDaydateDiff

toUtc

(timestamp, offsetHours)

Mengubah timestamp lokal ke UTC dengan mengurangi selisih zona waktu.

Parameter
timestamp number Timestamp lokal
offsetHours number Selisih zona waktu dalam jam
Nilai yang dikembalikan angka
Contoh
toUtc(StartTime, 2) → StartTime - 2 jam

Ubah dari UTC+2

toUtc(1710766245000, 2) → 1710759045000

Ubah timestamp dari UTC+2 ke UTC
Catatan

Konversi zona waktu saat ini mendukung selisih UTC numerik dalam jam, bukan nama zona waktu IANA.
Lihat juga
toLocalconvertTimezone

toLocal

(timestamp, offsetHours)

Mengubah timestamp UTC ke waktu lokal dengan menambahkan selisih zona waktu.

Parameter
timestamp number Timestamp UTC
offsetHours number Selisih zona waktu dalam jam
Nilai yang dikembalikan angka
Contoh
toLocal(StartTime, -5) → StartTime - 5 jam

Ubah ke EST

toLocal(1710766245000, -5) → 1710748245000

Ubah timestamp UTC ke EST (UTC-5)
Catatan

Konversi zona waktu saat ini mendukung selisih UTC numerik dalam jam, bukan nama zona waktu IANA.
Lihat juga
toUtcconvertTimezone

convertTimezone

(timestamp, fromOffset, toOffset)

Mengubah timestamp dari satu zona waktu ke zona waktu lain.

Parameter
timestamp number Timestamp yang akan diubah
fromOffset number Selisih zona waktu sumber dalam jam
toOffset number Selisih zona waktu tujuan dalam jam
Nilai yang dikembalikan angka
Contoh
convertTimezone(StartTime, 1, -5) → timestamp disesuaikan -6 jam

CET ke EST

convertTimezone(1710766245000, 1, -5) → 1710744645000

Ubah dari UTC+1 ke UTC-5
Catatan

Konversi zona waktu saat ini mendukung selisih UTC numerik dalam jam, bukan nama zona waktu IANA.
Lihat juga
toUtctoLocal

Topik terkait

Rancang proses yang lebih baik. Bangun arsitektur yang saling terhubung. Tetap kendalikan semuanya.

Mulai sekarang juga tanpa kartu kredit dan tanpa perlu menunggu. Ubah cara kerja organisasi Anda menjadi rancangan proses yang jelas dan saling terhubung.

Bangun arsitektur proses, tetapkan penanggung jawab dan kontrol, lalu selaraskan peran serta tanggung jawab di setiap tingkat.

Mulai uji coba gratis dan bangun satu landasan tepercaya untuk mengatur, mengelola, dan terus memperbaiki proses Anda.

Mulai uji coba gratis hari ini