เนื้อหาในหน้านี้
> ทรัพยากร > เอกสาร > นิพจน์ > ฟังก์ชันจัดรูปแบบ

ฟังก์ชันจัดรูปแบบ

ฟังก์ชันสำหรับจัดรูปแบบค่าที่แสดง โดยส่วนใหญ่ใช้ได้ใน expressions ของแดชบอร์ด.

info

formatDuration, formatPercentage, formatNumber และ formatCurrency ใช้ได้เฉพาะใน expressions ฝั่ง frontend (แดชบอร์ดและส่วนแสดงผล) ส่วน formatDate ใช้ได้ทั้งใน expressions ฝั่ง frontend และแอตทริบิวต์ที่คำนวณฝั่งเซิร์ฟเวอร์

รูปแบบที่ใช้บ่อย

  • แสดงวันที่:

    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

หน่วยระยะเวลา

ใช้ได้เฉพาะใน expressions ฝั่ง frontend โดยใช้ตัวย่อหน่วย:

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
หมายเหตุ

โทเค็นที่รองรับใช้รูปแบบเดียวกันทั้ง frontend และ 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
หมายเหตุ

ใช้ได้เฉพาะในนิพจน์ frontend โดยใช้ตัวย่อหน่วย (s, m, h, d, mo, y).

formatPercentage

(value)

จัดรูปแบบค่าทศนิยมเป็นเปอร์เซ็นต์.

พารามิเตอร์
value number ค่าทศนิยม (0.5 = 50%)
ค่าที่ส่งกลับ สตริง
ตัวอย่าง
formatPercentage(0.75) → 75%
formatPercentage(1.5) → 150%
หมายเหตุ

ใช้ได้เฉพาะในนิพจน์ frontend.

formatNumber

(value, decimals?)

จัดรูปแบบตัวเลขโดยกำหนดจำนวนตำแหน่งทศนิยมได้ ใช้ได้เฉพาะใน frontend.

พารามิเตอร์
value number ตัวเลขที่ต้องการจัดรูปแบบ
decimals (ไม่บังคับ) number จำนวนตำแหน่งทศนิยม
ค่าที่ส่งกลับ สตริง
ตัวอย่าง
formatNumber(1234.5, 2) → 1,234.50
หมายเหตุ

ใช้ได้เฉพาะในนิพจน์ frontend.

formatCurrency

(value, currency, decimals?)

จัดรูปแบบตัวเลขเป็นสกุลเงิน ใช้ได้เฉพาะใน frontend.

พารามิเตอร์
value number ตัวเลขที่ต้องการจัดรูปแบบ
currency string รหัสสกุลเงิน ISO 4217 เช่น EUR หรือ USD
decimals (ไม่บังคับ) number จำนวนตำแหน่งทศนิยม
ค่าที่ส่งกลับ สตริง
ตัวอย่าง
formatCurrency(99.9, "EUR") → €99.90
หมายเหตุ

ใช้ได้เฉพาะในนิพจน์ frontend.

หัวข้อที่เกี่ยวข้อง

ออกแบบกระบวนการให้ดีขึ้น วางโครงสร้างที่เชื่อมโยงกัน และควบคุมได้.

เริ่มใช้งานได้ทันที ไม่ต้องใช้บัตรเครดิตและไม่ต้องรอ เปลี่ยนวิธีทำงานขององค์กรให้เป็นแบบจำลองกระบวนการที่ชัดเจนและเชื่อมโยงกัน.

สร้างสถาปัตยกรรมกระบวนการ กำหนดเจ้าของและการควบคุม พร้อมจัดบทบาทและความรับผิดชอบให้สอดคล้องกันในทุกระดับ.

เริ่มทดลองใช้ฟรี แล้วสร้างรากฐานที่เชื่อถือได้สำหรับกำกับดูแล จัดการ และปรับปรุงกระบวนการอย่างต่อเนื่อง.

เริ่มทดลองใช้ฟรีวันนี้