ADDDATE(date,INTERVAL expr unit), ADDDATE(expr,days)

INTERVAL 形式の 2 番目の引数を付けて呼び出されると、ADDDATE() は DATE_ADD() のシノニムになります。 関連する関数 SUBDATE() は DATE_SUB() のシノニムです。 INTERVAL unit 引数の詳細は、時間間隔 を参照してください。

mysql> SELECT DATE_ADD('2008-01-02', INTERVAL 31 DAY);
        -> '2008-02-02'
mysql> SELECT ADDDATE('2008-01-02', INTERVAL 31 DAY);
        -> '2008-02-02'

days 形式の 2 番目の引数を付けて呼び出されると、MySQL では expr に加算される整数の日数として処理されます。

mysql> SELECT ADDDATE('2008-01-02', 31);
        -> '2008-02-02'

ADDTIME(expr1,expr2)

ADDTIME() は expr2 と expr1 を加算し、その結果を返します。expr1 は時間または日付時間式であり、expr2 は時間式です。

mysql> SELECT ADDTIME('2007-12-31 23:59:59.999999', '1 1:1:1.000002');
        -> '2008-01-02 01:01:01.000001'
mysql> SELECT ADDTIME('01:00:00.999999', '02:00:00.999998');
        -> '03:00:01.999997'

CONVERT_TZ(dt,from_tz,to_tz)

CONVERT_TZ() は、日付時間値 dt を from_tz で指定されたタイムゾーンから、to_tz で指定されたタイムゾーンに変換し、結果の値を返します。 タイムゾーンは、セクション5.1.15「MySQL Server でのタイムゾーンのサポート」で説明されているように指定されます。 引数が無効な場合、この関数は NULL を返します。

from_tz から UTC に変換される際に、値が TIMESTAMP でサポートされている範囲から外れている場合は、変換が実行されません。 TIMESTAMP の範囲については、セクション11.2.1「日時データ型の構文」で説明されています。

mysql> SELECT CONVERT_TZ('2004-01-01 12:00:00','GMT','MET');
        -> '2004-01-01 13:00:00'
mysql> SELECT CONVERT_TZ('2004-01-01 12:00:00','+00:00','+10:00');
        -> '2004-01-01 22:00:00'

CURDATE()

関数が文字列または数値のどちらのコンテキストで使用されているかに応じて、現在の日付を'YYYY-MM-DD'または YYYYMMDD 形式の値として返します。

mysql> SELECT CURDATE();
        -> '2008-06-13'
mysql> SELECT CURDATE() + 0;
        -> 20080613

CURRENT_DATE, CURRENT_DATE()

CURRENT_DATE および CURRENT_DATE() は CURDATE() のシノニムです。

CURRENT_TIME, CURRENT_TIME([fsp])

CURRENT_TIME および CURRENT_TIME() は CURTIME() のシノニムです。

CURRENT_TIMESTAMP, CURRENT_TIMESTAMP([fsp])

CURRENT_TIMESTAMP および CURRENT_TIMESTAMP() は NOW() のシノニムです。

CURTIME([fsp])

関数が文字列または数値のどちらのコンテキストで使用されているかに応じて、現在の時間を'hh:mm:ss'または hhmmss 形式の値として返します。 値はセッションのタイムゾーンで表されます。

0 から 6 までの小数秒精度を指定するために fsp 引数が指定されている場合、戻り値にはその桁数の小数秒部分が含まれます。

mysql> SELECT CURTIME();
        -> '23:50:26'
mysql> SELECT CURTIME() + 0;
        -> 235026.000000

DATE(expr)

日付または日付時間式 expr の日付部分を抽出します。

mysql> SELECT DATE('2003-12-31 01:02:03');
        -> '2003-12-31'

DATEDIFF(expr1,expr2)

DATEDIFF() は、ある日付から別の日付までの日数の値として表現された expr1 − expr2 を返します。expr1 および expr2 は、日付または日付時間式です。 値の日付部分のみが計算に使用されます。

mysql> SELECT DATEDIFF('2007-12-31 23:59:59','2007-12-30');
        -> 1
mysql> SELECT DATEDIFF('2010-11-30 23:59:59','2010-12-31');
        -> -31

DATE_ADD(date,INTERVAL expr unit), DATE_SUB(date,INTERVAL expr unit)

これらの関数は日付演算を実行します。 date 引数は、開始日または日時の値を指定します。expr は、開始日に対して加算または減算される間隔値を指定する式です。expr は文字列として評価されます。負の間隔では - で始まる場合があります。unit は、式を解釈する単位を示すキーワードです。

unit 指定子の完全なリスト、各 unit 値に必要な expr 引数の形式、および時間演算でのオペランド解釈の規則など、時間間隔構文の詳細は、時間間隔 を参照してください。

戻り値は引数によって異なります。

必ず結果が DATETIME になるようにするには、CAST() を使用すれば、第 1 引数を DATETIME に変換できます。

mysql> SELECT DATE_ADD('2018-05-01',INTERVAL 1 DAY);
        -> '2018-05-02'
mysql> SELECT DATE_SUB('2018-05-01',INTERVAL 1 YEAR);
        -> '2017-05-01'
mysql> SELECT DATE_ADD('2020-12-31 23:59:59',
    ->                 INTERVAL 1 SECOND);
        -> '2021-01-01 00:00:00'
mysql> SELECT DATE_ADD('2018-12-31 23:59:59',
    ->                 INTERVAL 1 DAY);
        -> '2019-01-01 23:59:59'
