本文介紹MySQL維護的時區設置——如何加載命名時間支持所需的系統表,如何及時了解時區變化,以及如何啟用閏秒支持。
從MySQL 8.0.19開始,插入的日期時間值也支持時區偏移。
1?時區變量
MySQL Server維護了幾個時區設置:
- 服務器系統時區。當服務器啟動時,它會嘗試確定主機的時區,并使用它來設置system_time_zone系統變量。
- 要在啟動時明確指定MySQL Server的系統時區,請在啟動mysqld之前設置TZ環境變量。如果使用mysqld_safe啟動服務器,其--timezone選項提供了另一種設置系統時區的方法。TZ和--時區的允許值取決于系統。請參閱您的操作系統文檔,了解哪些值是可接受的。
- 服務器當前時區。全局time_zone系統變量表示服務器當前運行的時區。初始time_zone值為“system”,表示服務器時區與系統時區相同。
注意:
如果設置為SYSTEM,則每個需要時區計算的MySQL函數調用都會進行系統庫調用,以確定當前系統時區。此調用可能受到全局互斥的保護,從而導致爭用。
初始全局服務器時區值可以在啟動時使用命令行上的--default時區選項顯式指定,也可以在選項文件中使用以下行:
default-time-zone='timezone'
如果您具有SYSTEM_VARIABLES_ADMIN權限(或不推薦使用的SUPER權限),則可以使用以下語句在運行時設置全局服務器時區值:
SET GLOBAL time_zone = timezone;
- 每個會話的時區。每個連接的客戶端都有自己的會話時區設置,由會話time_zone變量給定。最初,會話變量的值取自全局time_zone變量,但客戶端可以使用以下語句更改自己的時區:
SET time_zone = timezone;
會話時區設置會影響區分區域的時間值的顯示和存儲。這包括函數(如NOW()或CURTIME())顯示的值,以及存儲在TIMESTAMP列中和從中檢索的值。TIMESTAMP列的值從會話時區轉換為UTC用于存儲,從UTC轉換為會話時區用于檢索。
會話時區設置不影響UTC_TIMESTAMP()等函數顯示的值或DATE、time或DATETIME列中的值。這些數據類型中的值也不存儲在UTC中;時區僅在從TIMESTAMP值轉換時適用于它們。如果需要DATE、TIME或DATETIME值的特定于區域設置的算術運算,請將它們轉換為UTC,執行算術運算,然后再轉換回來。
當前全局和會話時區值可以這樣檢索:
SELECT @@GLOBAL.time_zone, @@SESSION.time_zone;
時區值可以用幾種格式給出,它們都不區分大小寫:
- 作為值“SYSTEM”,表示服務器時區與系統時區相同。
- 作為一個字符串,指示與UTC的偏移量,格式為[H]H:MM,前綴為+或-,如“+10:00”、“-6:00”或“+05:30”。前導零可以可選地用于小于10的小時值;在這種情況下,MySQL在存儲和檢索值時會預加一個前導零。MySQL將“-00:00”或“-0:00”轉換為“+00:00”。
- 在MySQL 8.0.19之前,此值必須在“-12:59”到“+13:00”之間(包括在內);從MySQL 8.0.19開始,允許的范圍是“-13:59”到“+14:00”,包括在內。
- 作為命名時區,如“歐洲/赫爾辛基”、“美國/東方”、“MET”或“UTC”。
只有當mysql數據庫中的時區信息表已經創建并填充時,才能使用命名時區。否則,使用命名時區會導致錯誤:
mysql> SET time_zone = 'UTC';
ERROR 1298 (HY000): Unknown or incorrect time zone: 'UTC'
2 填充時區表
mysql系統模式中有幾個表用于存儲時區信息。MySQL安裝過程會創建時區表,但不會加載它們。要手動執行此操作,請使用以下說明。
注意:
加載時區信息不一定是一次性操作,因為信息偶爾會發生變化。當發生此類更改時,使用舊規則的應用程序將過期,您可能會發現有必要重新加載時區表,以保持MySQL服務器使用的信息是最新的。請參閱保持時區更改的最新狀態。
如果您的系統有自己的zoneinfo數據庫(描述時區的一組文件),請使用mysql_tzinfo_to_sql程序加載時區表。這類系統的例子有Linux、macOS、FreeBSD和Solaris。這些文件的一個可能位置是/usr/share/zoneinfo目錄。如果您的系統沒有zoneinfo數據庫,您可以使用可下載的軟件包。
要從命令行加載時區表,請將zoneinfo目錄路徑名傳遞給mysql_tzinfo_To_sql,并將輸出發送到mysql程序中。例如:
mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root -p mysql
這里顯示的mysql命令假設您使用root等帳戶連接到服務器,該帳戶具有修改mysql系統模式中的表的權限。根據需要調整連接參數。
mysql_tzinfo_to_sql讀取系統的時區文件并從中生成sql語句。mysql處理這些語句以加載時區表。
mysql_tzinfo_to_sql還可以用于加載單個時區文件或生成閏秒信息:
- 要加載與時區名稱tz_name對應的單個時區文件tz_file,請調用mysql_tzinfo_To_sql,如下所示:
mysql_tzinfo_to_sql tz_file tz_name | mysql -u root -p mysql
使用這種方法,必須執行一個單獨的命令來加載服務器需要了解的每個命名區域的時區文件。
- 如果您的時區必須考慮閏秒,請初始化閏秒信息,如下所示,其中tz_file是時區文件的名稱:
mysql_tzinfo_to_sql --leap tz_file | mysql -u root -p mysql
在運行mysql_tzinfo_to_sql之后,重新啟動服務器,使其不再繼續使用任何以前緩存的時區數據。
如果您的系統沒有zoneinfo數據庫(例如,Windows),您可以使用一個包含SQL語句的包,該包可在MySQL開發區下載:
https://dev.mysql.com/downloads/timezones.html
注意:
如果您的系統有zoneinfo數據庫,請不要使用可下載的時區包。請改用mysql_tzinfo_to_sql實用程序。否則,您可能會導致MySQL和系統上其他應用程序在日期時間處理方面存在差異。
要使用已下載的SQL語句時區包,請對其進行解壓縮,然后將解壓縮后的文件內容加載到時區表中:
mysql -u root -p mysql < file_name
然后重新啟動服務器。
警告:
不要使用包含MyISAM表的可下載時區包。這適用于較舊的MySQL版本。MySQL現在使用InnoDB作為時區表。嘗試用MyISAM表替換它們會導致問題。
3 隨時了解時區變化
當時區規則更改時,使用舊規則的應用程序將過期。要保持最新,必須確保您的系統使用當前時區信息。對于MySQL,保持最新狀態需要考慮多個因素:
- 如果MySQL服務器的時區設置為system,則操作系統時間會影響其使用的時間值。請確保您的操作系統使用的是最新的時區信息。對于大多數操作系統,最新的更新或service pack會為系統的時間變化做好準備。請查看操作系統供應商的網站,以獲取解決時間更改的更新。
- 如果將系統的/etc/localtime zone文件替換為使用與mysqld啟動時有效的規則不同的規則的版本,請重新啟動mysqld,使其使用更新的規則。否則,當系統更改時間時,mysqld可能不會注意到。
- 如果您在MySQL中使用命名時區,請確保MySQL數據庫中的時區表是最新的:
- 如果您的系統有自己的zoneinfo數據庫,請在更新zoneinfo時重新加載MySQL時區表。
- 對于沒有自己的zoneinfo數據庫的系統,請查看MySQL開發區以獲取更新。當有新的更新可用時,請下載并使用它來替換當前時區表的內容。
mysqld緩存它查找的時區信息,因此在更新時區表后,重新啟動mysqld以確保它不會繼續提供過時的時區數據。
如果您不確定命名時區是否可用(用作服務器的時區設置或由設置自己時區的客戶端使用),請檢查時區表是否為空。以下查詢確定包含時區名稱的表是否有任何行:
mysql> SELECT COUNT(*) FROM mysql.time_zone_name;
+----------+
| COUNT(*) |
+----------+
| 0 |
+----------+
計數為零表示表為空。在這種情況下,當前沒有任何應用程序使用命名時區,因此不需要更新表(除非您希望啟用命名時區支持)。計數大于零表示該表不是空的,并且其內容可用于命名時區支持。在這種情況下,請確保重新加載時區表,以便使用命名時區的應用程序能夠獲得正確的查詢結果。
要檢查MySQL安裝是否已針對夏令時規則的更改進行了正確更新,請使用以下測試。此示例使用的值適用于美國3月11日凌晨2點發生的2007夏令時1小時變化。
測試使用以下查詢:
SELECTCONVERT_TZ('2007-03-11 2:00:00','US/Eastern','US/Central') AS time1,CONVERT_TZ('2007-03-11 3:00:00','US/Eastern','US/Central') AS time2;
這兩個時間值表示夏令時更改發生的時間,使用命名時區需要使用時區表。所需的結果是,兩個查詢都返回相同的結果(輸入時間,轉換為“美國/中部”時區中的等效值)。
在更新時區表之前,您會看到如下錯誤結果:
+---------------------+---------------------+
| time1 | time2 |
+---------------------+---------------------+
| 2007-03-11 01:00:00 | 2007-03-11 02:00:00 |
+---------------------+---------------------+
更新表格后,您應該會看到正確的結果:
+---------------------+---------------------+
| time1 | time2 |
+---------------------+---------------------+
| 2007-03-11 01:00:00 | 2007-03-11 01:00:00 |
+---------------------+---------------------+
4 時區閏秒支持
閏秒值返回的時間部分以:59:59結束。這意味著像NOW()這樣的函數可以在閏秒期間連續兩三秒返回相同的值。確實,時間部分以:59:60或:59:61結尾的文字時間值被視為無效。
如果有必要在閏秒前一秒搜索TIMESTAMP值,如果將其與“YYYY-MM-DD hh:MM:ss”值進行比較,則可能會獲得異常結果。下面的示例演示了這一點。它將會話時區更改為UTC,因此內部TIMESTAMP值(以UTC為單位)和顯示值(已應用時區校正)之間沒有差異。
mysql> CREATE TABLE t1 (a INT,ts TIMESTAMP DEFAULT CURRENT_TIMESTAMP,PRIMARY KEY (ts));
Query OK, 0 rows affected (0.01 sec)mysql> -- change to UTC
mysql> SET time_zone = '+00:00';
Query OK, 0 rows affected (0.00 sec)mysql> -- Simulate NOW() = '2008-12-31 23:59:59'
mysql> SET timestamp = 1230767999;
Query OK, 0 rows affected (0.00 sec)mysql> INSERT INTO t1 (a) VALUES (1);
Query OK, 1 row affected (0.00 sec)mysql> -- Simulate NOW() = '2008-12-31 23:59:60'
mysql> SET timestamp = 1230768000;
Query OK, 0 rows affected (0.00 sec)mysql> INSERT INTO t1 (a) VALUES (2);
Query OK, 1 row affected (0.00 sec)mysql> -- values differ internally but display the same
mysql> SELECT a, ts, UNIX_TIMESTAMP(ts) FROM t1;
+------+---------------------+--------------------+
| a | ts | UNIX_TIMESTAMP(ts) |
+------+---------------------+--------------------+
| 1 | 2008-12-31 23:59:59 | 1230767999 |
| 2 | 2008-12-31 23:59:59 | 1230768000 |
+------+---------------------+--------------------+
2 rows in set (0.00 sec)mysql> -- only the non-leap value matches
mysql> SELECT * FROM t1 WHERE ts = '2008-12-31 23:59:59';
+------+---------------------+
| a | ts |
+------+---------------------+
| 1 | 2008-12-31 23:59:59 |
+------+---------------------+
1 row in set (0.00 sec)mysql> -- the leap value with seconds=60 is invalid
mysql> SELECT * FROM t1 WHERE ts = '2008-12-31 23:59:60';
Empty set, 2 warnings (0.00 sec)
要解決此問題,您可以使用基于實際存儲在列中的UTC值的比較,該值已應用閏秒校正:
mysql> -- selecting using UNIX_TIMESTAMP value return leap value
mysql> SELECT * FROM t1 WHERE UNIX_TIMESTAMP(ts) = 1230768000;
+------+---------------------+
| a | ts |
+------+---------------------+
| 2 | 2008-12-31 23:59:59 |
+------+---------------------+
1 row in set (0.00 sec)