Tous les produits
Search
Centre de documentation

Realtime Compute for Apache Flink:DATE_FORMAT_TZ

Dernière mise à jour :Aug 09, 2026

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 0 dans Asia/Shanghai (UTC+8) devient 1970-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.