All Products
Search
Document Center

Realtime Compute for Apache Flink:DATE_FORMAT_TZ

Last Updated:Mar 26, 2026

DATE_FORMAT_TZ mengonversi nilai TIMESTAMP menjadi string terformat dalam zona waktu yang ditentukan.

Sintaksis

VARCHAR DATE_FORMAT_TZ(TIMESTAMP timestamp, VARCHAR format, VARCHAR timezone)
VARCHAR DATE_FORMAT_TZ(TIMESTAMP timestamp, VARCHAR timezone)

Kedua bentuk tersebut mengembalikan string VARCHAR.

Parameter input

ParameterTipe dataDeskripsi
timestampTIMESTAMPTimestamp yang akan dikonversi.
formatVARCHARFormat tanggal output. Contoh: yyyy-MM-dd HH:mm:ss.
timezoneVARCHARZona waktu tujuan. Contoh: Asia/Shanghai.

Catatan penggunaan

  • Fungsi ini menggeser timestamp ke zona waktu tujuan. Sebagai contoh, epoch Unix 0 di Asia/Shanghai (UTC+8) menjadi 1970-01-01 08:00:00.

Contoh

Data uji

timestamp1 (TIMESTAMP)format1 (VARCHAR)timezone1 (VARCHAR)
0yyyy-MM-dd HH:mm:ssAsia/Shanghai

Pernyataan uji

SELECT
   DATE_FORMAT_TZ(timestamp1, format1, timezone1) AS var1,
   DATE_FORMAT_TZ(timestamp1, timezone1) AS var2
FROM T1;

Hasil uji

var1 (VARCHAR)var2 (VARCHAR)
1970-01-01 08:00:001970-01-01 08:00:00

Epoch Unix 0 adalah 1970-01-01 00:00:00 UTC. Setelah digeser ke Asia/Shanghai (UTC+8), hasilnya adalah 1970-01-01 08:00:00.