Na tej stronie
> zasoby > dokumentacja > wyrazenia > Funkcje formatowania

Funkcje formatowania

Funkcje formatujące wartości do wyświetlenia. Są dostępne głównie w wyrażeniach dashboardów.

info

formatDuration, formatPercentage, formatNumber i formatCurrency są dostępne tylko w wyrażeniach frontendowych (dashboardach i widokach). formatDate jest dostępna zarówno w wyrażeniach frontendowych, jak i atrybutach obliczanych po stronie serwera.

Typowe zastosowania

  • Wyświetlanie 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

  • Formatowanie czasu trwania:

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

  • Wyświetlanie wartości procentowych:

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

Wzorce formatowania dat

Obsługiwany jest podzbiór wzorców formatowania date-fns. Tokeny obsługiwane przez formatDate:

  • Rok:

    yyyy   4-digit year      2024

  • Miesiąc:

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

  • Dzień:

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

  • Godzina:

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

Jednostki czasu trwania

Dostępne tylko w wyrażeniach frontendowych. Używają krótkich oznaczeń jednostek:

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

formatDate

(timestamp, format)

Formatuje znacznik czasu zgodnie z podanym wzorcem daty.

Parametry
timestamp number Znacznik czasu do sformatowania
format string Wzorzec formatu, na przykład 'yyyy-MM-dd' lub 'HH:mm'
Zwracana wartość ciąg znaków
Przykłady
formatDate(StartTime, "yyyy-MM-dd") → 2024-03-18
formatDate(StartTime, "HH:mm") → 14:30
Uwagi

Obsługiwane tokeny są jednakowe w interfejsie i Athena: yyyy, MM, dd, HH, mm, ss. Formatowanie obsługuje też M, d, H, m, s oraz MMM, MMMM, EEE i EEEE. Formatowanie korzysta z czasu UTC.

formatDuration

(duration, unit?)

Formatuje czas trwania podany w milisekundach jako czytelny tekst.

Parametry
duration number Czas trwania w milisekundach
unit (opcjonalny) string Jednostka wyświetlania: 'ms', 's', 'm', 'h', 'd', 'mo', 'y'
Zwracana wartość ciąg znaków
Przykłady
formatDuration(3600000) → 1 h
formatDuration(90000, "s") → 90 s
Uwagi

Dostępne tylko w wyrażeniach interfejsu. Używa krótkich oznaczeń jednostek (s, m, h, d, mo, y).

formatPercentage

(value)

Formatuje wartość dziesiętną jako procent.

Parametry
value number Wartość dziesiętna (0.5 = 50%)
Zwracana wartość ciąg znaków
Przykłady
formatPercentage(0.75) → 75%
formatPercentage(1.5) → 150%
Uwagi

Dostępne tylko w wyrażeniach interfejsu.

formatNumber

(value, decimals?)

Formatuje liczbę z opcjonalną liczbą miejsc po przecinku. Dostępne tylko w interfejsie.

Parametry
value number Liczba do sformatowania
decimals (opcjonalny) number Liczba miejsc po przecinku
Zwracana wartość ciąg znaków
Przykłady
formatNumber(1234.5, 2) → 1,234.50
Uwagi

Dostępne tylko w wyrażeniach interfejsu.

formatCurrency

(value, currency, decimals?)

Formatuje liczbę jako kwotę w walucie. Dostępne tylko w interfejsie.

Parametry
value number Liczba do sformatowania
currency string Kod waluty ISO 4217, na przykład EUR lub USD
decimals (opcjonalny) number Liczba miejsc po przecinku
Zwracana wartość ciąg znaków
Przykłady
formatCurrency(99.9, "EUR") → €99.90
Uwagi

Dostępne tylko w wyrażeniach interfejsu.

Powiązane tematy

Projektuj lepsze procesy. Buduj spójną architekturę. Zachowaj kontrolę.

Uzyskaj dostęp od razu, bez karty kredytowej i czekania. Przedstaw sposób działania organizacji w postaci przejrzystych, powiązanych modeli procesów.

Buduj architekturę procesów, określaj właścicieli i mechanizmy kontroli oraz uzgadniaj role i zakresy odpowiedzialności na każdym poziomie.

Rozpocznij okres próbny i stwórz solidną podstawę do nadzorowania, zarządzania i ciągłego doskonalenia procesów.

Rozpocznij okres próbny