MaxCompute:FORMAT_TIME

Sintaksis

STRING FORMAT_TIME(BIGINT <time>, STRING <format>)

-- Contoh standar.
-- Mengembalikan 13:24:33.000.
SELECT FORMAT_TIME(48273000000, '%H:%M:%S.ff3');

Parameter

• time: Wajib diisi. Nilai BIGINT yang merepresentasikan waktu dalam mikrodetik. Anda dapat menggunakan fungsi TO_TIME untuk membuat nilai ini.

  Pada versi tipe data MaxCompute V1.0, jika parameter ini berupa STRING atau DOUBLE, nilai tersebut akan dikonversi secara implisit ke tipe BIGINT sebelum perhitungan dilakukan.

• format: Wajib diisi. STRING yang menentukan format string waktu output. Parameter format mendukung elemen format waktu berikut:

  • hh, HH, atau %H: Jam.

  • mi, MI, atau %M: Menit.

  • ss, SS, atau %S: Detik.

  • ff3: Milidetik. Elemen ini mewakili bagian pecahan dari detik. Sebagai contoh, Anda dapat menggunakan %S.ff3 untuk mencocokkan 00.123.

  • %E<number>S: Detik, dengan presisi <number> digit. Sebagai contoh, Anda dapat menggunakan %E3S untuk mencocokkan 00.123.

  • %E*S: Detik dengan presisi penuh enam tempat desimal. Sebagai contoh, 00.123456.

Nilai kembali

Mengembalikan nilai STRING yang merepresentasikan waktu terformat. Jika parameter time atau format bernilai NULL, fungsi ini mengembalikan NULL.

Contoh

• Contoh 1: Menampilkan nilai waktu dalam format standar.

  -- Mengembalikan 13:24:33.000.
  SELECT FORMAT_TIME(48273000000, '%H:%M:%S.ff3');

• Contoh 2: Menggunakan format teks kustom untuk menyisipkan elemen waktu, seperti jam, menit, detik, dan milidetik, ke dalam string teks.

  -- Mengembalikan The time is 24:33 and the millisecond part is 000.
  SELECT FORMAT_TIME(48273000000,"The time is %M:%S and the millisecond part is ff3");
  
  -- Mengembalikan only show 13:24.
  SELECT FORMAT_TIME(48273000000,"only show hh:mi");

• Contoh 3: Menggunakan fungsi TO_TIME untuk membuat nilai waktu, lalu memformat output-nya.

  -- Mengembalikan 15:03:01.
  SELECT FORMAT_TIME(TO_TIME('15:03:01', 'hh:mi:ss'), '%H:%M:ss');

• Contoh 4: Menangani input NULL.

  -- Jika salah satu parameter bernilai NULL, fungsi mengembalikan NULL.
  -- Mengembalikan NULL.
  SELECT FORMAT_TIME(NULL, '%H:%M:%S.ff3');
  
  -- Mengembalikan NULL.
  SELECT FORMAT_TIME(48273000000, NULL);

Fungsi terkait

FORMAT_TIME merupakan fungsi waktu. Untuk informasi lebih lanjut mengenai fungsi untuk perhitungan dan konversi tanggal, lihat Date functions.