MySQLのFROM_UNIXTIME()関数とは？使い方と使用例をわかりやすく解説

MySQLのFROM_UNIXTIME()関数は、Unixタイムスタンプをもとに日付・日時（DATETIME）の値を返す関数です。戻り値の形式は、関数が使用されるコンテキストによって異なり、文字列コンテキストでは「YYYY-MM-DD HH:MM:SS」、数値コンテキストでは「YYYYMMDDHHMMSS.uuuuuu」のいずれかの形式で出力されます。

FROM_UNIXTIME()関数の基本構文

FROM_UNIXTIME(unix_timestamp, [format])

• unix_timestamp： 変換対象となるUnixタイムスタンプの値（1970年1月1日 00:00:00 UTCからの経過秒数）を指定します。
• format（省略可能）： 戻り値の表示形式を指定する書式文字列です。省略した場合はデフォルトの形式で返されます。

基本的な使用例

mysql> Select FROM_UNIXTIME(1555033470);
+---------------------------+
| FROM_UNIXTIME(1555033470) |
+---------------------------+
| 2019-04-12 07:14:30       |
+---------------------------+
1 row in set (0.00 sec)

この例では、Unixタイムスタンプ「1555033470」が「2019-04-12 07:14:30」という日時形式に変換されて返されています。

format引数を指定した使用例

第2引数に書式文字列を指定すると、任意の形式で日時を取得できます。たとえば、日本で一般的な「年月日」表記への変換も簡単に行えます。

mysql> SELECT FROM_UNIXTIME(1555033470, '%Y年%m月%d日 %H時%i分%s秒');
+----------------------------------------------------------+
| FROM_UNIXTIME(1555033470, '%Y年%m月%d日 %H時%i分%s秒')   |
+----------------------------------------------------------+
| 2019年04月12日 07時14分30秒                               |
+----------------------------------------------------------+
1 row in set (0.00 sec)

まとめ

FROM_UNIXTIME()関数を使えば、Unixタイムスタンプを人が読みやすい日付・日時形式へ簡単に変換できます。ログデータの時刻解析や、タイムスタンプ形式で保存されたデータの表示などに非常に便利です。なお、逆に日付からUnixタイムスタンプを取得したい場合は、UNIX_TIMESTAMP()関数を使用します。