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 Internationalization API Specification
# sec-Intl.Locale.prototype.hourCycle

브라우저 호환성

BCD tables only load in the browser

같이 보기