이 페이지에서

서식 함수

표시할 값의 서식을 지정하는 함수입니다. 주로 대시보드 표현식에서 사용할 수 있습니다.

info

formatDuration, formatPercentage, formatNumber 및 formatCurrency는 프런트엔드 표현식(대시보드, 디스플레이)에서만 사용할 수 있습니다. formatDate는 프런트엔드 표현식과 서버 측 계산 속성에서 모두 사용할 수 있습니다.

자주 사용하는 패턴

  • 날짜 표시:

    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
  • 기간 서식 지정:

    formatDuration(3600000)                     // "1 h"
    formatDuration(90000, "s")                  // "90 s"
    formatDuration(86400000, "d")               // "1 d"
  • 백분율 표시:

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

날짜 서식 패턴

date-fns 서식 패턴의 일부를 사용합니다. formatDate에서 지원하는 토큰은 다음과 같습니다.

  • 연도:

    yyyy   4-digit year      2024
  • 월:

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

    dd     Day (2 digits)    15
    d      Day               15
    EEEE   Day name (full)   Friday
    EEE    Day name (short)  Fri
  • 시간:

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

기간 단위

프런트엔드 표현식에서만 사용할 수 있습니다. 짧은 단위 표기를 사용합니다.

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

formatDate

(timestamp, format)

날짜 형식 패턴을 사용해 타임스탬프의 서식을 지정합니다.

매개변수
timestamp number 서식을 지정할 타임스탬프
format string 형식 패턴. 예: 'yyyy-MM-dd' 또는 'HH:mm'
반환값 문자열
예시
formatDate(StartTime, "yyyy-MM-dd") → 2024-03-18
formatDate(StartTime, "HH:mm") → 14:30
참고

프런트엔드와 Athena에서 동일하게 지원하는 토큰은 yyyy, MM, dd, HH, mm, ss입니다. 서식 지정에는 M, d, H, m, s와 MMM, MMMM, EEE, EEEE도 사용할 수 있습니다. 서식은 UTC 기준으로 적용됩니다.

formatDuration

(duration, unit?)

밀리초 단위의 기간을 읽기 쉬운 문자열로 표시합니다.

매개변수
duration number 밀리초 단위 기간
unit (선택 사항) string 표시 단위: 'ms', 's', 'm', 'h', 'd', 'mo', 'y'
반환값 문자열
예시
formatDuration(3600000) → 1 h
formatDuration(90000, "s") → 90 s
참고

프런트엔드 표현식에서만 사용할 수 있습니다. 짧은 단위 표기(s, m, h, d, mo, y)를 사용합니다.

formatPercentage

(value)

소수 값을 백분율로 표시합니다.

매개변수
value number 소수 값(0.5 = 50%)
반환값 문자열
예시
formatPercentage(0.75) → 75%
formatPercentage(1.5) → 150%
참고

프런트엔드 표현식에서만 사용할 수 있습니다.

formatNumber

(value, decimals?)

소수 자릿수를 지정해 숫자 서식을 지정합니다. 프런트엔드에서만 사용할 수 있습니다.

매개변수
value number 서식을 지정할 숫자
decimals (선택 사항) number 소수 자릿수
반환값 문자열
예시
formatNumber(1234.5, 2) → 1,234.50
참고

프런트엔드 표현식에서만 사용할 수 있습니다.

formatCurrency

(value, currency, decimals?)

숫자를 통화 형식으로 표시합니다. 프런트엔드에서만 사용할 수 있습니다.

매개변수
value number 서식을 지정할 숫자
currency string ISO 4217 통화 코드. 예: EUR 또는 USD
decimals (선택 사항) number 소수 자릿수
반환값 문자열
예시
formatCurrency(99.9, "EUR") → €99.90
참고

프런트엔드 표현식에서만 사용할 수 있습니다.

관련 주제

더 나은 프로세스를 설계하고, 연결된 아키텍처를 구축해 관리하세요.

신용카드 등록이나 대기 없이 바로 이용할 수 있습니다. 조직의 업무 방식을 명확하고 유기적으로 연결된 프로세스 설계로 바꿔 보세요.

프로세스 아키텍처를 구축하고, 소유권과 통제 기준을 정립하며, 모든 계층의 역할과 책임을 조율하세요.

무료 체험을 시작하고 프로세스를 관리·운영하고 지속적으로 개선할 수 있는 신뢰할 만한 기반을 마련하세요.