mysql> SELECT DATE_ADD('2100-12-31 23:59:59',
    ->                 INTERVAL '1:1' MINUTE_SECOND);
        -> '2101-01-01 00:01:00'
mysql> SELECT DATE_SUB('2025-01-01 00:00:00',
    ->                 INTERVAL '1 1:1:1' DAY_SECOND);
        -> '2024-12-30 22:58:59'
mysql> SELECT DATE_ADD('1900-01-01 00:00:00',
    ->                 INTERVAL '-1 10' DAY_HOUR);
        -> '1899-12-30 14:00:00'
mysql> SELECT DATE_SUB('1998-01-02', INTERVAL 31 DAY);
        -> '1997-12-02'
mysql> SELECT DATE_ADD('1992-12-31 23:59:59.000002',
    ->            INTERVAL '1.999999' SECOND_MICROSECOND);
        -> '1993-01-01 00:00:01.000001'

DATE_FORMAT(date,format)

format 文字列に従って、date 値を書式設定します。

次のテーブルに示す指定子は、format 文字列で使用できます。 書式指定子文字の前には、% 文字を付ける必要があります。 指定子は他の関数にも適用されます: STR_TO_DATE(), TIME_FORMAT(), UNIX_TIMESTAMP()。

MySQL では '2014-00-00' などの不完全な日付の格納が許可されるため、月および日の指定子の範囲はゼロから始まります。

日および月の名前と略語に使用される言語は、lc_time_names システム変数 (セクション10.16「MySQL Server のロケールサポート」) の値で制御されます。

%U、%u、%V、および %v 指定子のモード値については、WEEK() 関数の説明を参照してください。 モードによって、週番号が付与される方法が影響を受けます。

DATE_FORMAT() は、ASCII 以外の文字を含む月および週の名前を返すことができるように、character_set_connection および collation_connection で指定された文字セットおよび照合順序を含む文字列を返します。

mysql> SELECT DATE_FORMAT('2009-10-04 22:23:00', '%W %M %Y');
        -> 'Sunday October 2009'
mysql> SELECT DATE_FORMAT('2007-10-04 22:23:00', '%H:%i:%s');
        -> '22:23:00'
mysql> SELECT DATE_FORMAT('1900-10-04 22:23:00',
    ->                 '%D %y %a %d %m %b %j');
        -> '4th 00 Thu 04 10 Oct 277'
mysql> SELECT DATE_FORMAT('1997-10-04 22:23:00',
    ->                 '%H %k %I %r %T %S %w');
        -> '22 22 10 10:23:00 PM 22:23:00 00 6'
mysql> SELECT DATE_FORMAT('1999-01-01', '%X %V');
        -> '1998 52'
mysql> SELECT DATE_FORMAT('2006-06-00', '%d');
        -> '00'

DATE_SUB(date,INTERVAL expr unit)

DATE_ADD() の説明を参照してください。

DAY(date)

DAY() は DAYOFMONTH() のシノニムです。

DAYNAME(date)

date に対応する曜日の名前を返します。 名前に使用される言語は、lc_time_names システム変数 (セクション10.16「MySQL Server のロケールサポート」) の値で制御されます。

mysql> SELECT DAYNAME('2007-02-03');
        -> 'Saturday'

DAYOFMONTH(date)

1 から 31 までの範囲内で date に対応する日を返します。'0000-00-00' や '2008-00-00' のように日の部分がゼロの場合は、0 を返します。

mysql> SELECT DAYOFMONTH('2007-02-03');
        -> 3

DAYOFWEEK(date)

date の曜日インデックス (1 = Sunday、2 = Monday、…、7 = Saturday) を返します。 これらのインデックス値は、ODBC 標準に対応しています。

mysql> SELECT DAYOFWEEK('2007-02-03');
        -> 7

DAYOFYEAR(date)

1 から 366 までの範囲内で date に対応する通日を返します。

mysql> SELECT DAYOFYEAR('2007-02-03');
        -> 34

EXTRACT(unit FROM date)

EXTRACT() 関数は、DATE_ADD() または DATE_SUB() と同じ種類の unit 指定子を使用しますが、日付演算を実行するのではなく、日付から部分を抽出します。 unit 引数の詳細は、時間間隔 を参照してください。

mysql> SELECT EXTRACT(YEAR FROM '2019-07-02');
        -> 2019
mysql> SELECT EXTRACT(YEAR_MONTH FROM '2019-07-02 01:02:03');
        -> 201907
mysql> SELECT EXTRACT(DAY_MINUTE FROM '2019-07-02 01:02:03');
        -> 20102
mysql> SELECT EXTRACT(MICROSECOND
    ->                FROM '2003-01-02 10:30:00.000123');
        -> 123

FROM_DAYS(N)

日数 N が指定され、DATE 値を返します。

mysql> SELECT FROM_DAYS(730669);
        -> '2000-07-03'

古い日付では、FROM_DAYS() を慎重に使用してください。 グレゴリオ暦 (1582) の出現よりも前の値とともに使用することを目的に設計されていません。 セクション12.9「MySQL で使用されるカレンダー」を参照してください。

FROM_UNIXTIME(unix_timestamp[,format])

