技術資料

SELECTで日時や時間を取得するとき、「日時を読みやすく表示したい」「所要時間を秒数にして計算したい」といったことがあります。

日時の表示を整えるならDATE_FORMAT、時間を秒数へ変換するならTIME_TO_SECを使えます。今回は、それぞれの基本と、書式指定やNULL、24時間を超える時間の扱いを説明します。SELECTの基本が分かる人向けの内容です。

対象はMySQL 8.4です。仕様は2026年10月13日時点の公式資料で確認しています。

DATE_FORMATで日時の表示を整える

DATE_FORMATは、日時と書式を指定すると、その書式の文字列を返します。基本的な形は次のとおりです。

DATE_FORMAT(日時, 書式)

書式には、年を表す%Y、月を表す%mなどを組み合わせて書きます。よく使う指定は次のとおりです。

例えば、次のSELECTでは、元の日時と二つの表示形式を並べています。

SELECT
    '2026-10-13 09:05:07' AS original_datetime,
    DATE_FORMAT('2026-10-13 09:05:07', '%Y/%m/%d') AS date_label,
    DATE_FORMAT('2026-10-13 09:05:07', '%Y-%m-%d %H:%i:%s') AS datetime_label;

SQLの例では、日時を文字列で直接指定しています。テーブルの列に適用する場合は、DATE_FORMAT(created_at, '%Y/%m/%d')のように、最初の引数を列名へ置き換えます。

スラッシュやハイフン、コロンは、そのまま結果に含まれます。ここで変わるのはSELECTの出力で、保存済みの日時が書き換わるわけではありません。また、DATE_FORMATの結果は日付型ではなく文字列なので、表示用の列として使い、日時の比較や計算には元の日時を使うと分かりやすいです。

月は%m、分は%i

書式で間違えやすいのが、月と分の指定です。分には%iを使います。先ほどの日時で'%H:%m:%s'と書くと、期待結果は09:10:07となり、分の位置に10月の「10」が入ってしまいます。

時分秒を表示するなら'%H:%i:%s'と覚えておくとよいかと思います。書式の一覧は、MySQL公式のDATE_FORMATの説明を参照してください。

日時か書式がNULLなら、結果もNULL

DATE_FORMATは、日時または書式がNULLの場合、NULLを返します。

SELECT
    DATE_FORMAT(NULL, '%Y/%m/%d') AS null_datetime,
    DATE_FORMAT('2026-10-13 09:05:07', NULL) AS null_format;

画面で「未設定」などと表示したい場合は、NULLの扱いを別途決めます。条件に応じた表示名を作る方法は、MySQLのCASE式入門の記事でも説明しています。

TIME_TO_SECで時間を秒数にする

TIME_TO_SECは、時間を秒数へ変換する関数です。

TIME_TO_SEC(時間)

例えば、説明用の所要時間が1時間30分なら、次のように秒数や分数へ変換できます。

SELECT
    '01:30:00' AS original_duration,
    TIME_TO_SEC('01:30:00') AS duration_seconds,
    TIME_TO_SEC('01:30:00') / 60 AS duration_minutes;

1時間は3600秒、30分は1800秒なので、合計5400秒です。さらに60で割ると90分になります。表は数値としての期待結果を示しており、小数点以下の表示桁数はクライアントなどによって異なる場合があります。

所要時間を保存した列がdurationなら、TIME_TO_SEC(duration)のように書けます。秒数にしておけば、秒単位のしきい値と比較したり、合計や平均を求めたりする際に扱いやすくなります。構文と戻り値は、MySQL公式のTIME_TO_SECの説明で確認できます。

時刻と所要時間は、データの意味を分けて考える

MySQLのTIME型は、「午前1時30分」のような時刻にも、「1時間30分」のような経過時間にも使えます。TIME_TO_SECは、そのデータがどちらの意味なのかを判断してくれるわけではありません。

時刻としての01:30:00を渡しても結果は5400ですが、それだけで作業の所要時間を求めたことにはなりません。開始日時と終了日時から秒単位の差を求めたい場合は、TIMESTAMPDIFF(SECOND, 開始日時, 終了日時)など、日時同士の差を求める処理を使います。TIME_TO_SECは、日時をUNIXタイムスタンプへ変換する関数でもありません。

NULL・負の時間・24時間を超える時間を確認する

TIME_TO_SECは、NULLを渡すとNULLを返します。また、MySQLのTIME型は負の時間や24時間を超える時間も表せるので、所要時間を扱うときは、そのような値も確認しておきます。

次の例では、WITH句で比較用の5行を用意しています。テーブルの作成や保存済みデータの変更は不要です。WITH句の基本は、MySQLのWITH句入門の記事を参照してください。

WITH sample_durations AS (
    SELECT 1 AS id, '00:00:00' AS duration
    UNION ALL SELECT 2, '00:00:30'
    UNION ALL SELECT 3, '-00:30:00'
    UNION ALL SELECT 4, '25:00:00'
    UNION ALL SELECT 5, NULL
)
SELECT
    id,
    duration,
    TIME_TO_SEC(duration) AS duration_seconds
FROM sample_durations
ORDER BY id;

25時間は90000秒になり、24時間を超えた分も含まれます。NULLは0秒と区別されますし、負の値を自動的に0へ補正することもありません。所要時間として負の値を許容するかどうかは、データの用途に合わせて判断しましょう。

なお、TIME型には範囲があり、整数秒では-838:59:59から838:59:59までです。任意の長さの経過時間を格納できるわけではありません。省略した時間表記や、範囲外・不正な値の扱いにも注意が必要なので、例ではhh:mm:ssの形にそろえています。詳しくは、MySQL公式のTIME型の説明を確認してください。

DATE_FORMATは表示用の文字列、TIME_TO_SECは計算に使う秒数を返します。まずは元の値と加工後の値を並べて、表示したい形式や計算したい単位になっているかを確認してみてください。