Reactで秒数を「1時間23分45秒」と表示する方法
Intl.DurationFormat を使うと、{ hours: 1, minutes: 23, seconds: 45 } のような時・分・秒の数から、1 時間 23 分 45 秒 や 1:23:45 の文字列を作れます。0 の単位を省く処理や、英語の hours と hour の出し分けを自分で書かずに済みます。
ただし、秒数をそのまま渡しても「1時間23分45秒」にはなりません。秒数を時・分・秒に分ける処理と、日本語で数と単位のあいだに入る空白を取る処理は、自分で書きます。この記事では、それらをまとめた React のコンポーネントを作り、0 秒や対応していない環境での表示も確かめました。
検証環境は Ubuntu 24.04、Node.js 22.23.4 と 24.22.1(どちらも ICU 78.3)、Chromium 153 です。使ったのは react / react-dom 19.3.1、@types/react 19.3.0、typescript 7.0.2、esbuild 0.28.2、Playwright 1.63.0 です。.tsx を tsc で型チェックしてから esbuild で変換し、開発用ビルドで動かしました。ブラウザは Playwright で言語を日本語に設定して開いています。Firefox と Safari、本番用ビルド、サーバーで作った HTML のハイドレーション、ミリ秒より細かい単位の表示は試していません。
秒数は時・分・秒に分けてから渡す
format() には、hours や minutes などを持つオブジェクトを渡します。DurationFormat は、60 秒を 1 分に繰り上げるような計算をしません。Node.js 24 で { seconds: 5025 } を渡すと、5,025 秒 が返りました。
そこで、秒数を時・分・秒に分ける関数を用意します。
export type Hms = { hours: number; minutes: number; seconds: number };
// 秒数を時・分・秒に分ける。DurationFormat は 60 秒を 1 分に繰り上げない
export function splitSeconds(total: number): Hms {
const t = Math.max(0, Math.floor(total));
return {
hours: Math.floor(t / 3600),
minutes: Math.floor((t % 3600) / 60),
seconds: t % 60,
};
}
splitSeconds(5025) は { hours: 1, minutes: 23, seconds: 45 } になり、これを渡すと 1 時間 23 分 45 秒 が返りました。
小数を切り捨てているのは、format() に渡す値を整数にする必要があるためです。値の符号もそろえる必要があります(MDN の format() の説明)。検証環境でも、{ seconds: 1.5 } と、符号が混ざった { hours: 1, minutes: -23 } は RangeError になりました。負の数を 0 にしているのは、この記事では経過時間だけを扱うためです。
この関数は日に繰り上げないので、90,061 秒は 25時間1分1秒 になります。日の単位まで出したいときは、days も計算して渡します。
表示の種類は style で選ぶ
style には long・short・narrow・digital を指定でき、指定しないときは short になります(MDN の Intl.DurationFormat() コンストラクターの説明)。{ hours: 1, minutes: 23, seconds: 45 } を渡した結果です。
| style | ja-JP |
en-US |
|---|---|---|
long |
1 時間 23 分 45 秒 |
1 hour, 23 minutes, 45 seconds |
short |
1 時間 23 分 45 秒 |
1 hr, 23 min, 45 sec |
narrow |
1h23m45s |
1h 23m 45s |
digital |
1:23:45 |
1:23:45 |
日本語の long と short は同じ表示でした。数と単位のあいだ、単位と次の数のあいだに空白が入ります。日本語の4つの結果は、Node.js 24 と Chromium 153 で同じでした。
日本語の空白は formatToParts で取り除く
formatToParts() を使うと、結果を数・単位・区切りの部品に分けて受け取れます(MDN の formatToParts() の説明)。日本語の long では、次の部品が返りました。
1(integer) " "(literal) 時間(unit) " "(literal) 23(integer) " "(literal) 分(unit) …
空白は type が literal の部品です。検証環境では、どれも普通の半角スペース(U+0020)でした。この部品だけを除いてつなげると、「1時間23分45秒」の形になります。
// 数と単位のあいだの空白を取り除き、「1時間23分45秒」の形にする
export function formatCompact(df: Intl.DurationFormat, d: Hms): string {
return df
.formatToParts(d)
.filter((p) => !(p.type === 'literal' && p.value.trim() === ''))
.map((p) => p.value)
.join('');
}
空白の文字を決め打ちで置き換えずに部品の種類で選ぶのは、MDN の format() の説明に、出力が実装によって変わることや、ノーブレークスペースが使われることもあると書かれているためです。
英語の 1 hour のように、数と単位のあいだに空白が要る言語もあります。この処理は日本語のときだけ使います。
React のコンポーネントにする
DurationFormat は、言語と style が同じなら使い回せます。useMemo で、それらが変わったときだけ作り直します(公式リファレンスの useMemo の説明)。DurationFormat がない環境では null を返し、後で説明する代わりの表示に切り替えます。
import { useMemo } from 'react';
type Style = Intl.DurationFormatOptions['style'];
// 言語・表示の種類・0 秒かどうかが変わったときだけ作り直す。
// DurationFormat がない環境では null を返す
export function useDurationFormat(
locale: string,
style: Style,
zero: boolean,
): Intl.DurationFormat | null {
return useMemo(() => {
if (typeof Intl.DurationFormat === 'undefined') return null;
// 0 秒のときだけ secondsDisplay: 'always' にする。
// それ以外は指定しない('auto' を渡すと digital で 0 秒の欄が消える)
return new Intl.DurationFormat(locale, {
style,
secondsDisplay: zero ? 'always' : undefined,
});
}, [locale, style, zero]);
}
zero と secondsDisplay の扱いは、次の2つの節で説明します。コンポーネントは、秒数・言語・表示の種類を props で受け取ります。
import { formatCompact, formatFallback, splitSeconds } from './formatDuration';
import { useDurationFormat } from './useDurationFormat';
type Props = {
seconds: number;
locale: string;
style?: Intl.DurationFormatOptions['style'];
compact?: boolean; // 日本語で数と単位をくっつけるとき true
};
export function Duration({ seconds, locale, style = 'long', compact = false }: Props) {
const parts = splitSeconds(seconds);
// 0 秒のときは「0 秒」を出す(そのままだと空文字になる)
const df = useDurationFormat(locale, style, seconds < 1);
let text: string;
if (df === null) text = formatFallback(parts);
else if (compact) text = formatCompact(df, parts);
else text = df.format(parts);
return <span className="duration">{text}</span>;
}
使う側では、<Duration seconds={5025} locale="ja-JP" compact /> のように書きます。
検証では、同じ秒数を4通りに表示し、秒数を増やすボタンを置いた画面を作りました。

