這裡是一個使用日期函數的例子。下面的查詢選擇了所有記錄,其date_col的值是在最後30天以內:
MySQL>SelectsomethingFROMtable
WhereTO_DAYS(NOW())-TO_DAYS(date_col)<=30;
DAYOFWEEK(date)
返回日期date的星期索引(1=星期天,2=星期一,……7=星期六)。這些索引值對應於ODBC標准。
MySQL>selectDAYOFWEEK('1998-02-03');
->3
WEEKDAY(date)
返回date的星期索引(0=星期一,1=星期二,……6=星期天)。
MySQL>selectWEEKDAY('1997-10-0422:23:00');
->5
MySQL>selectWEEKDAY('1997-11-05');
->2
DAYOFMONTH(date)
返回date的月份中日期,在1到31范圍內。
MySQL>selectDAYOFMONTH('1998-02-03');
->3
DAYOFYEAR(date)
返回date在一年中的日數,在1到366范圍內。
MySQL>selectDAYOFYEAR('1998-02-03');
->34
MONTH(date)
返回date的月份,范圍1到12。
MySQL>selectMONTH('1998-02-03');
->2
DAYNAME(date)
返回date的星期名字。
MySQL>selectDAYNAME("1998-02-05");
->'Thursday'
MONTHNAME(date)
返回date的月份名字。
MySQL>selectMONTHNAME("1998-02-05");
->'February'
QUARTER(date)
返回date一年中的季度,范圍1到4。
MySQL>selectQUARTER('98-04-01');
->2
WEEK(date)
WEEK(date,first)
對於星期天是一周的第一天的地方,有一個單個參數,返回date的周數,范圍在0到52。2個參數形式WEEK()允許
你指定星期是否開始於星期天或星期一。如果第二個參數是0,星期從星期天開始,如果第二個參數是1,
從星期一開始。
MySQL>selectWEEK('1998-02-20');
->7
MySQL>selectWEEK('1998-02-20',0);
->7
MySQL>selectWEEK('1998-02-20',1);
->8
YEAR(date)
返回date的年份,范圍在1000到9999。
MySQL>selectYEAR('98-02-03');
->1998
HOUR(time)
返回time的小時,范圍是0到23。
MySQL>selectHOUR('10:05:03');
->10
MINUTE(time)
返回time的分鐘,范圍是0到59。
MySQL>selectMINUTE('98-02-0310:05:03');
->5
SECOND(time)
回來time的秒數,范圍是0到59。
MySQL>selectSECOND('10:05:03');
->3
PERIOD_ADD(P,N)
增加N個月到階段P(以格式YYMM或YYYYMM)。以格式YYYYMM返回值。注意階段參數P不是日期值。
MySQL>selectPERIOD_ADD(9801,2);
->199803
PERIOD_DIFF(P1,P2)
返回在時期P1和P2之間月數,P1和P2應該以格式YYMM或YYYYMM。注意,時期參數P1和P2不是日期值。
MySQL>selectPERIOD_DIFF(9802,199703);
->11
DATE_ADD(date,INTERVALexprtype)
DATE_SUB(date,INTERVALexprtype)
ADDDATE(date,INTERVALexprtype)
SUBDATE(date,INTERVALexprtype)
這些功能執行日期運算。對於MySQL3.22,他們是新的。ADDDATE()和SUBDATE()是DATE_ADD()和DATE_SUB()的同義詞。
在MySQL3.23中,你可以使用+和-而不是DATE_ADD()和DATE_SUB()。(見例子)date是一個指定開始日期的
DATETIME或DATE值,expr是指定加到開始日期或從開始日期減去的間隔值一個表達式,expr是一個字符串;它可以以
一個“-”開始表示負間隔。type是一個關鍵詞,指明表達式應該如何被解釋。EXTRACT(typeFROMdate)函數從日期
中返回“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天和小時"DAYSHOURS"
YEAR_MONTH年和月"YEARS-MONTHS"
HOUR_SECOND小時,分鐘,"HOURS:MINUTES:SECONDS"
DAY_MINUTE天,小時,分鐘"DAYSHOURS:MINUTES"
DAY_SECOND天,小時,分鐘,秒"DAYSHOURS:MINUTES:SECONDS"
MySQL在expr格式中允許任何標點分隔符。表示顯示的是建議的分隔符。如果date參數是一個DATE值並且你的計算僅僅
包含YEAR、MONTH和DAY部分(即,沒有時間部分),結果是一個DATE值。否則結果是一個DATETIME值。
MySQL>Select"1997-12-3123:59:59"+INTERVAL1SECOND;
->1998-01-0100:00:00 > MySQL>SelectINTERVAL1DAY+"1997-12-31";
->1998-01-01
MySQL>Select"1998-01-01"-INTERVAL1SECOND;
->1997-12-3123:59:59
MySQL>SelectDATE_ADD("1997-12-3123:59:59",
INTERVAL1SECOND);
->1998-01-0100:00:00
MySQL>SelectDATE_ADD("1997-12-3123:59:59",
INTERVAL1DAY);
->1998-01-0123:59:59
MySQL>SelectDATE_ADD("1997-12-3123:59:59",
INTERVAL"1:1"MINUTE_SECOND);
->1998-01-0100:01:00
MySQL>SelectDATE_SUB("1998-01-0100:00:00",
INTERVAL"11:1:1"DAY_SECOND);
->1997-12-3022:58:59
MySQL>SelectDATE_ADD("1998-01-0100:00:00",
INTERVAL"-110"DAY_HOUR);
->1997-12-3014:00:00
MySQL>SelectDATE_SUB("1998-01-02",INTERVAL31DAY);
->1997-12-02
MySQL>SelectEXTRACT(YEARFROM"1999-07-02");
->1999
MySQL>SelectEXTRACT(YEAR_MONTHFROM"1999-07-0201:02:03");
->199907
MySQL>SelectEXTRACT(DAY_MINUTEFROM"1999-07-0201:02:03");
->20102
如果你指定太短的間隔值(不包括type關鍵詞期望的間隔部分),MySQL假設你省掉了間隔值的最左面部分。例如,
如果你指定一個type是DAY_SECOND,值expr被希望有天、小時、分鐘和秒部分。如果你象"1:10"這樣指定值,
MySQL假設日子和小時部分是丟失的並且值代表分鐘和秒。換句話說,"1:10"DAY_SECOND以它等價於"1:10"MINUTE_SECOND
的方式解釋,這對那MySQL解釋TIME值表示經過的時間而非作為一天的時間的方式有二義性。如果你使用確實不正確的日期,
結果是NULL。如果你增加MONTH、YEAR_MONTH或YEAR並且結果日期大於新月份的最大值天數,日子在新月用最大的天調整。
MySQL>selectDATE_ADD('1998-01-30',Interval1month);
->1998-02-28
注意,從前面的例子中詞INTERVAL和type關鍵詞不是區分大小寫的。
TO_DAYS(date)
給出一個日期date,返回一個天數(從0年的天數)。
MySQL>selectTO_DAYS(950501);
->728779
MySQL>selectTO_DAYS('1997-10-07');
->729669TO_DAYS()不打算用於使用格列高裡歷(1582)出現前的值。
FROM_DAYS(N)
給出一個天數N,返回一個DATE值。
MySQL>selectFROM_DAYS(729669);
->'1997-10-07'
TO_DAYS()不打算用於使用格列高裡歷(1582)出現前的值。
DATE_FORMAT(date,format)
根據format字符串格式化date值。下列修飾符可以被用在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)
%pAM或PM
%w一個星期中的天數(0=Sunday……6=Saturday)
%U星期(0……52),這裡星期天是星期的第一天
%u星期(0……52),這裡星期一是星期的第一天
%%一個文字“%”。
所有的其他字符不做解釋被復制到結果中。
MySQL>selectDATE_FORMAT('1997-10-0422:23:00','%W%M%Y');
->'SaturdayOctober1997'
MySQL>selectDATE_FORMAT('1997-10-0422:23:00','%H:%i:%s');
->'22:23:00'
MySQL>selectDATE_FORMAT('1997-10-0422:23:00',
'%D%y%a%d%m%b%j');
->'4th97Sat0410Oct277'
MySQL>selectDATE_FORMAT('1997-10-0422:23:00',
'%H%k%I%r%T%S%w');
->'22221010:23:00PM22:23:00006'
MySQL3.23中,在格式修飾符字符前需要%。在MySQL更早的版本中,%是可選的。
TIME_FORMAT(time,format)
這象上面的DATE_FORMAT()函數一樣使用,但是format字符串只能包含處理小時、分鐘和秒的那些格式修飾符。
其他修飾符產生一個NULL值或0。
CURDATE()
CURRENT_DATE
以'YYYY-MM-DD'或YYYYMMDD格式返回今天日期值,取決於函數是在一個字符串還是數字上下文被使用。
MySQL>selectCURDATE();
->'1997-12-15'
MySQL>selectCURDATE()+0;
->19971215
CURTIME()
CURRENT_TIME
以'HH:MM:SS'或HHMMSS格式返回當前時間值,取決於函數是在一個字符串還是在數字的上下文被使用。
MySQL>selectCURTIME();
->'23:50:26'
MySQL>selectCURTIME()+0;
->235026
NOW()
SYSDATE()
CURRENT_TIMESTAMP
以'YYYY-MM-DDHH:MM:SS'或YYYYMMDDHHMMSS格式返回當前的日期和時間,取決於函數是在一個字符串還是在數字的
上下文被使用。
MySQL>selectNOW();
->'1997-12-1523:50:26'
MySQL>selectNOW()+0;
->19971215235026
UNIX_TIMESTAMP()
UNIX_TIMESTAMP(date)
如果沒有參數調用,返回一個Unix時間戳記(從'1970-01-0100:00:00'GMT開始的秒數)。如果UNIX_TIMESTAMP()用一
個date參數被調用,它返回從'1970-01-0100:00:00'GMT開始的秒數值。date可以是一個DATE字符串、一個DATETIME
字符串、一個TIMESTAMP或以YYMMDD或YYYYMMDD格式的本地時間的一個數字。
MySQL>selectUNIX_TIMESTAMP();
->882226357
MySQL>selectUNIX_TIMESTAMP('1997-10-0422:23:00');
->875996580
當UNIX_TIMESTAMP被用於一個TIMESTAMP列,函數將直接接受值,沒有隱含的“string-to-unix-timestamp”變換。
FROM_UNIXTIME(unix_timestamp)
以'YYYY-MM-DDHH:MM:SS'或YYYYMMDDHHMMSS格式返回unix_timestamp參數所表示的值,取決於函數是在一個字符串
還是或數字上下文中被使用。
MySQL>selectFROM_UNIXTIME(875996580);
->'1997-10-0422:23:00'
MySQL>selectFROM_UNIXTIME(875996580)+0;
->19971004222300
FROM_UNIXTIME(unix_timestamp,format)
返回表示Unix時間標記的一個字符串,根據format字符串格式化。format可以包含與DATE_FORMAT()函數列出的條
目同樣的修飾符。
MySQL>selectFROM_UNIXTIME(UNIX_TIMESTAMP(),
'%Y%D%M%h:%i:%s%x');
->'199723rdDecember03:43:30x'
SEC_TO_TIME(seconds)
返回seconds參數,變換成小時、分鐘和秒,值以'HH:MM:SS'或HHMMSS格式化,取決於函數是在一個字符串還是在數字
上下文中被使用。
MySQL>selectSEC_TO_TIME(2378);
->'00:39:38'
MySQL>selectSEC_TO_TIME(2378)+0;
->3938
TIME_TO_SEC(time)
返回time參數,轉換成秒。
MySQL>selectTIME_TO_SEC('22:23:00');
->80580
MySQL>selectTIME_TO_SEC('00:39:38');
->2378