Update timezone docs #19204
Open
Update timezone docs #19204
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
qiancai
added
needs-cherry-pick-release-8.5
ti-chi-bot
bot
added
the
size/XS
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: The full list of commands accepted by this bot can be found here.
Needs approval from an approver in each of these files:
Approvers can indicate their approval by writing |
ti-chi-bot
bot
added
size/M
hfxsd
reviewed
Dec 4, 2024
Comment on lines
+11
to
+13
| - TiDB 优先使用 `TZ` 环境变量。 | ||
| - 如果 `TZ` 环境变量不可用，TiDB 会从 `/etc/localtime` 的软链接中读取时区信息。 | ||
| - 如果上述方法均失败，TiDB 将使用 `UTC` 作为系统时区。 |
There was a problem hiding this comment.
Suggested change
| - TiDB 优先使用 `TZ` 环境变量。 | |
| - 如果 `TZ` 环境变量不可用，TiDB 会从 `/etc/localtime` 的软链接中读取时区信息。 | |
| - 如果上述方法均失败，TiDB 将使用 `UTC` 作为系统时区。 | |
| 1. TiDB 优先使用 `TZ` 环境变量。 | |
| 2. 如果 `TZ` 环境变量不可用，TiDB 会从 `/etc/localtime` 的软链接中读取时区信息。 | |
| 3. 如果上述方法均失败，TiDB 将使用 `UTC` 作为系统时区。 |
hfxsd
reviewed
Dec 4, 2024
| - 数据迁移时，需要特别注意主库和从库的时区设置是否一致。 | ||
| - 为了获取准确的时间戳，强烈建议使用网络时间协议（NTP）或精确时间协议（PTP）服务配置可靠的时钟。有关如何检查 NTP 服务的信息，请参考[检测及安装 NTP 服务](/check-before-deployment.md#检测及安装-ntp-服务)。 | ||
| - 当使用遵循夏令时 (Daylight Saving Time, DST) 的时区时，请注意可能出现时间戳不明确或不存在的情况，特别是在对这些时间戳进行计算时。 | ||
| - MySQL 需要使用 `mysql_tzinfo_to_sql` 将操作系统的时区数据库转换为 `mysql` 数据库中的表。TiDB 则可以利用 Go 编程语言的内置时区处理能力，直接从操作系统的时区数据库中读取时区数据文件。 |
There was a problem hiding this comment.
Suggested change
| - MySQL 需要使用 `mysql_tzinfo_to_sql` 将操作系统的时区数据库转换为 `mysql` 数据库中的表。TiDB 则可以利用 Go 编程语言的内置时区处理能力，直接从操作系统的时区数据库中读取时区数据文件。 | |
| - MySQL 需要使用 [`mysql_tzinfo_to_sql`](https://dev.mysql.com/doc/refman/8.4/en/mysql-tzinfo-to-sql.html) 将操作系统的时区数据库转换为 `mysql` 数据库中的表。TiDB 则可以利用 Go 编程语言的内置时区处理能力，直接从操作系统的时区数据库中读取时区数据文件。 |
hfxsd
reviewed
Dec 4, 2024
| {{< copyable "sql" >}} | ||
| 对于时区敏感的时间值，例如由 [`NOW()`](/functions-and-operators/date-and-time-functions.md) 和 `CURTIME()` 函数返回的值，它们的显示和处理会受到当前会话时区设置的影响。如需进行时区转换，可以使用 `CONVERT_TZ()` 函数。若要获取基于 UTC 的时间戳以避免时区相关问题，可以使用 `UTC_TIMESTAMP()` 函数。 | ||
|
|
||
| 在 TiDB 中，`TIMESTAMP` 数据类型会记录时间戳的具体数值和时区信息，因此它的显示值会受到时区设置的影响。其他数据类型（如 `DATETIME`、`DATE` 和 `TIME`） 不记录时区信息，因此它们的值不会受到时区变化的影响。 |
There was a problem hiding this comment.
Suggested change
| 在 TiDB 中，`TIMESTAMP` 数据类型会记录时间戳的具体数值和时区信息，因此它的显示值会受到时区设置的影响。其他数据类型（如 `DATETIME`、`DATE` 和 `TIME`） 不记录时区信息，因此它们的值不会受到时区变化的影响。 | |
| 在 TiDB 中，`TIMESTAMP` 数据类型会记录时间戳的具体数值和时区信息，因此它的显示值会受到时区设置的影响。其他数据类型（如 `DATETIME`、`DATE` 和 `TIME`）不记录时区信息，因此它们的值不会受到时区变化的影响。 |
hfxsd
reviewed
Dec 4, 2024
|
|
||
| - 在 `TIMESTAMP` 和 `DATETIME` 值的转换过程中，会涉及到时区。这种情况一律基于当前会话的 `time_zone` 时区处理。 | ||
| - 数据迁移时，需要特别注意主库和从库的时区设置是否一致。 | ||
| - 为了获取准确的时间戳，强烈建议使用网络时间协议（NTP）或精确时间协议（PTP）服务配置可靠的时钟。有关如何检查 NTP 服务的信息，请参考[检测及安装 NTP 服务](/check-before-deployment.md#检测及安装-ntp-服务)。 |
There was a problem hiding this comment.
Suggested change
| - 为了获取准确的时间戳，强烈建议使用网络时间协议（NTP）或精确时间协议（PTP）服务配置可靠的时钟。有关如何检查 NTP 服务的信息，请参考[检测及安装 NTP 服务](/check-before-deployment.md#检测及安装-ntp-服务)。 | |
| - 为了获取准确的时间戳，强烈建议使用网络时间协议 (NTP) 或精确时间协议 (PTP) 服务配置可靠的时钟。有关如何检查 NTP 服务的信息，请参考[检测及安装 NTP 服务](/check-before-deployment.md#检测及安装-ntp-服务)。 |
hfxsd
reviewed
Dec 4, 2024
| @@ -6,51 +6,61 @@ summary: TiDB 使用的时区由全局变量和 session 变量决定。全局变 | |||
|
|
|||
There was a problem hiding this comment.
英文的 summary 不如中文详细，可以和中文保持一致。
hfxsd
approved these changes
Dec 4, 2024
[LGTM Timeline notifier]Timeline:
|
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
What is changed, added or deleted? (Required)
Which TiDB version(s) do your changes apply to? (Required)
Tips for choosing the affected version(s):
By default, CHOOSE MASTER ONLY so your changes will be applied to the next TiDB major or minor releases. If your PR involves a product feature behavior change or a compatibility change, CHOOSE THE AFFECTED RELEASE BRANCH(ES) AND MASTER.
For details, see tips for choosing the affected versions.
What is the related PR or file link(s)?
Do your changes match any of the following descriptions?