STR_TO_DATE

宣言

STR_TO_DATE(str, format)

説明

format を使用して、str を DATETIME 値、DATE 値、または TIME 値に変換します。戻り値のタイプは、format が日付時刻のどの部分を含むかによって異なります。

• str または format が NULL の場合、この関数は NULL を返します。

• str が有効な日付形式でない場合、戻り値は sql_mode の設定によって異なります：

  • sql_mode に NO_ZERO_IN_DATE が含まれている場合：NULL を返します。

  • sql_mode に NO_ZERO_IN_DATE が含まれていない場合：

    • str がINT型であり、かつ str < 0 の場合、0000-00-00 00:00:00 を返し、Warningを表示します。

      obclient> SELECT STR_TO_DATE(-100,'%Y-%b-%D %r');
      +---------------------------------+
      | STR_TO_DATE(-100,'%Y-%b-%D %r') |
      +---------------------------------+
      | 0000-00-00 00:00:00             |
      +---------------------------------+
      1 row in set, 1 warning
      

    • str がINT型であり、かつ 0 ≤ str ≤ 69 の場合、1999-11-30 00:00:00 に str の年を加算した値を返します。

      obclient> SELECT STR_TO_DATE(0,'%Y-%b-%D %r');
      +------------------------------+
      | STR_TO_DATE(0,'%Y-%b-%D %r') |
      +------------------------------+
      | 1999-11-30 00:00:00          |
      +------------------------------+
      1 row in set
      

    • str がINT型であり、かつ 69 < str ≤ 99 の場合、1969-11-30 00:00:00 に str - 70 の年を加算した値を返します。

      obclient> SELECT STR_TO_DATE(88,'%Y-%b-%D %r');
      +-------------------------------+
      | STR_TO_DATE(88,'%Y-%b-%D %r') |
      +-------------------------------+
      | 1987-11-30 00:00:00           |
      +-------------------------------+
      1 row in set
      

    • str がINT型であり、かつ 100 < str ≤ 9999 の場合、0099-11-30 00:00:00 に str - 100 の年を加算した値を返します。

      obclient> SELECT STR_TO_DATE(2088,'%Y-%b-%D %r');
      +---------------------------------+
      | STR_TO_DATE(2088,'%Y-%b-%D %r') |
      +---------------------------------+
      | 2087-11-30 00:00:00             |
      +---------------------------------+
      1 row in set
      

    • str がINT型であり、かつ str > 10000 の場合、NULL を返し、Warningを表示します。

      obclient> SELECT STR_TO_DATE(10001,'%Y-%b-%D %r');
      +----------------------------------+
      | STR_TO_DATE(10001,'%Y-%b-%D %r') |
      +----------------------------------+
      | NULL                             |
      +----------------------------------+
      1 row in set, 1 warning
      

    • str が文字列の場合、文字列を可能な限り日付時刻に変換し、1999-11-30 00:00:00 に str を加算した値を日付時刻型として返します。日付時刻に変換できない場合は、NULL を返します。

      obclient> SELECT STR_TO_DATE('a2014-Jan-1st 5:5:5 pm', '%Y-%b-%D %r');
      +------------------------------------------------------+
      | STR_TO_DATE('a2014-Jan-1st 5:5:5 pm', '%Y-%b-%D %r') |
      +------------------------------------------------------+
      | NULL                                                 |
      +------------------------------------------------------+
      1 row in set, 1 warning
      
      obclient> SELECT STR_TO_DATE('a2014-Jan-1st 5:5:5 pm', 'a%Y-%b-%D %r');
      +-------------------------------------------------------+
      | STR_TO_DATE('a2014-Jan-1st 5:5:5 pm', 'a%Y-%b-%D %r') |
      +-------------------------------------------------------+
      | 2014-01-01 05:05:05                                   |
      +-------------------------------------------------------+
      1 row in set
      

    • str がその他の型の場合、NULL を返し、Warningを表示します。

      obclient> SELECT STR_TO_DATE(1.6,'%Y-%b-%D %r');
      +--------------------------------+
      | STR_TO_DATE(1.6,'%Y-%b-%D %r') |
      +--------------------------------+
      | NULL                           |
      +--------------------------------+
      1 row in set, 1 warning
      
      obclient> SELECT STR_TO_DATE(pi(),'%Y-%b-%D %r');
      +---------------------------------+
      | STR_TO_DATE(pi(),'%Y-%b-%D %r') |
      +---------------------------------+
      | NULL                            |
      +---------------------------------+
      1 row in set, 1 warning
      

format がサポートする形式については、DATE_FORMATを参照してください。

例

obclient> SELECT STR_TO_DATE('2014-Jan-1st 5:5:5 pm', '%Y-%b-%D %r');
+-----------------------------------------------------+
| STR_TO_DATE('2014-Jan-1st 5:5:5 pm', '%Y-%b-%D %r') |
+-----------------------------------------------------+
| 2014-01-01 05:05:05                                 |
+-----------------------------------------------------+
1 row in set