DATE_FORMAT_TZ convertit une valeur TIMESTAMP en chaîne de caractères formatée dans le fuseau horaire spécifié.
Syntaxe
VARCHAR DATE_FORMAT_TZ(TIMESTAMP timestamp, VARCHAR format, VARCHAR timezone)
VARCHAR DATE_FORMAT_TZ(TIMESTAMP timestamp, VARCHAR timezone)
Les deux formes renvoient une chaîne VARCHAR.
Paramètres d'entrée
| Paramètre | Type de données | Description |
|---|---|---|
timestamp |
TIMESTAMP | Horodatage à convertir. |
format |
VARCHAR | Format de date de sortie. Exemple : yyyy-MM-dd HH:mm:ss. |
timezone |
VARCHAR | Fuseau horaire cible. Exemple : Asia/Shanghai. |
Notes d'utilisation
La fonction convertit l'horodatage dans le fuseau horaire cible. Par exemple, l'époque Unix
0dansAsia/Shanghai(UTC+8) devient1970-01-01 08:00:00.
Exemple
Données de test
| timestamp1 (TIMESTAMP) | format1 (VARCHAR) | timezone1 (VARCHAR) |
|---|---|---|
| 0 | yyyy-MM-dd HH:mm:ss | Asia/Shanghai |
Instruction de test
SELECT
DATE_FORMAT_TZ(timestamp1, format1, timezone1) AS var1,
DATE_FORMAT_TZ(timestamp1, timezone1) AS var2
FROM T1;
Résultat du test
| var1 (VARCHAR) | var2 (VARCHAR) |
|---|---|
| 1970-01-01 08:00:00 | 1970-01-01 08:00:00 |
L'époque Unix 0 correspond à 1970-01-01 00:00:00 UTC. Converti dans le fuseau Asia/Shanghai (UTC+8), le résultat est 1970-01-01 08:00:00.