MySQLで日付値として指定するために必要な文字列・数値の桁数とは？

MySQLで日付値として認識されるための最小桁数

MySQLでは、文字列や数値を日付値として指定する場合、年を4桁で表すか2桁で表すかによって、必要な桁数が異なります。この記事では、TIMESTAMP関数を使った具体例とともに、それぞれのケースで必要な桁数を詳しく解説します。

年を4桁の値として扱う場合：最低8桁が必要

年を4桁の値として考える場合、MySQLが文字列や数値を日付値として認識するには、最低8桁が必要です。さらにマイクロ秒まで保存したい場合は、最大20桁まで指定できます。

20桁の文字列（マイクロ秒あり）の例

mysql> Select TIMESTAMP('20171022040536.100000');
+-----------------------------------+
| TIMESTAMP('20171022040536100000') |
+-----------------------------------+
| 2017-10-22 04:05:36.100000        |
+-----------------------------------+
1 row in set, 1 warning (0.00 sec)

上記のクエリでは、TIMESTAMP値として20桁の文字列を指定しています。最後の6桁はマイクロ秒を表しています。

8桁の数値（日付のみ）の例

mysql> Select TIMESTAMP(20171022);
+---------------------+
| TIMESTAMP(20171022) |
+---------------------+
| 2017-10-22 00:00:00 |
+---------------------+
1 row in set (0.00 sec)

このクエリでは、TIMESTAMP値として8桁の数値を指定しています。時刻部分は自動的に「00:00:00」となります。

7桁の場合はNULLが返される

mysql> Select TIMESTAMP(201710);
+-------------------+
| TIMESTAMP(201710) |
+-------------------+
| NULL              |
+-------------------+
1 row in set, 1 warning (0.00 sec)

上記のクエリはNULLを返します。これは、桁数が8桁に満たないためです。

年を2桁の値として扱う場合：最低6桁が必要

一方、年を2桁の値として考える場合は、MySQLが文字列や数値を日付値として認識するのに、最低6桁が必要です。マイクロ秒まで保存したい場合は、最大18桁まで指定できます。

6桁の数値（日付のみ）の例

mysql> Select TIMESTAMP(171022);
+---------------------+
| TIMESTAMP(171022)   |
+---------------------+
| 2017-10-22 00:00:00 |
+---------------------+
1 row in set (0.00 sec)

上記のクエリでは、TIMESTAMP値として6桁の数値を指定しています。「171022」は「2017年10月22日」として解釈されます。

18桁の文字列（マイクロ秒あり）の例

mysql> Select TIMESTAMP('171022040536.200000');
+----------------------------------+
| TIMESTAMP('171022040536.200000') |
+----------------------------------+
| 2017-10-22 04:05:36.200000       |
+----------------------------------+
1 row in set (0.00 sec)

このクエリでは、TIMESTAMP値として18桁の文字列を指定しています。ドット（.）の後の最後の6桁がマイクロ秒を表しています。

4桁の場合はNULLが返される

mysql> Select TIMESTAMP(1710);
+-----------------+
| TIMESTAMP(1710) |
+-----------------+
| NULL            |
+-----------------+
1 row in set, 1 warning (0.00 sec)

上記のクエリはNULLを返します。これは、桁数が6桁に満たないためです。

まとめ

MySQLで日付値を文字列や数値として指定する際は、上記の桁数ルールを守ることが重要です。必要な桁数に満たない場合、MySQLはNULLを返し、警告を出力します。特にマイクロ秒まで精度が必要な場合は、小数点以下6桁を追加することを忘れないようにしましょう。