関数が文字列または数値のどちらのコンテキストで使用されているかに応じて、unix_timestamp 引数の表現を'YYYY-MM-DD hh:mm:ss'または YYYYMMDDhhmmss 形式の値として返します。unix_timestamp は、'1970-01-01 00:00:00' UTC 以降の秒数を表す内部タイムスタンプ値で、UNIX_TIMESTAMP() 関数によって生成されます。

戻り値は、セッションのタイムゾーンで表されます。 (クライアントは、セクション5.1.15「MySQL Server でのタイムゾーンのサポート」 の説明に従ってセッションタイムゾーンを設定できます。) format 文字列 (指定されている場合) は、DATE_FORMAT() 関数のエントリで説明されているのと同じ方法で結果を書式設定するために使用されます。

mysql> SELECT FROM_UNIXTIME(1447430881);
        -> '2015-11-13 10:08:01'
mysql> SELECT FROM_UNIXTIME(1447430881) + 0;
        -> 20151113100801
mysql> SELECT FROM_UNIXTIME(1447430881,
    ->                      '%Y %D %M %h:%i:%s %x');
        -> '2015 13th November 10:08:01 2015'

GET_FORMAT({DATE|TIME|DATETIME}, {'EUR'|'USA'|'JIS'|'ISO'|'INTERNAL'})

書式文字列を返します。 この関数は、DATE_FORMAT() およびSTR_TO_DATE() 関数と組み合わせて使用すると便利です。

1 番目と 2 番目の引数に値を指定できるため、複数の書式文字列を生成できます (使用される指定子については、DATE_FORMAT() 関数の説明で示す表を参照してください)。 ISO 書式は ISO 8601 ではなく、ISO 9075 を参照しています。

TIMESTAMP は、GET_FORMAT() への 1 番目の引数としても使用できます。その場合、関数は DATETIME の場合と同じ値を返します。

mysql> SELECT DATE_FORMAT('2003-10-03',GET_FORMAT(DATE,'EUR'));
        -> '03.10.2003'
mysql> SELECT STR_TO_DATE('10.31.2003',GET_FORMAT(DATE,'USA'));
        -> '2003-10-31'

HOUR(time)

time に対応する時を返します。 戻り値の範囲は、日付時間値の 0 から 23 までです。 ただし、TIME 値の範囲は実際にはもっと大きいため、HOUR は 23 よりも大きい値を返すことができます。

mysql> SELECT HOUR('10:05:03');
        -> 10
mysql> SELECT HOUR('272:59:59');
        -> 272

LAST_DAY(date)

日付または日付時間の値が指定され、月の最終日に対応する値を返します。 引数が無効である場合は、NULL を返します。

mysql> SELECT LAST_DAY('2003-02-05');
        -> '2003-02-28'
mysql> SELECT LAST_DAY('2004-02-05');
        -> '2004-02-29'
mysql> SELECT LAST_DAY('2004-01-01 01:01:01');
        -> '2004-01-31'
mysql> SELECT LAST_DAY('2003-03-32');
        -> NULL

LOCALTIME, LOCALTIME([fsp])

LOCALTIME および LOCALTIME() は NOW() のシノニムです。

LOCALTIMESTAMP, LOCALTIMESTAMP([fsp])

LOCALTIMESTAMP および LOCALTIMESTAMP() は NOW() のシノニムです。

MAKEDATE(year,dayofyear)

指定された年と年間通算値から、日付を返します。dayofyear は 0 よりも大きくする必要があり、それ以外の場合は結果が NULL になります。

mysql> SELECT MAKEDATE(2011,31), MAKEDATE(2011,32);
        -> '2011-01-31', '2011-02-01'
mysql> SELECT MAKEDATE(2011,365), MAKEDATE(2014,365);
        -> '2011-12-31', '2014-12-31'
mysql> SELECT MAKEDATE(2011,0);
        -> NULL

MAKETIME(hour,minute,second)

hour、minute、および second 引数から計算された時間値を返します。

second 引数には小数部を含めることができます。

mysql> SELECT MAKETIME(12,15,30);
        -> '12:15:30'

MICROSECOND(expr)

0 から 999999 までの範囲内の数値として、時間または日付時間式 expr からのマイクロ秒を返します。

mysql> SELECT MICROSECOND('12:00:00.123456');
        -> 123456
mysql> SELECT MICROSECOND('2019-12-31 23:59:59.000010');
        -> 10

MINUTE(time)

0 から 59 までの範囲内で、time に対応する分を返します。

mysql> SELECT MINUTE('2008-02-03 10:05:03');
        -> 5

MONTH(date)

1 (1 月) から 12 (12 月) の範囲内で、date に対応する月を返します。'0000-00-00' や '2008-00-00' のように月の部分がゼロの場合は、0 を返します。

mysql> SELECT MONTH('2008-02-03');
        -> 2

MONTHNAME(date)

date に対応する月の完全名を返します。 名前に使用される言語は、lc_time_names システム変数 (セクション10.16「MySQL Server のロケールサポート」) の値で制御されます。

mysql> SELECT MONTHNAME('2008-02-03');
        -> 'February'

NOW([fsp])

関数が文字列または数値のどちらのコンテキストで使用されているかに応じて、現在の日時を'YYYY-MM-DD hh:mm:ss'または YYYYMMDDhhmmss 形式の値として返します。 値はセッションのタイムゾーンで表されます。

0 から 6 までの小数秒精度を指定するために fsp 引数が指定されている場合、戻り値にはその桁数の小数秒部分が含まれます。

mysql> SELECT NOW();
        -> '2007-12-15 23:50:26'
