MySQL - DATE_FORMAT() 函式

MySQL 的 DATE_FORMAT() 函式接受日期或日期時間值和格式字串作為引數。它根據指定的格式格式化給定的日期並返回結果。

MySQL 為所有包含日期和時間值的時態資料型別儲存了一些預設格式，如下所示

型別	格式
DATE	YYYY-MM-DD
TIME	HH:MM:SS
DATETIME	YYYY-MM-DD HH:MI:SS
TIMESTAMP	YYYY-MM-DD HH:MI:SS
YEAR	YYYY

格式字串

但是，除了預設值之外，您還可以根據需要格式化日期或時間值。為此，可以使用某些具有預定義含義的字元來建立格式字串。它們是 -

格式	描述
%a	星期幾名稱 (Sun...Sat)
%b	月份名稱 (Jan...Dec)
%c	月份，數字 (0...12)
%D	帶英文字尾的月份日期 (0th, 1st, 2nd, 3rd, ...)
%d	月份日期，數字 (01...31)
%e	月份日期，數字 (0...31)
%f	微秒 (000000...999999)
%H	小時 (00...23)
%h	小時 (00...12)
%I	小時 (00...12)
%i	分鐘，數字 (00...59)
%j	一年中的日期 (001...366)
%k	小時 (0...23)
%l	小時 (1...12)
%M	月份名稱 (January...December)
%m	月份作為數字值 (00...12)
%p	AM 或 PM
%r	時間，12 小時制 (hh:mm:ss 後跟 AM 或 PM)
%S	秒 (00...59)
%s	秒 (00...59)
%T	時間，24 小時制 (hh:mm:ss)
%U	星期 (00...53)，其中星期日是一週的第一天；WEEK() 模式 0
%u	星期 (00...53)，其中星期一是一週的第一天；WEEK() 模式 1
%V	星期 (01...53)，其中星期日是一週的第一天；WEEK() 模式 2；與 %X 一起使用
%v	星期 (01...53)，其中星期一是一週的第一天；WEEK() 模式 3；與 %x 一起使用
%W	星期幾名稱 (Sunday...Saturday)
%w	一週中的日期 (0=星期日...6=星期六)
%X	星期日是一週的第一天時的年份，數字，四位數；與 %V 一起使用
%x	星期一是一週的第一天時的年份，數字，四位數；與 %v 一起使用
%Y	年份作為數字值，4 位數
%y	年份作為數字值，2 位數

語法

以下是 MySQL DATE_FORMAT() 函式的語法 -

DATE_FORMAT(date,format);

引數

此方法接受兩個引數。下面描述了相同的內容 -

date: 我們要格式化的日期或日期時間表達式。
format: 指定輸出所需格式的字串。

返回值

此函式返回一個格式化字串，表示根據指定格式的日期或日期時間值。

示例

在以下示例中，我們使用 MySQL DATE_FORMAT() 函式列印給定日期的星期幾、月份和年份 -

SELECT DATE_FORMAT('2023-11-21', '%W %M %Y') As Result;

輸出

這將產生以下結果 -

結果
星期二十一月 2023

示例

在這裡，我們獲取給定日期的星期幾（短）、月份（短）和月份日期 -

SELECT DATE_FORMAT('2023-11-21', '%a %b %c') As Result;

輸出

以下是輸出 -

結果
週二十一月 11

示例

以下查詢列印星期幾、月份、年份和 12 小時格式的當天時間 -

SELECT DATE_FORMAT('2023-11-21 22:23:00','%W %M %Y %r') 
As Result;

輸出

以下是輸出 -

結果
星期二十一月 2023 晚上 10:23:00

在以下示例中，我們使用 CREATE TABLE 語句建立了一個名為 ORDERS 的表 -

CREATE TABLE ORDERS (
   OID INT NOT NULL,
   DATE VARCHAR (20) NOT NULL,
   CUSTOMER_ID INT NOT NULL,
   AMOUNT DECIMAL (18, 2)
);

現在，我們使用 INSERT 語句將以下記錄插入 ORDERS 表中。

INSERT INTO ORDERS VALUES 
(102, '2009-10-08 00:00:00', 3, 3000.00),
(100, '2009-10-08 00:00:00', 3, 1500.00),
(101, '2009-11-20 00:00:00', 2, 1560.00),
(103, '2008-05-20 00:00:00', 4, 2060.00);

執行以下查詢以獲取上面建立的表中所有插入的記錄。

Select * From ORDERS;

以下是 ORDERS 表的內容：

訂單 ID (OID)	DATE	客戶 ID (CUSTOMER_ID)	金額 (AMOUNT)
102	2009-10-08 00:00:00	3	3000.00
100	2009-10-08 00:00:00	3	1500.00
101	2009-11-20 00:00:00	2	1560.00
103	2008-05-20 00:00:00	4	2060.00

現在，我們使用 MySQL 的 DATE_FORMAT() 函式來獲取 "DATE" 列中每個日期值的日、月、年和星期名稱。

SELECT OID, DATE, DATE_FORMAT(DATE, '%D %M %Y, %W')
As Result FROM ORDERS;

輸出

輸出結果如下所示：

訂單 ID (OID)	DATE	結果
102	2009-10-08 00:00:00	2009年10月8日，星期四
100	2009-10-08 00:00:00	2009年10月8日，星期四
101	2009-11-20 00:00:00	2009年11月20日，星期五
103	2008-05-20 00:00:00	2008年5月20日，星期二

列印頁面