Chromium での最初の表示と、ボタンを押したあとの表示は、次のとおりでした。
| 秒数 | 日本語(空白なし) | 英語(long) | digital |
|---|---|---|---|
| 5,025 | 1時間23分45秒 |
1 hour, 23 minutes, 45 seconds |
1:23:45 |
| 5,026 | 1時間23分46秒 |
1 hour, 23 minutes, 46 seconds |
1:23:46 |
| 5,040 | 1時間24分 |
1 hour, 24 minutes |
1:24:00 |
| 0 | 0秒 |
0 seconds |
0:00:00 |
| 3,600 | 1時間 |
1 hour |
1:00:00 |
| 3,601 | 1時間1秒 |
1 hour, 1 second |
1:00:01 |
long では、0 の単位は表示されません。5,040 秒は 1時間24分、3,601 秒は 1時間1秒 になりました。英語では 1 second と 46 seconds のように、単数形と複数形も選ばれています。
DurationFormat を作った回数を数える処理を足して確かめると、4つのコンポーネントの最初の表示で4回でした。再描画を3回しても、秒数を変えても、4回のままでした。0 秒にしたときと、0 秒から +1時間のボタンで 3,600 秒にしたときに、zero が変わるのでそれぞれ4回ずつ作り直されました。
0 秒は何も表示されない
long などの表示では、0 の単位を省きます。そのため、時・分・秒がすべて 0 だと、format() は空文字を返しました。Node.js 24 でも Chromium でも同じです。
0 秒を表示したいときは、secondsDisplay: 'always' を指定します。これで 0 秒は 0 秒 になります。ただし、いつも指定すると 3,600 秒が 1 時間 0 秒 になりました。そこで Duration では、秒数が 1 未満のときだけ 'always' にしています。
digital に secondsDisplay: 'auto' を渡すと、0 秒の欄が消える
useDurationFormat で、0 秒以外のときに secondsDisplay を 'auto' ではなく undefined にしているのは、digital の表示が崩れるためです。
digital では、時・分・秒の hoursDisplay・minutesDisplay・secondsDisplay の既定値が 'always' です(MDN の Intl.DurationFormat() コンストラクターの説明)。resolvedOptions() で見ても、long では3つとも auto、digital では3つとも always でした。
ここに 'auto' を明示して渡すと、既定値が上書きされます。{ hours: 1, minutes: 24, seconds: 0 } の結果は次のとおりでした。
secondsDisplay |
結果 |
|---|---|
| 指定しない | 1:24:00 |
'auto' |
1:24 |
undefined |
1:24:00 |
1:24 では、1 時間 24 分なのか 1 分 24 秒なのか分かりません。オプションを条件で切り替えるときは、指定しない場合の値を 'auto' ではなく undefined にしておきます。
Node.js 22 では使えないので、代わりの表示を用意する
MDN の Intl.DurationFormat の互換性の表では、対応した版は Chrome 129、Firefox 136、Safari 16.4、Node.js 23.0.0 です。検証環境でも、Node.js 22.23.4 では typeof Intl.DurationFormat が undefined、Node.js 24.22.1 では function でした。
そこで、DurationFormat がないときは「1:23:45」の形で出す関数を用意しました。Duration は、useDurationFormat が null を返したときにこれを使います。
// DurationFormat がない環境では「1:23:45」の形で出す
export function formatFallback(d: Hms): string {
const mm = String(d.minutes).padStart(2, '0');
const ss = String(d.seconds).padStart(2, '0');
return `${d.hours}:${mm}:${ss}`;
}
サーバーで HTML を作る場合は、サーバーの Node.js の版にも注意します。renderToString で作った HTML の「日本語(空白なし)」の欄は、Node.js 24 ではブラウザと同じ 1時間23分45秒 でした。Node.js 22 では代わりの表示の 1:23:45 になり、ブラウザの表示と食い違いました。
TypeScript では、tsconfig.json の lib が es2022 のままだと、Intl.DurationFormat の型がなく、次のエラーになりました。
typecheck/old-lib.ts(2,28): error TS2550: Property 'DurationFormat' does not exist on type 'typeof Intl'. Do you need to change your target library? Try changing the 'lib' compiler option to 'es2025' or later.
lib を ["es2025", "dom"] にすると、Intl.DurationFormat と Intl.DurationFormatOptions の型が使えるようになり、型チェックが通りました。