mysql> SELECT NOW() + 0;
        -> 20071215235026.000000

NOW() は、ステートメントが実行を開始する時刻を示す定数時間を返します。 (ストアドファンクションまたはトリガーでは、NOW() は関数またはトリガーステートメントが実行を開始する時間を返します。) これは、正確な実行時間を返す SYSDATE() の動作とは異なります。

mysql> SELECT NOW(), SLEEP(2), NOW();
+---------------------+----------+---------------------+
| NOW()               | SLEEP(2) | NOW()               |
+---------------------+----------+---------------------+
| 2006-04-12 13:47:36 |        0 | 2006-04-12 13:47:36 |
+---------------------+----------+---------------------+

mysql> SELECT SYSDATE(), SLEEP(2), SYSDATE();
+---------------------+----------+---------------------+
| SYSDATE()           | SLEEP(2) | SYSDATE()           |
+---------------------+----------+---------------------+
| 2006-04-12 13:47:44 |        0 | 2006-04-12 13:47:46 |
+---------------------+----------+---------------------+

さらに、SET TIMESTAMP ステートメントによって、NOW() で返された値は影響を受けますが、SYSDATE() で返された値は影響を受けません。 つまり、バイナリログのタイムスタンプ設定は、SYSDATE() の呼び出しに影響しないことを意味します。 タイムスタンプをゼロ以外の値に設定すると、後続の NOW() が起動されるたびに、その値が返されます。 タイムスタンプをゼロに設定すると、この効果が取り消され、再度 NOW() が現在の日付と時間を返すようになります。

2 つの関数の相違点についての詳細は、SYSDATE() の説明を参照してください。

PERIOD_ADD(P,N)

N 月を期間 P に (YYMM または YYYYMM の書式で) 加算します。 YYYYMM の書式で値を返します。

mysql> SELECT PERIOD_ADD(200801,2);
        -> 200803

PERIOD_DIFF(P1,P2)

期間 P1 と P2 間の月数を返します。 P1 および P2 は、YYMM または YYYYMM の書式にする必要があります。 期間引数 P1 および P2 は日付値ではないことに注意してください。

mysql> SELECT PERIOD_DIFF(200802,200703);
        -> 11

QUARTER(date)

1 から 4 までの範囲内で date に対応する四半期を返します。

mysql> SELECT QUARTER('2008-04-01');
        -> 2

SECOND(time)

0 から 59 までの範囲内で、time に対応する秒数を返します。

mysql> SELECT SECOND('10:05:03');
        -> 3

SEC_TO_TIME(seconds)

TIME 値として、時、分、秒に変換された seconds 引数を返します。 結果の範囲は、TIME データ型の範囲に制約されます。 引数がその範囲外の値に対応している場合は、警告が発行されます。

mysql> SELECT SEC_TO_TIME(2378);
        -> '00:39:38'
mysql> SELECT SEC_TO_TIME(2378) + 0;
        -> 3938

STR_TO_DATE(str,format)

これは DATE_FORMAT() 関数の逆です。 文字列 str と書式文字列 format が指定されます。 STR_TO_DATE() は、書式文字列に日付と時間の両方の部分が含まれる場合は DATETIME 値を返し、文字列に日付と時間の部分の一方のみが含まれる場合は DATE または TIME 値を返します。 str から抽出された日付値、時間値、または日付時間値が不正な場合は、STR_TO_DATE() によって NULL が返され、警告が発行されます。

サーバーは str をスキャンすることで、format の一致を試みます。 書式文字列には、リテラル文字と % で始まる書式指定子を含めることができます。 format 内のリテラル文字は、str 内と完全に一致する必要があります。 format 内の書式指定子は、str 内の日付または時間の部分に一致する必要があります。 format で使用できる指定子については、DATE_FORMAT() 関数の説明を参照してください。

mysql> SELECT STR_TO_DATE('01,5,2013','%d,%m,%Y');
        -> '2013-05-01'
mysql> SELECT STR_TO_DATE('May 1, 2013','%M %d,%Y');
        -> '2013-05-01'

str の先頭からスキャンが開始され、一致しない format が見つかった場合は失敗します。 str の末尾にある余分な文字は、無視されます。

mysql> SELECT STR_TO_DATE('a09:30:17','a%h:%i:%s');
        -> '09:30:17'
mysql> SELECT STR_TO_DATE('a09:30:17','%h:%i:%s');
        -> NULL
mysql> SELECT STR_TO_DATE('09:30:17a','%h:%i:%s');
        -> '09:30:17'

指定されていない日付または時間の部分の値は 0 になるため、str に指定された値が不完全な場合は、結果の一部または全部が 0 に設定されます。

mysql> SELECT STR_TO_DATE('abc','abc');
        -> '0000-00-00'
mysql> SELECT STR_TO_DATE('9','%m');
        -> '0000-09-00'
mysql> SELECT STR_TO_DATE('9','%s');
        -> '00:00:09'

日付値の部分をチェックする範囲は、セクション11.2.2「DATE、DATETIME、および TIMESTAMP 型」の説明どおりです。 たとえば、「ゼロ」の日付または部分値が 0 の日付は、このような値が許可されないように SQL モードが設定されていなければ、許可されます。

mysql> SELECT STR_TO_DATE('00/00/0000', '%m/%d/%Y');
        -> '0000-00-00'
mysql> SELECT STR_TO_DATE('04/31/2004', '%m/%d/%Y');
        -> '2004-04-31'

