Intl.Locale.prototype.hourCycle

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

Intl.Locale 인스턴스의 hourCycle 접근자 속성은 이 로케일을 위한 시간 주기를 반환합니다.

설명

전 세계에서 사용되는 시간 표시 규칙(시계)에는 12시간 시계와 24시간 시계의 두 가지 주요 유형이 있습니다. hourCycle 속성 값은 로케일 식별자의 hc 키 또는 Intl.Locale() 생성자의 hourCycle 옵션을 통해 구성 시간에 설정됩니다. 모두 존재하면 후자가 우선권을 가지며, 둘 다 존재하지 않으면 속성의 값은 undefined입니다.

지원되는 시간 주기 유형 목록은 Intl.Locale.prototype.getHourCycles()을 참고하시기 바랍니다.

hourCycle의 설정 접근자는 undefined입니다. 이 속성은 직접 변경할 수 없습니다.

예제

다른 로케일 하위 태그와 마찬가지로 시간 주기 유형은 로케일 문자열 또는 생성자에 대한 구성 객체 인수를 통해 Intl.Locale 객체에 추가할 수 있습니다.

로케일 문자열을 통한 시간 주기 추가하기

유니코드 로케일 문자열 사양에서 시간 주기 유형은 로케일 키 "확장 하위 태그"입니다. 이러한 하위 태그는 로케일에 대한 추가 데이터를 더하며, -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"

명세서

Specification
ECMAScript® 2025 Internationalization API Specification
# sec-Intl.Locale.prototype.hourCycle

브라우저 호환성

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
hourCycle

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

같이 보기