Reactで秒数を「1時間23分45秒」と表示する方法

​​2026年11月14日​React​Intl.DurationFormat,TypeScript,useMemo

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 秒 が返りました。

そこで、秒数を時・分・秒に分ける関数を用意します。

ts
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 では、次の部品が返りました。

text
1(integer) " "(literal) 時間(unit) " "(literal) 23(integer) " "(literal) 分(unit) …

空白は type が literal の部品です。検証環境では、どれも普通の半角スペース(U+0020)でした。この部品だけを除いてつなげると、「1時間23分45秒」の形になります。

ts
// 数と単位のあいだの空白を取り除き、「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 を返し、後で説明する代わりの表示に切り替えます。

ts
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 で受け取ります。

tsx
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で開いた検証用の画面。合計 5,025 秒の下に、日本語(空白なし)は「1時間23分45秒」、日本語(long)は「1 時間 23 分 45 秒」、英語(long)は「1 hour, 23 minutes, 45 seconds」、digital は「1:23:45」と並び、その下に +1秒、+1分、+1時間、0秒、再描画のボタンがある
5,025 秒を4通りに表示した画面(幅375px)

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 を返したときにこれを使います。

ts
// 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 の型がなく、次のエラーになりました。

text
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 の型が使えるようになり、型チェックが通りました。

​Posted by 86