NO_ZERO_DATE SQL モードが有効な場合、ゼロの日付は許可されません。 その場合、STR_TO_DATE() は NULL を返し、警告を生成します:

mysql> SET sql_mode = '';
mysql> SELECT STR_TO_DATE('00/00/0000', '%m/%d/%Y');
+---------------------------------------+
| STR_TO_DATE('00/00/0000', '%m/%d/%Y') |
+---------------------------------------+
| 0000-00-00                            |
+---------------------------------------+
mysql> SET sql_mode = 'NO_ZERO_DATE';
mysql> SELECT STR_TO_DATE('00/00/0000', '%m/%d/%Y');
+---------------------------------------+
| STR_TO_DATE('00/00/0000', '%m/%d/%Y') |
+---------------------------------------+
| NULL                                  |
+---------------------------------------+
mysql> SHOW WARNINGS\G
*************************** 1. row ***************************
  Level: Warning
   Code: 1411
Message: Incorrect datetime value: '00/00/0000' for function str_to_date

mysql> SELECT STR_TO_DATE('200442 Monday', '%X%V %W');
        -> '2004-10-18'

SUBDATE(date,INTERVAL expr unit), SUBDATE(expr,days)

INTERVAL 形式で 2 番目の引数を付けて呼び出されると、SUBDATE() は DATE_SUB() のシノニムになります。 INTERVAL unit 引数については、DATE_ADD() の説明を参照してください。

mysql> SELECT DATE_SUB('2008-01-02', INTERVAL 31 DAY);
        -> '2007-12-02'
mysql> SELECT SUBDATE('2008-01-02', INTERVAL 31 DAY);
        -> '2007-12-02'

2 番目の形式では、days の整数値を使用できます。 このような場合は、日付または日付時間式 expr から日数が減算されると解釈されます。

mysql> SELECT SUBDATE('2008-01-02 12:00:00', 31);
        -> '2007-12-02 12:00:00'

SUBTIME(expr1,expr2)

SUBTIME() は、expr1 と同じ書式で表現される expr1 と expr2 を返します。expr1 は時間または日付時間式であり、expr2 は時間式です。

mysql> SELECT SUBTIME('2007-12-31 23:59:59.999999','1 1:1:1.000002');
        -> '2007-12-30 22:58:58.999997'
mysql> SELECT SUBTIME('01:00:00.999999', '02:00:00.999998');
        -> '-00:59:59.999999'

SYSDATE([fsp])

関数が文字列または数値のどちらのコンテキストで使用されているかに応じて、現在の日時を'YYYY-MM-DD hh:mm:ss'または YYYYMMDDhhmmss 形式の値として返します。

0 から 6 までの小数秒精度を指定するために fsp 引数が指定されている場合、戻り値にはその桁数の小数秒部分が含まれます。

SYSDATE() は、実行された時間を返します。 これは、ステートメントが実行を開始する時間を示す定数時間を返す NOW() の動作とは異なります。 (ストアドファンクションまたはトリガーでは、NOW() は関数またはトリガーステートメントが実行を開始する時間を返します。)

mysql> SELECT NOW(), SLEEP(2), NOW();
+---------------------+----------+---------------------+
| NOW()               | SLEEP(2) | NOW()               |
+---------------------+----------+---------------------+
| 2006-04-12 13:47:36 |        0 | 2006-04-12 13:47:36 |
+---------------------+----------+---------------------+

mysql> SELECT SYSDATE(), SLEEP(2), SYSDATE();
+---------------------+----------+---------------------+
| SYSDATE()           | SLEEP(2) | SYSDATE()           |
+---------------------+----------+---------------------+
| 2006-04-12 13:47:44 |        0 | 2006-04-12 13:47:46 |
+---------------------+----------+---------------------+

さらに、SET TIMESTAMP ステートメントによって、NOW() で返された値は影響を受けますが、SYSDATE() で返された値は影響を受けません。 つまり、バイナリログのタイムスタンプ設定は、SYSDATE() の呼び出しに影響しないことを意味します。

SYSDATE() は、同じステートメント内でもさまざまな値を返すことができ、SET TIMESTAMP による影響も受けないため、非決定的です。そのため、ステートメントベースのバイナリロギングが使用されている場合は、レプリケーションで安全に使用できません。 これが問題となる場合は、行ベースのロギングを使用できます。

また、--sysdate-is-now オプションを使用すると、SYSDATE() を NOW() のエイリアスにすることができます。 これは、レプリケーションソースサーバーとレプリカの両方でこのオプションが使用されている場合に機能します。

SYSDATE() に非決定的な特性があるということは、それを参照する式を評価する際にインデックスを使用できないことも意味します。

TIME(expr)

時間または日付時間式 expr の時部分を抽出し、文字列として返します。

この関数は、ステートメントベースのレプリケーションでは安全に使用できません。 binlog_format が STATEMENT に設定されているときに、この関数を使用すると、警告のログが記録されます。

mysql> SELECT TIME('2003-12-31 01:02:03');
        -> '01:02:03'
mysql> SELECT TIME('2003-12-31 01:02:03.000123');
        -> '01:02:03.000123'

TIMEDIFF(expr1,expr2)

TIMEDIFF() は、時間値として表現された expr1 − expr2 を返します。expr1 および expr2 は時間または日付時間式ですが、両方とも同じ型にする必要があります。

