【JavaScript ECMAScript】Intl::Intl.Locale.prototype.hourCycleインスタンスアクセサプロパティの使い方

Intl.Locale.prototype.hourCycleプロパティは、Intl.Localeオブジェクトが表すロケールにおける、デフォルトの時刻サイクル形式を保持するプロパティです。このプロパティを使用すると、特定の地域や言語設定において、時刻が12時間制と24時間制のどちらで表現されるか、または午前・午後の区別があるかといった情報をプログラムで取得できます。

このプロパティが返す値は文字列であり、国際標準で定義された時刻サイクル識別子の一つです。例えば、"h11"は0時から11時までの数字で午前中の時間を表す12時間制（午前0時が0時）、"h12"は1時から12時までの数字で午前中の時間を表す12時間制（午前12時が12時）、"h23"は0時から23時までの数字で時間を表す24時間制（0時が0時）、"h24"は1時から24時までの数字で時間を表す24時間制（24時が24時）といった形式があります。

システムエンジニアを目指す初心者の方にとって、このプロパティは国際化（i18n）対応を行う際に非常に重要です。ユーザーのロケール設定に基づいて時刻表示を適切に調整する必要がある場合、このプロパティが提供する情報を用いて、時間フォーマットを動的に変更できます。これにより、世界中のユーザーにとって自然で理解しやすい時刻表示を実現するための基盤となります。例えば、日本のように一般的に24時間制を使用する地域と、アメリカのように12時間制と午前/午後を使用する地域で、適切な表示を自動的に切り替える際に役立ちます。

Copy
1const locale = new Intl.Locale('en-US-u-hc-h12');
2const hourCyclePreference = locale.hourCycle;

引数なし

引数はありません

string

このプロパティは、ロケールで標準として使用される時間表示の様式を示す文字列を返します。例えば、「h12」や「h23」といった値になります。