MySQLのSTR_TO_DATE()関数とは？文字列を日付値に変換する使い方を解説

MySQLのSTR_TO_DATE()関数とは

STR_TO_DATE()関数は、文字列の値を指定した書式に従って日付・日時（DATETIME）値に変換するためのMySQL組み込み関数です。変換対象となる文字列と、その文字列がどのような形式で表現されているかを示す書式文字列の、2つの引数を渡す必要があります。

この関数を使うことで、「20172810」のように一見すると日付に見えない文字列でも、正しい順序で書式を指定すれば「2017-10-28」という有効な日付値として扱えるようになります。

基本構文

STR_TO_DATE(string, format)

• string： 日付・日時値に変換したい元の文字列
• format： 文字列の並び順を示す書式指定子（例：'%Y%d%m'）

使用例

以下の例では、「20172810」という文字列を「%Y%d%m」（4桁の年・日・月の順）という書式で解釈し、有効な日付値に変換しています。

mysql> Select STR_TO_DATE('20172810', '%Y%d%m');
+-----------------------------------+
| STR_TO_DATE('20172810', '%Y%d%m') |
+-----------------------------------+
| 2017-10-28                        |
+-----------------------------------+
1 row in set (0.00 sec)

結果として「2017-10-28」が返され、文字列が正しく日付値へ変換されたことが確認できます。

主な書式指定子の一覧

format引数には、以下のような書式指定子を組み合わせて使用します。

注意点

指定した書式と文字列の内容が一致しない場合、STR_TO_DATE()関数はNULLを返し、警告（Warning）が出力されます。また、存在しない日付（例：2月30日など）を指定した場合も同様にNULLが返されるため、データをインポートする際などは事前に書式を確認しておくことをおすすめします。