TIMEDIFF() で返される結果は、TIME 値で許可される範囲に制限されています。 また、TIMESTAMPDIFF() および UNIX_TIMESTAMP() 関数のいずれかを使用することもできます。両方とも整数を返します。

mysql> SELECT TIMEDIFF('2000:01:01 00:00:00',
    ->                 '2000:01:01 00:00:00.000001');
        -> '-00:00:00.000001'
mysql> SELECT TIMEDIFF('2008-12-31 23:59:59.000001',
    ->                 '2008-12-30 01:01:01.000002');
        -> '46:58:57.999999'

TIMESTAMP(expr), TIMESTAMP(expr1,expr2)

引数を 1 つ付けると、この関数は日付または日付時間式 expr を日付時間値として返します。 引数を 2 つ付けると、時間式 expr2 を日付または日付時間式 expr1 に加算し、その結果を日付時間値として返します。

mysql> SELECT TIMESTAMP('2003-12-31');
        -> '2003-12-31 00:00:00'
mysql> SELECT TIMESTAMP('2003-12-31 12:00:00','12:00:00');
        -> '2004-01-01 00:00:00'

TIMESTAMPADD(unit,interval,datetime_expr)

整数式 interval を日付または日付時間式 datetime_expr に加算します。 interval の単位は、unit 引数で指定されます。この引数は、MICROSECOND (マイクロ秒)、SECOND、MINUTE、HOUR、DAY、WEEK、MONTH、QUARTER、YEAR 値のいずれかにする必要があります。

unit 値を指定するには、ここで示したキーワードのいずれかを使用するか、SQL_TSI_ をプリフィクスとして付けます。 たとえば、DAY と SQL_TSI_DAY は両方とも有効です。

mysql> SELECT TIMESTAMPADD(MINUTE,1,'2003-01-02');
        -> '2003-01-02 00:01:00'
mysql> SELECT TIMESTAMPADD(WEEK,1,'2003-01-02');
        -> '2003-01-09'

TIMESTAMPDIFF(unit,datetime_expr1,datetime_expr2)

datetime_expr2 − datetime_expr1 を返します。datetime_expr1 と datetime_expr2 は、日付または日付時間式です。 式の一方が日付で、他方が日付時間にすることもできます。日付値は、必要に応じて時間部分が '00:00:00' の日付時間として処理されます。 結果 (整数) の単位は、unit 引数で指定されます。 unit の有効な値は、TIMESTAMPADD() 関数の説明で一覧表示された値と同じです。

mysql> SELECT TIMESTAMPDIFF(MONTH,'2003-02-01','2003-05-01');
        -> 3
mysql> SELECT TIMESTAMPDIFF(YEAR,'2002-05-01','2001-01-01');
        -> -1
mysql> SELECT TIMESTAMPDIFF(MINUTE,'2003-02-01','2003-05-01 12:05:55');
        -> 128885

TIME_FORMAT(time,format)

これは DATE_FORMAT() 関数と同様に使用されますが、format 文字列には時間、分、秒、マイクロ秒の書式指定子のみを含めることができます。 その他の指定子では、NULL 値または 0 が生成されます。

time 値に 23 よりも大きな時間部分が含まれる場合は、%H および %k 時間書式指定子によって、0..23 の通常の範囲よりも大きな値が生成されます。 その他の時間書式指定子では、時間値モジュロ 12 が生成されます。

mysql> SELECT TIME_FORMAT('100:00:00', '%H %k %h %I %l');
        -> '100 100 04 04 4'

TIME_TO_SEC(time)

秒に変換された time 引数を返します。

mysql> SELECT TIME_TO_SEC('22:23:00');
        -> 80580
mysql> SELECT TIME_TO_SEC('00:39:38');
        -> 2378

TO_DAYS(date)

日付 date が指定され、日数 (0 年以降の日数) を返します。

mysql> SELECT TO_DAYS(950501);
        -> 728779
mysql> SELECT TO_DAYS('2007-10-07');
        -> 733321

TO_DAYS() は、カレンダーが変更された際に失われた日が考慮されないため、グレゴリオ暦 (1582) の出現よりも前の値とともに使用するために設計されていません。 日付が 1582 よりも前の場合は (ほかのロケールでは、さらにあとの年になる可能性があります)、この関数の結果は信頼できません。 詳細は、セクション12.9「MySQL で使用されるカレンダー」,を参照してください。

MySQL では セクション11.2「日時データ型」 のルールを使用して、日付の 2 桁の年の値が 4 桁の形式に変換されることを忘れないでください。 たとえば、'2008-10-07' と '08-10-07' は同じ日付と認識されます。

mysql> SELECT TO_DAYS('2008-10-07'), TO_DAYS('08-10-07');
        -> 733687, 733687

MySQL では、ゼロの日付は '0000-00-00' として定義されます。ただし、このデータ自体は無効とみなされます。 つまり、'0000-00-00' および '0000-01-01' の場合、TO_DAYS() は次に示す値を返します。

mysql> SELECT TO_DAYS('0000-00-00');
+-----------------------+
| to_days('0000-00-00') |
+-----------------------+
|                  NULL |
+-----------------------+
1 row in set, 1 warning (0.00 sec)

mysql> SHOW WARNINGS;
+---------+------+----------------------------------------+
| Level   | Code | Message                                |
+---------+------+----------------------------------------+
| Warning | 1292 | Incorrect datetime value: '0000-00-00' |
+---------+------+----------------------------------------+
1 row in set (0.00 sec)


