Update timezone docs

[dveeden]

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.

• master (the latest development version)
• v8.2 (TiDB 8.2 versions)
• v8.1 (TiDB 8.1 versions)
• v8.0 (TiDB 8.0 versions)
• v7.6 (TiDB 7.6 versions)
• v7.5 (TiDB 7.5 versions)
• v7.1 (TiDB 7.1 versions)
• v6.5 (TiDB 6.5 versions)
• v6.1 (TiDB 6.1 versions)
• v5.4 (TiDB 5.4 versions)
• v5.3 (TiDB 5.3 versions)
• v5.2 (TiDB 5.2 versions)
• v5.1 (TiDB 5.1 versions)

What is the related PR or file link(s)?

• This PR is translated from:
• Other reference link(s):

Do your changes match any of the following descriptions?

• Delete files
• Change aliases
• Need modification after applied to another branch
• Might cause conflicts after applied to another branch

[mjonss]

LGTM with some suggestions

[ti-chi-bot]

@mjonss: adding LGTM is restricted to approvers and reviewers in OWNERS files.

In response to this:

LGTM with some suggestions

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

[dveeden]

@mjonss should we mention weird things like the right/ zones (e.g. right/Universal) and posix/ (e.g. posix/Chile/EasterIsland) ? Or should we remove support for them maybe?

TiDB

mysql-8.0.11-TiDB-v8.4.0-alpha-445-g6eed1cd7bd> SET time_zone = 'posix/Chile/EasterIsland';
Query OK, 0 rows affected (0.00 sec)

mysql-8.0.11-TiDB-v8.4.0-alpha-445-g6eed1cd7bd> SET time_zone = 'right/Universal';
Query OK, 0 rows affected (0.00 sec)

MySQL

mysql-9.1.0> SET time_zone = 'posix/Chile/EasterIsland';
ERROR 1298 (HY000): Unknown or incorrect time zone: 'posix/Chile/EasterIsland'
mysql-9.1.0> SET time_zone = 'right/Universal';
ERROR 1298 (HY000): Unknown or incorrect time zone: 'right/Universal'

[mjonss]

@mjonss should we mention weird things like the right/ zones (e.g. right/Universal) and posix/ (e.g. posix/Chile/EasterIsland) ? Or should we remove support for them maybe?
...

I think we don't need to mention it, since it is platform/OS/installation dependent, I think we can ignore it and just keep what golang implements. As long as we are MySQL compatible too :)

[ti-chi-bot]

[LGTM Timeline notifier]

Timeline:

• 2024-11-11 09:06:36.952844613 +0000 UTC m=+260759.143713611: ☑️ agreed by qiancai.
• 2024-12-04 14:50:43.216884669 +0000 UTC m=+1252830.836539180: ☑️ agreed by hfxsd.

[qiancai]

/approve

[ti-chi-bot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: qiancai

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [qiancai]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[ti-chi-bot]

In response to a cherrypick label: new pull request created to branch release-8.5: #19587.