這裡是個使用日期函數的例子。下面的查詢選擇所有 date_col 值在最後 30 天内的記錄。
SELECT something FROM tbl_name WHERE TO_DAYS(NOW()) - TO_DAYS(date_col) <= 30;
DAYOFWEEK(date)
傳回 date 的星期索引(1 = Sunday, 2 = Monday, … 7 = Saturday)。索引值符合 ODBC 的标準。
SELECT DAYOFWEEK(’1998-02-03’);
3
WEEKDAY(date)傳回 date 的星期索引(0 = Monday, 1 = Tuesday, … 6 = Sunday):
mysql> SELECT WEEKDAY(’1998-02-03 22:23:00’);
-> 1
mysql> SELECT WEEKDAY(’1997-11-05’);
-> 2
DAYOFMONTH(date)傳回 date 是一月中的第幾天,範圍為 1 到 31:
mysql> SELECT DAYOFMONTH(’1998-02-03’);
-> 3
DAYOFYEAR(date)傳回 date 是一年中的第幾天,範圍為 1 到 366:
mysql> SELECT DAYOFYEAR(’1998-02-03’);
-> 34
MONTH(date)傳回 date 中的月份,範圍為 1 到 12:
mysql> SELECT MONTH(’1998-02-03’);
-> 2
DAYNAME(date)傳回 date 的星期名:
mysql> SELECT DAYNAME("1998-02-05");
-> ’Thursday’
MONTHNAME(date)傳回 date 的月份名:
mysql> SELECT MONTHNAME("1998-02-05");
-> ’February’
QUARTER(date)傳回 date 在一年中的季度,範圍為 1 到 4:
mysql> SELECT QUARTER(’98-04-01’);
2 -> 2
WEEK(date)WEEK(date,first)對于星期日是一周中的第一天的場合,如果函數隻有一個參數調用,傳回 date 為一年的第幾周,傳回值範圍為 0 到 53 (是的,可能有第 53 周的開始)。兩個參數形式的 WEEK() 允許你指定一周是否以星期日或星期一開始,及傳回值為 0-53 還是 1-52。 這裡的一個表顯示第二個參數是怎麼工作的:
值 含義
0 一周以星期日開始,傳回值範圍為 0-53
1 一周以星期一開始,傳回值範圍為 0-53
2 一周以星期日開始,傳回值範圍為 1-53
3 一周以星期一開始,傳回值範圍為 1-53 (ISO 8601)
mysql> SELECT WEEK(’1998-02-20’);
-> 7
mysql> SELECT WEEK(’1998-02-20’,0);
-> 7
mysql> SELECT WEEK(’1998-02-20’,1);
-> 8
mysql> SELECT WEEK(’1998-12-31’,1);
-> 53
注意,在版本 4.0 中,WEEK(#,0) 被更改為比對 USA 曆法。 注意,如果一周是上一年的最後一周,當你沒有使用 2 或 3 做為可選參數時,MySQL 将傳回 0:
mysql> SELECT YEAR(’2000-01-01’), WEEK(’2000-01-01’,0);
-> 2000, 0
mysql> SELECT WEEK(’2000-01-01’,2);
-> 52
你可能會争辯說,當給定的日期值實際上是 1999 年的第 52 周的一部分時,MySQL 對 WEEK() 函數應該傳回 52。我們決定傳回 0 ,是因為我們希望該函數傳回“在指定年份中是第幾周”。當和其他的提取日期值中的月日值的函數結合使用時,這使得 WEEK() 函數的用法可靠。 如果你更希望能得到恰當的年-周值,那麼你應該使用參數 2 或 3 做為可選參數,或使用函數 YEARWEEK() :
mysql> SELECT YEARWEEK(’2000-01-01’);
-> 199952
mysql> SELECT MID(YEARWEEK(’2000-01-01’),5,2);
-> 52
YEAR(date)傳回 date 的年份,範圍為 1000 到 9999:
mysql> SELECT YEAR(’98-02-03’);
-> 1998
YEARWEEK(date)YEARWEEK(date,first)傳回一個日期值是的哪一年的哪一周。第二個參數的形式和作用完全和 WEEK() 的第二個參數一緻。注意,對于給定的日期參數是一年的第一周或最後一周的,傳回的年份值可能和日期參數給出的年份不一緻:
mysql> SELECT YEARWEEK(’1987-01-01’);
-> 198653
注意,對于可選參數 0 或 1,周值的傳回值不同于 WEEK() 函數所傳回值(0), WEEK() 根據給定的年語境傳回周值。
HOUR(time)傳回 time 的小時值,範圍為 0 到 23:
mysql> SELECT HOUR(’10:05:03’);
-> 10
MINUTE(time)傳回 time 的分鐘值,範圍為 0 到 59:
mysql> SELECT MINUTE(’98-02-03 10:05:03’);
-> 5
SECOND(time)傳回 time 的秒值,範圍為 0 到 59:
mysql> SELECT SECOND(’10:05:03’);
-> 3
PERIOD_ADD(P,N)增加 N 個月到時期 P(格式為 YYMM 或 YYYYMM)中。以 YYYYMM 格式傳回值。 注意,期間參數 P 不是 一個日期值:
mysql> SELECT PERIOD_ADD(9801,2);
-> 199803
PERIOD_DIFF(P1,P2)傳回時期 P1 和 P2 之間的月數。P1 和 P2 應該以 YYMM 或 YYYYMM 指定。 注意,時期參數 P1 和 P2 不是 日期值:
mysql> SELECT PERIOD_DIFF(9802,199703);
-> 11
DATE_ADD(date,INTERVAL expr type)DATE_SUB(date,INTERVAL expr type)ADDDATE(date,INTERVAL expr type)SUBDATE(date,INTERVAL expr type)這些函數執行日期的算術運算。ADDDATE() 和 SUBDATE() 分别是 DATE_ADD() 和 DATE_SUB() 的同義詞。 在 MySQL 3.23 中,如果表達式的右邊是個日期值或一個日期時間型字段,你能使用 + 和 - 代替 DATE_ADD() 和 DATE_SUB()(示例如下)。 參數 date 是個 DATETIME 或DATE 值,指定一個日期的開始。expr 是個表達式,指定從開始日期上增加還是減去間隔值。expr 是個字元串;他能以一個 “-” 領頭表示一個負的間隔值。type 是個關鍵詞,他标志着表達式以何格式被解釋。 下表顯示 type 和 expr 參數是怎麼關聯的:
type 值 expr 期望的格式
SECOND SECONDS
MINUTE MINUTES
HOUR HOURS
DAY DAYS
MONTH MONTHS
YEAR YEARS
MINUTE_SECOND “MINUTES:SECONDS”
HOUR_MINUTE “HOURS:MINUTES”
DAY_HOUR “DAYS HOURS”
YEAR_MONTH “YEARS-MONTHS”
HOUR_SECOND “HOURS:MINUTES:SECONDS”
DAY_MINUTE “DAYS HOURS:MINUTES”
DAY_SECOND “DAYS HOURS:MINUTES:SECONDS”
在 expr 的格式中,MySQL 允許所有字元作為定界符。表中所顯示的是建議的定界字元。如果 date 參數是個 DATE 值,并且計算的間隔僅僅有YEAR、MONTH 和 DAY 部分(沒有時間部分),那麼傳回值也是個 DATE 值。否則傳回值是個 DATETIME 值:
mysql> SELECT "1997-12-31 23:59:59" + INTERVAL 1 SECOND;
-> 1998-01-01 00:00:00
mysql> SELECT INTERVAL 1 DAY + "1997-12-31";
-> 1998-01-01
mysql> SELECT "1998-01-01" - INTERVAL 1 SECOND;
-> 1997-12-31 23:59:59
mysql> SELECT DATE_ADD("1997-12-31 23:59:59",
-> INTERVAL 1 SECOND);
-> 1998-01-01 00:00:00
mysql> SELECT DATE_ADD("1997-12-31 23:59:59",
-> INTERVAL 1 DAY);
-> 1998-01-01 23:59:59
mysql> SELECT DATE_ADD("1997-12-31 23:59:59",
-> INTERVAL "1:1" MINUTE_SECOND);
-> 1998-01-01 00:01:00
mysql> SELECT DATE_SUB("1998-01-01 00:00:00",
-> INTERVAL "1 1:1:1" DAY_SECOND);
-> 1997-12-30 22:58:59
mysql> SELECT DATE_ADD("1998-01-01 00:00:00",
-> INTERVAL "-1 10" DAY_HOUR);
-> 1997-12-30 14:00:00
mysql> SELECT DATE_SUB("1998-01-02", INTERVAL 31 DAY);
-> 1997-12-02
如果你指定了一個太短的間隔值(沒有包括 type 關鍵詞所期望的所有間隔部分),MySQL 假設你遺漏了間隔值的最左邊部分。例如,如果指定一個 type 為 DAY_SECOND,那麼 expr 值被期望包含天、小時、分鐘和秒部分。如果你象 “1:10″ 樣指定一個值,MySQL 假設天和小時部分被遺漏了,指定的值代表分鐘和秒。換句話說,“1:10″ DAY_SECOND 被解釋為等價于 “1:10″ MINUTE_SECOND。這類似于 MySQL 解釋 TIME 值為經過的時間而不是一天的時刻。 注意,如果依着包含一個時間部分的間隔增加或減少一個日期值,該日期值将被自動地轉換到一個日期時間值:
mysql> SELECT DATE_ADD("1999-01-01", INTERVAL 1 DAY);
-> 1999-01-02
mysql> SELECT DATE_ADD("1999-01-01", INTERVAL 1 HOUR);
-> 1999-01-01 01:00:00
如果你使用了确定不正确的日期,傳回結果将是 NULL。如果你增加 MONTH、YEAR_MONTH 或 YEAR,并且結果日期的天比新月份的最大天數還大,那麼他将被調整到新月份的最大天數:
mysql> SELECT DATE_ADD(’1998-01-30’, INTERVAL 1 MONTH);
-> 1998-02-28
注意,上面的例子中,單詞 INTERVAL 和關鍵詞 type 是不區分字母大小寫的。
EXTRACT(type FROM date)EXTRACT() 函數使用和 DATE_ADD() 或 DATE_SUB() 一緻的間隔類型,不過他用于指定從日期中提取的部分,而不是進行日期算術運算。
mysql> SELECT EXTRACT(YEAR FROM "1999-07-02");
-> 1999
mysql> SELECT EXTRACT(YEAR_MONTH FROM "1999-07-02 01:02:03");
-> 199907
mysql> SELECT EXTRACT(DAY_MINUTE FROM "1999-07-02 01:02:03");
-> 20102
TO_DAYS(date)給出一個日期 date,傳回一個天數(從 0 年開始的天數):
mysql> SELECT TO_DAYS(950501);
-> 728779
mysql> SELECT TO_DAYS(’1997-10-07’);
-> 729669
TO_DAYS() 無意于使用先于格裡高裡曆法(即現行的陽曆)(1582)出現的值,因為他不考慮當曆法改動時所遺失的天數。
FROM_DAYS(N)給出一個天數 N,傳回一個 DATE 值:
mysql> SELECT FROM_DAYS(729669);
-> ’1997-10-07’
FROM_DAYS() 無意于使用先于格裡高裡曆法(1582)出現的值,因為他不考慮當曆法改動時所遺失的天數。
DATE_FORMAT(date,format)依照 format 字元串格式化 date 值。下面的修飾符可被用于 format 字元串中:
下列修飾符可以被用在format字元串中: %M 月名字(January……December)
%W 星期名字(Sunday……Saturday)
%D 有英語字首的月份的日期(1st, 2nd, 3rd, 等等。)
%Y 年, 數字, 4 位
%y 年, 數字, 2 位
%a 縮寫的星期名字(Sun……Sat)
%d 月份中的天數, 數字(00……31)
%e 月份中的天數, 數字(0……31)
%m 月, 數字(01……12)
%c 月, 數字(1……12)
%b 縮寫的月份名字(Jan……Dec)
%j 一年中的天數(001……366)
%H 小時(00……23)
%k 小時(0……23)
%h 小時(01……12)
%I 小時(01……12)
%l 小時(1……12)
%i 分鐘, 數字(00……59)
%r 時間,12 小時(hh:mm:ss [AP]M)
%T 時間,24 小時(hh:mm:ss)
%S 秒(00……59)
%s 秒(00……59)
%p AM或PM
%w 一個星期中的天數(0=Sunday ……6=Saturday )
%U 星期(0……52), 這裡星期天是星期的第一天
%u 星期(0……52), 這裡星期一是星期的第一天
%% 一個文字“%”。
修飾符 含義
%M 月的名字 (January..December)
%W 星期的名字 (Sunday..Saturday)
%D 有英文字尾的某月的第幾天 (0th, 1st, 2nd, 3rd, etc.)
%Y 年份,數字的,4 位
%y 年份,數字的,2 位
%X 周值的年份,星期日是個星期的第一天,數字的,4 位,和 ’%V’ 一同使用
%x 周值的年份,星期一是個星期的第一天,數字的,4 位,和 ’%v’ 一同使用
%a 縮寫的星期名 (Sun..Sat)
%d 月份中的天數,數字的 (00..31)
%e 月份中的天數,數字的 (0..31)
%m 月,數字的 (00..12)
%c 月,數字的 (0..12)
%b 縮寫的月份名 (Jan..Dec)
%j 一年中的天數 (001..366)
%H 小時 (00..23)
%k 小時 (0..23)
%h 小時 (01..12)
%I 小時 (01..12)
%l 小時 (1..12)
%i 分鐘,數字的 (00..59)
%r 時間,12 小時 (hh:mm:ss [AP]M)
%T 時間,24 小時 (hh:mm:ss)
%S 秒 (00..59)
%s 秒 (00..59)
%p AM 或 PM
%w 一周中的天數 (0=Sunday..6=Saturday)
%U 星期 (00..53),星期日是個星期的第一天
%u 星期 (00..53),星期一是個星期的第一天
%V 星期 (01..53),星期日是個星期的第一天。和 ’%X’ 一起使用
%v 星期 (01..53),星期一是個星期的第一天。和 ’%x’ 一起使用
%% 一個字母 “%”
所有其他的字元不經過解釋,直接複制到結果中:
mysql> SELECT DATE_FORMAT(’1997-10-04 22:23:00’, ’%W %M %Y’);
-> ’Saturday October 1997’
mysql> SELECT DATE_FORMAT(’1997-10-04 22:23:00’, ’%H:%i:%s’);
-> ’22:23:00’
mysql> SELECT DATE_FORMAT(’1997-10-04 22:23:00’,
’%D %y %a %d %m %b %j’);
-> ’4th 97 Sat 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 3.23 中,在格式修飾符前需要字元 `%’。在更早的 MySQL 版本中,`%’ 是可選的。 月份和天修飾符的範圍從零開始的原因是,在 MySQL 3.23 中,他允許存儲不完善的日期值(例如 ’2004-00-00’)。
TIME_FORMAT(time,format)他的使用方法和上面的 DATE_FORMAT() 函數相似,不過 format 字元串隻包含處理小時、分和秒的那些格式修飾符。使用其他的修飾符會産生一個 NULL 值或 0。CURDATE()CURRENT_DATE以 ’YYYY-MM-DD’ 或 YYYYMMDD 格式傳回目前的日期值,傳回的格式取決于該函數是用于字元串還是數字語境中:
mysql> SELECT CURDATE();
-> ’1997-12-15’
mysql> SELECT CURDATE() + 0;
-> 19971215
CURTIME()CURRENT_TIME以 ’HH:MM:SS’ 或 HHMMSS 格式傳回目前的時間值,傳回的格式取決于該函數是用于字元串還是數字語境中:
mysql> SELECT CURTIME();
-> ’23:50:26’
mysql> SELECT CURTIME() + 0;
-> 235026
NOW()SYSDATE()CURRENT_TIMESTAMP以 ’YYYY-MM-DD HH:MM:SS’ 或 YYYYMMDDHHMMSS 格式傳回目前的日期時間值,傳回的格式取決于該函數是用于字元串還是數字語境中:
mysql> SELECT NOW();
-> ’1997-12-15 23:50:26’
mysql> SELECT NOW() + 0;
-> 19971215235026
注意,函數 NOW() 在每個查詢中隻計算一次,也就是在查詢開始執行時。這就是說,如果在一個獨立的查詢中多次引用了 NOW(),他隻會給出值都是個相同的時間。
UNIX_TIMESTAMP()UNIX_TIMESTAMP(date)如果調用時沒有參數,以無符号的整數形式傳回一個 Unix 時間戳(從 ’1970-01-01 00:00:00’ GMT 開始的秒數)。如果以一個參數 date 調用UNIX_TIMESTAMP(),他将傳回該參數值從 ’1970-01-01 00:00:00’ GMT 開始經過的秒數值。date 能是個 DATE 字元串,一個 DATETIME 字元串,一個 TIMESTAMP,或以一個 YYMMDD 或 YYYYMMDD 顯示的本地時間:
mysql> SELECT UNIX_TIMESTAMP();
-> 882226357
mysql> SELECT UNIX_TIMESTAMP(’1997-10-04 22:23:00’);
-> 875996580
當 UNIX_TIMESTAMP 被用于一個 TIMESTAMP 列時,函數直接傳回一個内部的時間戳值,而不進行一個隐含地 “string-to-unix-timestamp” 轉換。如果你傳遞一個超出範圍的日期參數給 UNIX_TIMESTAMP() ,他将傳回 0,不過請注意,MySQL 對其僅僅進行基本的檢驗(年範圍 1970-2037,月份 01-12,日期 01-31)。 如果你希望減去 UNIX_TIMESTAMP() 列,你應該需要将結果強制轉換為一有符号整數。檢視章節 6.3.5 Cast 函數。
FROM_UNIXTIME(unix_timestamp [,format])以 ’YYYY-MM-DD HH:MM:SS’ 或 YYYYMMDDHHMMSS 格式傳回一個 unix_timestamp 參數值,傳回值的形式取決于該函數使用于字元串還是數字語境。 如果 format 給出,傳回值依 format 字元串被格式。format 能包含和 DATE_FORMAT() 函數同樣的修飾符。
mysql> SELECT FROM_UNIXTIME(875996580);
-> ’1997-10-04 22:23:00’
mysql> SELECT FROM_UNIXTIME(875996580) + 0;
-> 19971004222300
mysql> SELECT FROM_UNIXTIME(UNIX_TIMESTAMP(),
’%Y %D %M %h:%i:%s %x’);
-> ’1997 23rd December 03:43:30 1997’
SEC_TO_TIME(seconds)以 ’HH:MM:SS’ 或 HHMMSS 格式傳回參數 seconds 被轉換到時分秒後的值,傳回值的形式取決于該函數使用于字元串還是數字語境:
mysql> SELECT SEC_TO_TIME(2378);
-> ’00:39:38’
mysql> SELECT SEC_TO_TIME(2378) + 0;
-> 3938
TIME_TO_SEC(time)将參數 time 轉換為秒數後傳回:
mysql> SELECT TIME_TO_SEC(’22:23:00’);
-> 80580
mysql> SELECT TIME_TO_SEC(’00:39:38’);
-> 2378