
商品頁同時列出美元和日圓時,只在金額前加一個符號,很容易讓訪客看錯幣別。少了地區格式也會讓價格難讀,例如英文和德文對小數點、千位分隔符的用法不同。用 Intl.NumberFormat 可以從商品資料裡的金額和幣別直接產生顯示文字。
把語系與商品幣別分開
locale 決定價格怎麼寫,currency 決定價格是哪一種貨幣。下面兩筆美元用的是同一個值,只換語系。設定 currencyDisplay: 'code' 會直接顯示 USD 或 JPY,適合一頁會出現多種貨幣的商品列表。
function displayPrice(amount, locale, currency) {
if (!Number.isFinite(amount)) return '—';
return new Intl.NumberFormat(locale, {
style: 'currency',
currency,
currencyDisplay: 'code',
}).format(amount);
}
console.log(displayPrice(1234.5, 'en-US', 'USD'));
console.log(displayPrice(1234.5, 'de-DE', 'USD'));
console.log(displayPrice(1234, 'ja-JP', 'JPY'));
console.log(displayPrice(0, 'en-US', 'USD'));
console.log(displayPrice(null, 'en-US', 'USD'));
在 Node.js 執行,上面依序顯示 USD 1,234.50、1.234,50 USD、JPY 1,234、USD 0.00 和 —。不同瀏覽器或語系資料版本,空格和符號的位置可能略有不同。一般貨幣格式的小數位預設隨幣別而變,這裡美元有兩位,日圓沒有小數位。
先確認 API 的金額單位
範例傳入的是主要貨幣單位,例如 1234.5 代表 1,234.50 美元。如果後端存的是美分,123450 要依 API 約定轉成 1234.5 後交給格式化函式。日圓以整元儲存時就直接傳入。不要把所有幣別的數字都除以 100。
範例只接受有效的數字,因此 0 仍顯示為零,null、NaN 與數字字串會顯示破折號。若 API 傳字串,先依欄位約定驗證和轉換,避免空字串意外變成零。幣別請從商品資料取有效的貨幣代碼,別用瀏覽器語系推測。格式化也不會換匯,結帳金額、四捨五入和幣別仍按後端提供的資料處理。
封面為 AI 生成的價格標籤概念插畫。
