Eine Beschreibung des Wertebereichs jedes Typs und der gültigen Formate zum Angeben von Datums- und Uhrzeitwerten finden Sie unter 7.3.6 Datums- und Uhrzeittypen.
Hier ist ein Beispiel für die Verwendung von Datumsfunktionen. Die folgende Abfrage wählt alle Datensätze aus, deren date_col-Wert innerhalb der letzten 30 Tage liegt:
mysql> SELECT something FROM table WHERE TO_DAYS(NOW()) - TO_DAYS(date_col) <= 30;
DAYOFWEEK(date)
Gibt den Wochenindex des Datums (1= zurück Sonntag, 2=Montag, …7=Samstag). Diese Indexwerte entsprechen dem ODBC-Standard.
mysql> select DAYOFWEEK('1998-02-03'); -> 3
WEEKDAY(date)
Gibt den Wochenindex des Datums zurück (0=Montag, 1=Dienstag, ...6=Sonntag).
mysql> select WEEKDAY('1997-10-04 22:23:00'); -> 5 mysql> select WEEKDAY('1997-11-05'); -> 2
DAYOFMONTH(date)
Gibt den Tag des Monats von date im Bereich von 1 bis 31 zurück.
mysql> select DAYOFMONTH('1998-02-03'); -> 3
DAYOFYEAR(date)
Gibt die Anzahl der Tage des Jahres im Datum zurück, im Bereich von 1 bis 366.
mysql> select DAYOFYEAR('1998-02-03'); -> 34
MONTH(date)
Gibt den Monat des Datums zurück, im Bereich von 1 bis 12.
mysql> select MONTH('1998-02-03'); -> 2
DAYNAME(date)
Gibt den Wochentagsnamen des Datums zurück.
mysql> select DAYNAME("1998-02-05"); -> 'Thursday'
MONTHNAME(date)
Gibt den Monatsnamen des Datums zurück.
mysql> select MONTHNAME("1998-02-05"); -> 'February'
QUARTER(date)
Gibt das Quartal des Jahres als Datum zurück, im Bereich von 1 bis 4.
mysql> select QUARTER('98-04-01'); -> 2
WEEK(date)
WEEK(date,first)
Für Orte, an denen Sonntag der erste Tag der Woche ist, gibt es einen Single Parameter: Gibt die Wochennummer des Datums im Bereich von 0 bis 52 zurück. Mit der 2-Argument-Form WEEK() können Sie
angeben, ob die Woche am Sonntag oder Montag beginnt. Wenn der zweite Parameter 0 ist, beginnt die Woche am Sonntag, wenn der zweite Parameter 1 ist, beginnt
am Montag.
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)
Gibt das Jahr des Datums zurück, im Bereich von 1000 bis 9999.
mysql> select YEAR('98-02-03'); -> 1998
HOUR(time)
Gibt die Stunde der Zeit im Bereich von 0 bis 23 zurück.
mysql> select HOUR('10:05:03'); -> 10
MINUTE(time)
Gibt die Minuten der Zeit im Bereich von 0 bis 59 zurück.
mysql> select MINUTE('98-02-03 10:05:03'); -> 5
SECOND(time)
Gibt die Anzahl der Sekunden der Zeit zurück, im Bereich von 0 bis 59.
mysql> select SECOND('10:05:03'); -> 3
PERIOD_ADD(P,N)
N Monate zu Phase P hinzufügen (im Format JJMM oder JJJJMM). Gibt den Wert im Format JJJJMM zurück. Beachten Sie, dass der Phasenparameter P kein Datumswert ist.
mysql> select PERIOD_ADD(9801,2); -> 199803
PERIOD_DIFF(P1,P2)
Gibt die Anzahl der Monate zwischen den Perioden P1 und P2 zurück. P1 und P2 sollten im Format JJMM oder JJJJMM vorliegen. Beachten Sie, dass die Periodenparameter P1 und P2 keine Datumswerte sind.
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)
Diese Funktionen führen Datumsoperationen durch. Ab MySQL 3.22 sind sie neu. ADDDATE() und SUBDATE() sind Synonyme von DATE_ADD() und DATE_SUB().
In MySQL 3.23 können Sie - und - anstelle von DATE_ADD() und DATE_SUB() verwenden. (siehe Beispiel) date ist ein
DATETIME- oder DATE-Wert, der das Startdatum angibt, expr ist ein Ausdruck, der den Intervallwert angibt, der zum Startdatum addiert oder davon subtrahiert werden soll, expr ist eine Zeichenfolge, die mit < beginnen kann; 🎜 >Ein „-“-Anfang zeigt ein negatives Intervall an. Typ ist ein Schlüsselwort, das angibt, wie der Ausdruck interpretiert werden soll. Die Funktion EXTRACT(type FROM date) gibt das „Typ“-Intervall ab Datum
zurück. Die folgende Tabelle zeigt, wie die Typ- und Ausdrucksparameter zusammenhängen: Typwert Bedeutung erwartetes Ausdrucksformat
SEKUNDE Sekunden SEKUNDEN
MINUTE Minuten MINUTES
STUNDE Zeit STUNDEN
TAG Tage TAGE
MONAT Monate MONATE
JAHR JAHRE
MINUTE_SECOND Minuten und Sekunden „MINUTES:SECONDS“
HOUR_MINUTE Stunden und Minuten „HOURS:MINUTES“
DAY_HOUR Tage und Stunden „DAYS HOURS“
YEAR_MONTH Jahre und Monate „YEARS- MONTHS "
HOUR_SECOND Stunden, Minuten, "HOURS:MINUTES:SECONDS"
DAY_MINUTE Tage, Stunden, Minuten "DAYS HOURS:MINUTES"
DAY_SECOND Tage, Stunden, Minuten, Sekunden" DAYS HOURS:MINUTES:SECONDS "
MySQL erlaubt jedes Interpunktionstrennzeichen im Ausdrucksformat. Zeigt an, dass empfohlene Trennzeichen angezeigt werden. Wenn das Datumsargument ein DATE-Wert ist und Ihre Berechnung nur die Komponenten YEAR, MONTH und DAY enthält (d. h. keine Zeitkomponente), ist das Ergebnis ein DATE-Wert. Andernfalls ist das Ergebnis ein DATETIME-Wert.
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
Wenn Sie den Typ DAY_SECOND angeben, wird erwartet, dass der Wert expr Tages-, Stunden-, Minuten- und Sekundenkomponenten enthält. Wenn Sie einen Wert wie „1:10“ angeben,
MySQL geht davon aus, dass die Tages- und Stundenteile fehlen und der Wert Minuten und Sekunden darstellt. Mit anderen Worten, „1:10“ DAY_SECOND wird so interpretiert, dass es äquivalent zu „1:10“ MINUTE_SECOND
ist, was nicht eindeutig mit der Art und Weise ist, wie MySQL TIME-Werte interpretiert, um die verstrichene Zeit darzustellen und nicht als Tageszeit. Wenn Sie ein wirklich falsches Datum verwenden,
ist das Ergebnis NULL. Wenn Sie MONTH, YEAR_MONTH oder YEAR erhöhen und das resultierende Datum größer als die maximale Anzahl von Tagen im neuen Monat ist, werden die Tage an die maximale Anzahl von Tagen im neuen Monat angepasst.
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