Di halaman ini
> sumber daya > dokumentasi > ekspresi > Fungsi pemformatan

Fungsi pemformatan

Fungsi untuk memformat nilai yang akan ditampilkan. Fungsi ini terutama tersedia dalam ekspresi dashboard.

info

formatDuration, formatPercentage, formatNumber, dan formatCurrency hanya tersedia dalam ekspresi frontend (dashboard, tampilan). formatDate tersedia dalam ekspresi frontend dan atribut hasil perhitungan sisi server.

Pola umum

  • Menampilkan tanggal:

    formatDate(StartTime, "yyyy-MM-dd")         // 2024-03-15
formatDate(StartTime, "MMM d, yyyy")        // Mar 15, 2024
formatDate(StartTime, "HH:mm:ss")           // 14:30:45
formatDate(StartTime, "EEEE, MMMM d")       // Friday, March 15

  • Memformat durasi:

    formatDuration(3600000)                     // "1 h"
formatDuration(90000, "s")                  // "90 s"
formatDuration(86400000, "d")               // "1 d"

  • Menampilkan persentase:

    formatPercentage(0.75)                      // "75%"
formatPercentage(0.333)                     // "33.3%"

Pola format tanggal

Menggunakan sebagian pola format dari date-fns. Token formatDate yang didukung:

  • Tahun:

    yyyy   4-digit year      2024

  • Bulan:

    MM     Month (2 digits)  03
MMM    Month (short)     Mar
MMMM   Month (full)      March

  • Hari:

    dd     Day (2 digits)    15
d      Day               15
EEEE   Day name (full)   Friday
EEE    Day name (short)  Fri

  • Waktu:

    HH     Hour (24h)        14
mm     Minutes           30
ss     Seconds           45

Satuan durasi

Hanya tersedia dalam ekspresi frontend. Menggunakan label satuan singkat:

ms     Milliseconds
s      Seconds
m      Minutes
h      Hours
d      Days
mo     Months
y      Years

formatDate

(timestamp, format)

Memformat timestamp menggunakan pola tanggal.

Parameter
timestamp number Timestamp yang akan diformat
format string Pola format, misalnya 'yyyy-MM-dd' atau 'HH:mm'
Nilai yang dikembalikan string
Contoh
formatDate(StartTime, "yyyy-MM-dd") → 2024-03-18
formatDate(StartTime, "HH:mm") → 14:30
Catatan

Token yang didukung konsisten untuk frontend dan Athena: yyyy, MM, dd, HH, mm, ss. Token M, d, H, m, s serta MMM, MMMM, EEE, EEEE juga didukung untuk pemformatan. Pemformatan menggunakan waktu UTC.

formatDuration

(duration, unit?)

Memformat durasi dalam milidetik menjadi string yang mudah dibaca.

Parameter
duration number Durasi dalam milidetik
unit (opsional) string Satuan tampilan: 'ms', 's', 'm', 'h', 'd', 'mo', 'y'
Nilai yang dikembalikan string
Contoh
formatDuration(3600000) → 1 h
formatDuration(90000, "s") → 90 s
Catatan

Hanya tersedia dalam ekspresi frontend. Menggunakan label satuan singkat (s, m, h, d, mo, y).

formatPercentage

(value)

Memformat nilai desimal sebagai persentase.

Parameter
value number Nilai desimal (0.5 = 50%)
Nilai yang dikembalikan string
Contoh
formatPercentage(0.75) → 75%
formatPercentage(1.5) → 150%
Catatan

Hanya tersedia dalam ekspresi frontend.

formatNumber

(value, decimals?)

Memformat angka dengan jumlah angka desimal opsional. Hanya tersedia di frontend.

Parameter
value number Angka yang akan diformat
decimals (opsional) number Jumlah angka desimal
Nilai yang dikembalikan string
Contoh
formatNumber(1234.5, 2) → 1,234.50
Catatan

Hanya tersedia dalam ekspresi frontend.

formatCurrency

(value, currency, decimals?)

Memformat angka sebagai mata uang. Hanya tersedia di frontend.

Parameter
value number Angka yang akan diformat
currency string Kode mata uang ISO 4217, misalnya EUR atau USD
decimals (opsional) number Jumlah angka desimal
Nilai yang dikembalikan string
Contoh
formatCurrency(99.9, "EUR") → €99.90
Catatan

Hanya tersedia dalam ekspresi frontend.

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