DATE_FORMAT_TZ convierte un valor TIMESTAMP en una cadena con formato en la zona horaria especificada.
Sintaxis
VARCHAR DATE_FORMAT_TZ(TIMESTAMP timestamp, VARCHAR format, VARCHAR timezone)
VARCHAR DATE_FORMAT_TZ(TIMESTAMP timestamp, VARCHAR timezone)
Ambas formas devuelven una cadena VARCHAR.
Parámetros de entrada
|
Parámetro |
Tipo de dato |
Descripción |
|
|
TIMESTAMP |
Marca de tiempo por convertir. |
|
|
VARCHAR |
Formato de fecha de salida. Por ejemplo: |
|
|
VARCHAR |
Zona horaria de destino. Por ejemplo: |
Notas de uso
La función ajusta la marca de tiempo a la zona horaria de destino. Por ejemplo, la época Unix
0enAsia/Shanghai(UTC+8) se convierte en1970-01-01 08:00:00.
Ejemplo
Datos de prueba
|
timestamp1 (TIMESTAMP) |
format1 (VARCHAR) |
timezone1 (VARCHAR) |
|
0 |
yyyy-MM-dd HH:mm:ss |
Asia/Shanghai |
Instrucción de prueba
SELECT
DATE_FORMAT_TZ(timestamp1, format1, timezone1) AS var1,
DATE_FORMAT_TZ(timestamp1, timezone1) AS var2
FROM T1;
Resultado de la prueba
|
var1 (VARCHAR) |
var2 (VARCHAR) |
|
1970-01-01 08:00:00 |
1970-01-01 08:00:00 |
La época Unix 0 corresponde a 1970-01-01 00:00:00 UTC. Al ajustarse a Asia/Shanghai (UTC+8), el resultado es 1970-01-01 08:00:00.