對于每個類型擁有的值范圍以及并且指定日期何時間值的有效格式的描述見7.3.6 日期和時間類型。
這里是一個使用日期函數的例子。下面的查詢選擇了所有記錄,其date_col的值是在最后30天以內:
mysql> select something from table
where to_days(now()) - to_days(date_col) <= 30;
dayofweek(date)
返回日期date的星期索引(1=星期天,2=星期一, ……7=星期六)。這些索引值對應于odbc標準。
mysql> select dayofweek('1998-02-03');
-> 3
weekday(date)
返回date的星期索引(0=星期一,1=星期二, ……6= 星期天)。
mysql> select weekday('1997-10-04 22:23:00');
-> 5
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
week(date)
week(date,first)
對于星期天是一周的第一天的地方,有一個單個參數,返回date的周數,范圍在0到52。2個參數形式week()允許
你指定星期是否開始于星期天或星期一。如果第二個參數是0,星期從星期天開始,如果第二個參數是1,
從星期一開始。
mysql> select week('1998-02-20');
-> 7
mysql> select week('1998-02-20',0);
-> 7
mysql> select week('1998-02-20',1);
-> 8
year(date)
返回date的年份,范圍在1000到9999。
mysql> select year('98-02-03');
-> 1998
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)
這些功能執行日期運算。對于mysql 3.22,他們是新的。adddate()和subdate()是date_add()和date_sub()的同義詞。
在mysql 3.23中,你可以使用+和-而不是date_add()和date_sub()。(見例子)date是一個指定開始日期的
datetime或date值,expr是指定加到開始日期或從開始日期減去的間隔值一個表達式,expr是一個字符串;它可以以
一個“-”開始表示負間隔。type是一個關鍵詞,指明表達式應該如何被解釋。extract(type from date)函數從日期
中返回“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"
mysql在expr格式中允許任何標點分隔符。表示顯示的是建議的分隔符。如果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
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
如果你指定太短的間隔值(不包括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> select date_add('1998-01-30', interval 1 month);
-> 1998-02-28
注意,從前面的例子中詞interval和type關鍵詞不是區分大小寫的。
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'
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)
%p am或pm
%w 一個星期中的天數(0=sunday ……6=saturday )
%u 星期(0……52), 這里星期天是星期的第一天
%u 星期(0……52), 這里星期一是星期的第一天
%% 一個文字“%”。
所有的其他字符不做解釋被復制到結果中。
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'
mysql3.23中,在格式修飾符字符前需要%。在mysql更早的版本中,%是可選的。
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
unix_timestamp()
unix_timestamp(date)
如果沒有參數調用,返回一個unix時間戳記(從'1970-01-01 00:00:00'gmt開始的秒數)。如果unix_timestamp()用一
個date參數被調用,它返回從'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”變換。
from_unixtime(unix_timestamp)
以'yyyy-mm-dd hh:mm:ss'或yyyymmddhhmmss格式返回unix_timestamp參數所表示的值,取決于函數是在一個字符串
還是或數字上下文中被使用。
mysql> select from_unixtime(875996580);
-> '1997-10-04 22:23:00'
mysql> select from_unixtime(875996580) + 0;
-> 19971004222300
from_unixtime(unix_timestamp,format)
返回表示 unix 時間標記的一個字符串,根據format字符串格式化。format可以包含與date_format()函數列出的條
目同樣的修飾符。
mysql> select from_unixtime(unix_timestamp(),
'%y %d %m %h:%i:%s %x');
-> '1997 23rd december 03:43:30 x'
sec_to_time(seconds)
返回seconds參數,變換成小時、分鐘和秒,值以'hh:mm:ss'或hhmmss格式化,取決于函數是在一個字符串還是在數字
上下文中被使用。
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