Trong trang này

Hàm định dạng

Các hàm định dạng giá trị để hiển thị. Những hàm này chủ yếu dùng được trong biểu thức dashboard.

info

formatDuration, formatPercentage, formatNumber và formatCurrency chỉ dùng được trong biểu thức frontend (dashboard, màn hình hiển thị). formatDate dùng được trong cả biểu thức frontend lẫn thuộc tính tính toán phía máy chủ.

Các mẫu thường dùng

  • Hiển thị ngày:

    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
  • Định dạng thời lượng:

    formatDuration(3600000)                     // "1 h"
    formatDuration(90000, "s")                  // "90 s"
    formatDuration(86400000, "d")               // "1 d"
  • Hiển thị tỷ lệ phần trăm:

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

Mẫu định dạng ngày

Dùng một phần các mẫu định dạng date-fns. Các token được hỗ trợ trong formatDate:

  • Năm:

    yyyy   4-digit year      2024
  • Tháng:

    MM     Month (2 digits)  03
    MMM    Month (short)     Mar
    MMMM   Month (full)      March
  • Ngày:

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

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

Đơn vị thời lượng

Chỉ dùng được trong biểu thức frontend. Dùng nhãn đơn vị viết tắt:

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

formatDate

(timestamp, format)

Định dạng dấu thời gian theo mẫu ngày tháng.

Tham số
timestamp number Dấu thời gian cần định dạng
format string Mẫu định dạng, ví dụ 'yyyy-MM-dd' hoặc 'HH:mm'
Giá trị trả về string
Ví dụ
formatDate(StartTime, "yyyy-MM-dd") → 2024-03-18
formatDate(StartTime, "HH:mm") → 14:30
Ghi chú

Các mã định dạng được hỗ trợ nhất quán trên frontend và Athena: yyyy, MM, dd, HH, mm, ss. Ngoài ra, M, d, H, m, s và MMM, MMMM, EEE, EEEE cũng được hỗ trợ khi định dạng. Việc định dạng sử dụng múi giờ UTC.

formatDuration

(duration, unit?)

Định dạng khoảng thời gian tính bằng mili giây thành chuỗi dễ đọc.

Tham số
duration number Thời lượng tính bằng mili giây
unit (không bắt buộc) string Đơn vị hiển thị: 'ms', 's', 'm', 'h', 'd', 'mo', 'y'
Giá trị trả về string
Ví dụ
formatDuration(3600000) → 1 h
formatDuration(90000, "s") → 90 s
Ghi chú

Chỉ dùng được trong biểu thức frontend. Sử dụng nhãn đơn vị rút gọn (s, m, h, d, mo, y).

formatPercentage

(value)

Định dạng số thập phân thành phần trăm.

Tham số
value number Giá trị thập phân (0.5 = 50%)
Giá trị trả về string
Ví dụ
formatPercentage(0.75) → 75%
formatPercentage(1.5) → 150%
Ghi chú

Chỉ dùng được trong biểu thức frontend.

formatNumber

(value, decimals?)

Định dạng số với số chữ số thập phân tùy chọn. Chỉ dùng được trên frontend.

Tham số
value number Số cần định dạng
decimals (không bắt buộc) number Số chữ số thập phân
Giá trị trả về string
Ví dụ
formatNumber(1234.5, 2) → 1,234.50
Ghi chú

Chỉ dùng được trong biểu thức frontend.

formatCurrency

(value, currency, decimals?)

Định dạng số thành tiền tệ. Chỉ dùng được trên frontend.

Tham số
value number Số cần định dạng
currency string Mã tiền tệ ISO 4217, ví dụ EUR hoặc USD
decimals (không bắt buộc) number Số chữ số thập phân
Giá trị trả về string
Ví dụ
formatCurrency(99.9, "EUR") → €99.90
Ghi chú

Chỉ dùng được trong biểu thức frontend.

Chủ đề liên quan

Thiết kế quy trình tốt hơn. Kết nối các quy trình. Luôn chủ động kiểm soát.

Truy cập ngay, không cần thẻ tín dụng hay chờ đợi. Biến cách tổ chức của bạn vận hành thành các thiết kế quy trình rõ ràng, liên kết với nhau.

Xây dựng kiến trúc quy trình, xác định quyền sở hữu và cơ chế kiểm soát, đồng thời thống nhất vai trò và trách nhiệm ở mọi cấp.

Bắt đầu dùng thử miễn phí để tạo nền tảng đáng tin cậy cho việc quản trị, quản lý và cải tiến quy trình liên tục.