TimeFormatter

時刻データを任意の形式にフォーマットして表示するコンポーネントです。時刻をユーザーの言語や地域設定に適した形式で表示するときに使います。

使用上の注意

時刻をフォーマットする機能だけ必要な場合

TimeFormatterは時刻をtime要素としてレンダリングします。
フォーマットされた時刻の文字列だけが必要な場合は、useIntlformatTimeを使用してください。

使用例

表示する時刻のパーツをカスタマイズする

partsオプションを使って、表示する時刻のパーツを指定できます。デフォルトは['hour', 'minute'](時と分)です。

12時間形式で表示する

optionshour12trueに設定すると、12時間形式で表示できます(ロケールによって表示形式は異なります)。

Props

parts
readonly [TimePart, ...TimePart[]]

表示する時刻のパーツ。指定しない場合は ['hour', 'minute'] がデフォルト

options
DateTimeFormatOptions

フォーマットオプション

date必須
string Date