Na této stránce
> zdroje > dokumentace > vyrazy > Formátovací funkce

Formátovací funkce

Funkce pro formátování zobrazovaných hodnot. Používají se především ve výrazech dashboardů.

info

formatDuration, formatPercentage, formatNumber a formatCurrency jsou dostupné pouze ve výrazech frontendu (dashboardy, zobrazení). formatDate je dostupná ve výrazech frontendu i ve vypočítaných atributech na straně serveru.

Běžné postupy

  • Zobrazení dat:

    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

  • Formátování trvání:

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

  • Zobrazení procent:

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

Formáty data

Používá podmnožinu formátovacích vzorů date-fns. Funkce formatDate podporuje tyto tokeny:

  • Rok:

    yyyy   4-digit year      2024

  • Měsíc:

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

  • Den:

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

  • Čas:

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

Jednotky trvání

Dostupné pouze ve výrazech frontendu. Používají se zkrácené názvy jednotek:

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

formatDate

(timestamp, format)

Formátuje časové razítko podle zadaného vzoru data.

Parametry
timestamp number Časové razítko k formátování
format string Vzor formátu, například 'yyyy-MM-dd' nebo 'HH:mm'
Návratová hodnota řetězec
Příklady
formatDate(StartTime, "yyyy-MM-dd") → 2024-03-18
formatDate(StartTime, "HH:mm") → 14:30
Poznámky

Podporované tokeny jsou pro frontend a Athena jednotné: yyyy, MM, dd, HH, mm, ss. Při formátování jsou podporovány také M, d, H, m, s a MMM, MMMM, EEE, EEEE. Formátování používá čas UTC.

formatDuration

(duration, unit?)

Formátuje dobu trvání v milisekundách jako čitelný řetězec.

Parametry
duration number Doba trvání v milisekundách
unit (nepovinné) string Zobrazovaná jednotka: 'ms', 's', 'm', 'h', 'd', 'mo', 'y'
Návratová hodnota řetězec
Příklady
formatDuration(3600000) → 1 h
formatDuration(90000, "s") → 90 s
Poznámky

Dostupné pouze ve výrazech frontendu. Používá zkrácené názvy jednotek (s, m, h, d, mo, y).

formatPercentage

(value)

Formátuje desetinnou hodnotu jako procento.

Parametry
value number Desetinná hodnota (0.5 = 50 %)
Návratová hodnota řetězec
Příklady
formatPercentage(0.75) → 75%
formatPercentage(1.5) → 150%
Poznámky

Dostupné pouze ve výrazech frontendu.

formatNumber

(value, decimals?)

Formátuje číslo s volitelným počtem desetinných míst. Pouze frontend.

Parametry
value number Číslo k formátování
decimals (nepovinné) number Počet desetinných míst
Návratová hodnota řetězec
Příklady
formatNumber(1234.5, 2) → 1,234.50
Poznámky

Dostupné pouze ve výrazech frontendu.

formatCurrency

(value, currency, decimals?)

Formátuje číslo jako měnu. Pouze frontend.

Parametry
value number Číslo k formátování
currency string Kód měny ISO 4217, například EUR nebo USD
decimals (nepovinné) number Počet desetinných míst
Návratová hodnota řetězec
Příklady
formatCurrency(99.9, "EUR") → €99.90
Poznámky

Dostupné pouze ve výrazech frontendu.

Související témata

Navrhujte lepší procesy. Propojte je do společné architektury. Mějte vše pod kontrolou.

Získejte přístup ihned, bez čekání a bez platební karty. Převádějte způsob práce ve své organizaci do přehledných a propojených návrhů procesů.

Vytvořte architekturu procesů, určete vlastníky a kontrolní mechanismy a slaďte role a odpovědnosti na všech úrovních.

Spusťte zkušební verzi a vytvořte spolehlivý základ pro řízení, správu a průběžné zlepšování procesů.

Získejte zkušební verzi zdarma