Intl.Locale.prototype.hourCycle

Baseline 已廣泛支援

此功能已成熟,並可在許多裝置和瀏覽器版本上使用。自 2020 年 9 月起,所有瀏覽器均已提供此功能。

hourCycle 訪問器屬性,屬於 Intl.Locale 例項,用於返回此區域設定的小時制型別。

描述

全球主要有兩種計時約定(時鐘):12小時制和24小時制。支援的小時制型別列表,請參閱 Intl.Locale.prototype.getHourCycles()

hourCycle 屬性的值在構造時設定,可以透過區域設定識別符號的 hc 鍵,或者透過 Intl.Locale() 建構函式的 hourCycle 選項來設定。如果兩者都存在,後者優先順序更高;如果兩者都不存在,該屬性的值為 undefined

hourCycle 的設定器為 undefined。您不能直接更改此屬性。

示例

與其他區域設定子標籤一樣,小時制型別可以透過區域設定字串,或透過建構函式的配置物件引數新增到 Intl.Locale 物件中。

透過區域設定字串新增小時制

Unicode 區域設定字串規範中,hourCycle 是一個“擴充套件子標籤”。這些子標籤提供了關於區域設定的附加資料,並使用 -u 擴充套件鍵新增到區域設定識別符號中。要將小時制型別新增到傳遞給 Intl.Locale() 建構函式的初始區域設定識別符號字串,請先新增 -u 擴充套件鍵(如果不存在)。接下來,新增 -hc 擴充套件以指示您正在新增小時制。最後,新增小時制型別。

js
const locale = new Intl.Locale("fr-FR-u-hc-h23");
console.log(locale.hourCycle); // "h23"

透過配置物件引數新增小時制

Intl.Locale() 建構函式有一個可選的配置物件引數,其中可以包含多種擴充套件型別,包括小時制型別。將配置物件的 hourCycle 屬性設定為您想要的小時制型別,然後將其傳遞給建構函式。

js
const locale = new Intl.Locale("en-US", { hourCycle: "h12" });
console.log(locale.hourCycle); // "h12"

規範

規範
ECMAScript® 2026 國際化 API 規範
# sec-Intl.Locale.prototype.hourCycle

瀏覽器相容性

另見