mysql> SELECT TO_DAYS('0000-01-01');
+-----------------------+
| to_days('0000-01-01') |
+-----------------------+
|                     1 |
+-----------------------+
1 row in set (0.00 sec)

このことは、ALLOW_INVALID_DATES SQL サーバーモードが有効であるかどうかに関係なく当てはまります。

TO_SECONDS(expr)

日付または日時 expr を指定すると、0 年以降の秒数を戻します。 expr が有効な日付または日付時間の値ではない場合は、NULL を返します。

mysql> SELECT TO_SECONDS(950501);
        -> 62966505600
mysql> SELECT TO_SECONDS('2009-11-29');
        -> 63426672000
mysql> SELECT TO_SECONDS('2009-11-29 13:43:32');
        -> 63426721412
mysql> SELECT TO_SECONDS( NOW() );
        -> 63426721458

TO_DAYS() と同様に、TO_SECONDS() は、カレンダーが変更された際に失われた日が考慮されないため、グレゴリオ暦 (1582) の出現よりも前の値とともに使用する目的で設計されていません。 日付が 1582 よりも前の場合は (ほかのロケールでは、さらにあとの年になる可能性があります)、この関数の結果は信頼できません。 詳細は、セクション12.9「MySQL で使用されるカレンダー」,を参照してください。

TO_DAYS() と同様に、TO_SECONDS() は セクション11.2「日時データ型」 のルールを使用して日付の 2 桁の年の値を 4 桁の形式に変換します。

MySQL では、ゼロの日付は '0000-00-00' として定義されます。ただし、このデータ自体は無効とみなされます。 つまり、'0000-00-00' および '0000-01-01' の場合、TO_SECONDS() は次に示す値を返します。

mysql> SELECT TO_SECONDS('0000-00-00');
+--------------------------+
| TO_SECONDS('0000-00-00') |
+--------------------------+
|                     NULL |
+--------------------------+
1 row in set, 1 warning (0.00 sec)

mysql> SHOW WARNINGS;
+---------+------+----------------------------------------+
| Level   | Code | Message                                |
+---------+------+----------------------------------------+
| Warning | 1292 | Incorrect datetime value: '0000-00-00' |
+---------+------+----------------------------------------+
1 row in set (0.00 sec)


mysql> SELECT TO_SECONDS('0000-01-01');
+--------------------------+
| TO_SECONDS('0000-01-01') |
+--------------------------+
|                    86400 |
+--------------------------+
1 row in set (0.00 sec)

このことは、ALLOW_INVALID_DATES SQL サーバーモードが有効であるかどうかに関係なく当てはまります。

UNIX_TIMESTAMP([date])

date 引数を指定せずに UNIX_TIMESTAMP() をコールすると、'1970-01-01 00:00:00' UTC 以降の秒数を表す Unix タイムスタンプが返されます。

date 引数を指定して UNIX_TIMESTAMP() をコールすると、'1970-01-01 00:00:00' UTC 以降の秒数として引数の値が返されます。 サーバーは、date をセッションタイムゾーンの値として解釈し、UTC の内部 Unix タイムスタンプ値に変換します。 (クライアントは、セクション5.1.15「MySQL Server でのタイムゾーンのサポート」 の説明に従ってセッションタイムゾーンを設定できます。) date 引数には、DATE、DATETIME または TIMESTAMP 文字列、YYMMDD, YYMMDDhhmmss, YYYYMMDD の数値または YYYYMMDDhhmmss 形式を指定できます。 引数に時間部分が含まれている場合、オプションで小数秒部分を含めることができます。

戻り値は、引数が指定されていない場合、または引数に小数秒部分が含まれていない場合は整数、小数秒部分を含む引数が指定されている場合は DECIMAL です。

date 引数が TIMESTAMP カラムの場合、UNIX_TIMESTAMP() は内部タイムスタンプ値を直接返し、「string-to-Unix-timestamp」 の暗黙的な変換は行いません。

引数値の有効範囲は、TIMESTAMP データ型の場合と同じです: '1970-01-01 00:00:01.000000' UTC から'2038-01-19 03:14:07.999999' UTC。 UNIX_TIMESTAMP() に範囲外の日付を渡すと、0 が返されます。

mysql> SELECT UNIX_TIMESTAMP();
        -> 1447431666
mysql> SELECT UNIX_TIMESTAMP('2015-11-13 10:20:19');
        -> 1447431619
mysql> SELECT UNIX_TIMESTAMP('2015-11-13 10:20:19.012');
        -> 1447431619.012

UNIX_TIMESTAMP() および FROM_UNIXTIME() を使用して UTC 以外のタイムゾーンの値と Unix タイムスタンプ値の間で変換する場合、マッピングは双方向では一対一ではないため、変換は失われます。 たとえば、夏時間 (DST) などのローカルタイムゾーンの変更の規則により、UNIX_TIMESTAMP() では UTC 以外のタイムゾーンで区別される 2 つの値を同じ Unix タイムスタンプ値にマップできます。 FROM_UNIXTIME() では、その値は元の値のいずれかにのみマップされます。 次に、MET タイムゾーンで区別される値を使用する例を示します:

