Bu sayfada
> kaynaklar > belgeler > ifadeler > Biçimlendirme işlevleri

Biçimlendirme işlevleri

Değerleri görüntülemek üzere biçimlendirmeye yönelik işlevler. Bu işlevler öncelikle Dashboard ifadelerinde kullanılabilir.

info

Biçimlendirme işlevleri ön yüz ifadelerinde (Dashboardlar, görüntüler) kullanılabilir, ancak sunucu tarafındaki hesaplanmış özniteliklerde kullanılamaz.

Yaygın örüntüler

  • Tarihleri görüntüleyin:

    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

  • Süreyi biçimlendirin:

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

  • Yüzdeleri görüntüleyin:

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

Tarih biçimi örüntüleri

date-fns biçim örüntülerini kullanır. formatDate için yaygın biçim belirteçleri:

  • Yıl:

    yyyy   4-digit year      2024
yy     2-digit year      24

  • Ay:

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

  • Gün:

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

  • Saat:

    HH     Hour (24h)        14
hh     Hour (12h)        02
mm     Minutes           30
ss     Seconds           45
a      AM/PM             PM

Süre birimleri

Yalnızca ön yüz ifadelerinde kullanılabilir. Kısa birim etiketlerini kullanır:

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

formatDate

(timestamp, format)

Bir zaman damgasını tarih biçimi kalıbını kullanarak biçimlendirir.

Parametreler
timestamp number Biçimlendirilecek zaman damgası
format string Biçim kalıbı, örneğin 'yyyy-MM-dd' veya 'HH:mm'
Döndürür string
Örnekler
formatDate(StartTime, "yyyy-MM-dd") → 2024-03-18
formatDate(StartTime, "HH:mm") → 14:30
Notlar

Desteklenen belirteçler frontend ve Athena için tutarlı biçimde türetilir: yyyy, MM, dd, HH, mm, ss. Biçimlendirmede M, d, H, m, s ile MMM, MMMM, EEE ve EEEE de desteklenir. Biçimlendirme UTC kurallarını kullanır.

formatDuration

(duration, unit?)

Milisaniye cinsinden süreyi, insanların kolayca okuyabileceği bir metin olarak biçimlendirir.

Parametreler
duration number Milisaniye cinsinden süre
unit (isteğe bağlı) string Görüntüleme birimi: 'ms', 's', 'm', 'h', 'd', 'mo', 'y'
Döndürür string
Örnekler
formatDuration(3600000) → 1 h
formatDuration(90000, "s") → 90 s
Notlar

Yalnızca frontend ifadelerinde kullanılabilir. Kısa birim etiketlerini kullanır: s, m, h, d, mo, y.

formatPercentage

(value)

Ondalık bir değeri yüzde olarak biçimlendirir.

Parametreler
value number Ondalık değer (0.5 = %50)
Döndürür string
Örnekler
formatPercentage(0.75) → 75%
formatPercentage(1.5) → 150%
Notlar

Yalnızca frontend ifadelerinde kullanılabilir.

formatNumber

(value, decimals?)

Bir sayıyı isteğe bağlı ondalık basamak sayısıyla biçimlendirir. Yalnızca frontend’de kullanılabilir.

Parametreler
value number Biçimlendirilecek sayı
decimals (isteğe bağlı) number Ondalık basamak sayısı
Döndürür string
Örnekler
formatNumber(1234.5, 2) → 1,234.50
Notlar

Yalnızca frontend ifadelerinde kullanılabilir.

formatCurrency

(value, currency, decimals?)

Bir sayıyı para birimi olarak biçimlendirir. Yalnızca frontend’de kullanılabilir.

Parametreler
value number Biçimlendirilecek sayı
currency string ISO 4217 para birimi kodu, örneğin EUR veya USD
decimals (isteğe bağlı) number Ondalık basamak sayısı
Döndürür string
Örnekler
formatCurrency(99.9, "EUR") → €99.90
Notlar

Yalnızca frontend ifadelerinde kullanılabilir.

İlgili konular