make_timestamp fungsi

Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime

Membuat stempel waktu dari bidang year, month, day, hour, min, sec, dan timezone.

Sintaks

make_timestamp(year, month, day, hour, min, sec [, timezone] )

make_timestamp(date [, time [, timezone]] )

Important

Argumen menggunakan time tipe TIME data, yang berada dalam Beta.

Argumen

  • year: Sebuah INTEGER ekspresi yang mengevaluasi ke nilai dari 1 hingga 9999.
  • month: Sebuah INTEGER ekspresi yang mengevaluasi hingga nilai dari 1 (Januari) hingga 12 (Desember).
  • day: Sebuah INTEGER ekspresi yang mengevaluasi ke nilai dari 1 sampai 31.
  • hour: Sebuah INTEGER ekspresi yang mengevaluasi ke nilai antara 0 dan 23.
  • min: Sebuah INTEGER ekspresi yang mengevaluasi ke nilai antara 0 dan 59.
  • sec: Ekspresi numerik yang mengevaluasi nilai dari 0 dan 60.
  • date: Sebuah ekspresi yang DATE menyediakan bidang tahun, bulan, dan hari.
  • time: Ekspresi opsional TIME yang menyediakan kolom jam, menit, dan detik. Default ke 00:00:00 jika dihilangkan.
  • timezone: Ekspresi opsional STRING yang mengevaluasi ke zona waktu yang valid, seperti CET atau UTC.

Pengembalian

TIMESTAMP.

Jika sebuah argumen di luar batas, fungsi tersebut menaikkan DATETIME_FIELD_OUT_OF_BOUNDS. Gunakan try_make_timestamp untuk mengembalikan NULL sebagai gantinya.

Jika sec adalah 60, fungsi menginterpretasikannya sebagai 0 dan menambahkan satu menit ke hasilnya.

Jika sec memiliki nilai pecahan yang tidak dapat diwakili dalam presisi mikrodetik, Azure Databricks meningkatkan INVALID_FRACTION_OF_SECOND.

Kondisi kesalahan umum

Contoh

> SELECT make_timestamp(2014, 12, 28, 6, 30, 45.887);
 2014-12-28 06:30:45.887
> SELECT make_timestamp(2014, 12, 28, 6, 30, 45.887, 'CET');
 2014-12-27 21:30:45.887
> SELECT make_timestamp(2019, 6, 30, 23, 59, 60);
 2019-07-01 00:00:00
> SELECT make_timestamp(NULL, 7, 22, 15, 30, 0);
 NULL

> SELECT make_timestamp(DATE'2014-12-28', TIME'06:30:45.887');
 2014-12-28 06:30:45.887

> SELECT make_timestamp(DATE'2014-12-28', TIME'06:30:45.887', 'CET');
 2014-12-27 21:30:45.887

> SELECT make_timestamp(DATE'2014-12-28');
 2014-12-28 00:00:00

> SELECT make_timestamp(2024, 13, 1, 0, 0, 0);
  Error: DATETIME_FIELD_OUT_OF_BOUNDS