mysql> SET time_zone = 'MET';
mysql> SELECT UNIX_TIMESTAMP('2005-03-27 03:00:00');
+---------------------------------------+
| UNIX_TIMESTAMP('2005-03-27 03:00:00') |
+---------------------------------------+
|                            1111885200 |
+---------------------------------------+
mysql> SELECT UNIX_TIMESTAMP('2005-03-27 02:00:00');
+---------------------------------------+
| UNIX_TIMESTAMP('2005-03-27 02:00:00') |
+---------------------------------------+
|                            1111885200 |
+---------------------------------------+
mysql> SELECT FROM_UNIXTIME(1111885200);
+---------------------------+
| FROM_UNIXTIME(1111885200) |
+---------------------------+
| 2005-03-27 03:00:00       |
+---------------------------+

UNIX_TIMESTAMP() カラムを減算する場合は、符号付き整数にキャストできます。 セクション12.11「キャスト関数と演算子」を参照してください。

UTC_DATE, UTC_DATE()

関数が文字列または数値のどちらのコンテキストで使用されているかに応じて、現在の UTC 日付を'YYYY-MM-DD'または YYYYMMDD 形式の値として返します。

mysql> SELECT UTC_DATE(), UTC_DATE() + 0;
        -> '2003-08-14', 20030814

UTC_TIME, UTC_TIME([fsp])

関数が文字列または数値のどちらのコンテキストで使用されているかに応じて、現在の UTC 時間を'hh:mm:ss'または hhmmss 形式の値として返します。

0 から 6 までの小数秒精度を指定するために fsp 引数が指定されている場合、戻り値にはその桁数の小数秒部分が含まれます。

mysql> SELECT UTC_TIME(), UTC_TIME() + 0;
        -> '18:07:53', 180753.000000

UTC_TIMESTAMP, UTC_TIMESTAMP([fsp])

関数が文字列または数値のどちらのコンテキストで使用されているかに応じて、現在の UTC 日時を'YYYY-MM-DD hh:mm:ss'または YYYYMMDDhhmmss 形式の値として返します。

0 から 6 までの小数秒精度を指定するために fsp 引数が指定されている場合、戻り値にはその桁数の小数秒部分が含まれます。

mysql> SELECT UTC_TIMESTAMP(), UTC_TIMESTAMP() + 0;
        -> '2003-08-14 18:08:04', 20030814180804.000000

WEEK(date[,mode])

この関数は、date に対応する週番号を返します。 2 つの引数を取る形式の WEEK() を使用すると、週が日曜日と月曜日のどちらから始まるのか、および戻り値が 0 から 53までと 1 から 53 までのどちらの範囲内であるのかを指定できます。 mode 引数が省略された場合は、default_week_format システム変数の値が使用されます。 セクション5.1.8「サーバーシステム変数」を参照してください。

次の表では、mode 引数がどのように機能するのかについて説明します。

「本年の 4 日以上を含む」という意味を持つ mode 値では、ISO 8601:1988 に従って週番が付けられます。

mysql> SELECT WEEK('2008-02-20');
        -> 7
mysql> SELECT WEEK('2008-02-20',0);
        -> 7
mysql> SELECT WEEK('2008-02-20',1);
        -> 8
mysql> SELECT WEEK('2008-12-31',1);
        -> 53

日付が前年の最終週に入っている場合は、オプションの mode 引数として2、3、6、または 7 を使用しなければ、MySQL によって 0 が返されます。

mysql> SELECT YEAR('2000-01-01'), WEEK('2000-01-01',0);
        -> 2000, 0

指定された日付は実際には 1999 年の第 52 週に発生するため、WEEK() は 52 を返す必要があると議論されることもあります。 代わりに WEEK() は、戻り値が「指定された年の週番号」となるように 0 を返します。 これにより、日付から日付部分を抽出するその他の関数と組み合わせると、WEEK() 関数を信頼して使用できるようになります。

指定された日付に対応する週の 1 日目を含む年について評価された結果を優先する場合は、オプションの mode 引数として 0、2、5、または 7 を使用します。

mysql> SELECT WEEK('2000-01-01',2);
        -> 52

または、YEARWEEK() 関数を使用します。

mysql> SELECT YEARWEEK('2000-01-01');
        -> 199952
mysql> SELECT MID(YEARWEEK('2000-01-01'),5,2);
        -> '52'

WEEKDAY(date)

date に対応する曜日インデックス (0 = Monday、1 = Tuesday、…6 = Sunday) を返します。

mysql> SELECT WEEKDAY('2008-02-03 22:23:00');
        -> 6
mysql> SELECT WEEKDAY('2007-11-06');
        -> 1

WEEKOFYEAR(date)

1 から 53 までの範囲内で、日付の暦週を返します。 WEEKOFYEAR() は WEEK(date,3) に同等の互換性のある関数です。

mysql> SELECT WEEKOFYEAR('2008-02-20');
        -> 8

YEAR(date)

1000 から 9999 までの範囲内で、date に対応する年を返します。日付が「ゼロ」の場合は、0 を返します。

mysql> SELECT YEAR('1987-01-01');
        -> 1987

YEARWEEK(date), YEARWEEK(date,mode)

日付に対応する年と週を返します。 結果の年と日付引数の年では、その年の最初と最後の週が異なる可能性があります。

mode 引数は、WEEK() への mode 引数とまったく同様に機能します。 単一引数構文では、mode 値 0 が使用されます。 WEEK() とは異なり、default_week_format の値は YEARWEEK() に影響しません。

mysql> SELECT YEARWEEK('1987-01-01');
        -> 198652

WEEK() はその後、指定された年のコンテキストで週を返すため、週番号はオプションの引数 0 または 1 を付けた場合に WEEK() 関数で返される数字 (0) とは異なります。