Kursus MariaDB / Menyimpan Tanggal dan Waktu: DATE, DATETIME, dan TIMESTAMP
DATE menyimpan tanggal, DATETIME menyimpan komponen tanggal dan jam kalender, sedangkan TIMESTAMP menyimpan waktu yang dikonversi menurut zona waktu koneksi. Tentukan apakah Anda memerlukan jam lokal atau satu saat terjadinya peristiwa sebelum memilih tipe; masukan yang sama dapat menghasilkan tampilan TIMESTAMP berbeda pada sesi yang berbeda.
Bedakan tanggal, jam lokal, dan saat terjadinya peristiwa
| Tipe | Contoh kegunaan | Perilaku zona waktu |
|---|---|---|
| DATE | Tanggal lahir atau tanggal reservasi | Tidak menyimpan jam atau identitas zona waktu |
| DATETIME | Komponen kalender seperti 2026-10-13 09:00:00 | Perubahan zona waktu sesi saja tidak mengonversi nilainya |
| TIMESTAMP | Peristiwa yang dicatat atau diterima | Mengonversi antara zona waktu sesi dan UTC saat nilai ditulis dan dibaca |
Waktu Universal Terkoordinasi atau Coordinated Universal Time (UTC) merupakan acuan bersama untuk membandingkan saat terjadinya peristiwa. Offset +09:00 berarti pukul 09.00 pada offset tersebut dan pukul 00.00 UTC pada tanggal yang sama menunjukkan satu saat yang sama. Menambahkan tulisan UTC ke teks tidak mengatur zona waktu koneksi basis data.
Nilai jam lokal DATETIME tidak dengan sendirinya menyimpan identitas zona wilayah atau aturan perubahan waktu musiman. Bergantung pada tujuannya, aplikasi dapat menormalkan nilai ke UTC atau menyimpan komponen lokal bersama pengenal zona. TIMESTAMP juga tidak menyimpan nama zona waktu asal masukan.
Periksa versi server dan zona waktu koneksi
Hubungkan sebagai course_user ke server latihan dengan basis data shopcourse tersedia. Panduan klien dan berkas SQL menjelaskan koneksi serta SOURCE. Jalankan pemeriksaan berikut di dalam koneksi, bukan di shell sistem operasi:
SELECT VERSION() AS server_version, DATABASE() AS selected_database;
USE shopcourse;
SELECT DATABASE() AS selected_database;
Basis data yang dipilih seharusnya shopcourse. Simpan contoh normal lengkap sebagai berkas UTF-8 berakhiran .sql dan jalankan dengan SOURCE serta jalur lokal sebenarnya. Pisahkan perintah yang sengaja gagal karena dapat menghentikan berkas. Gunakan instans belajar, bukan koneksi berisi data produksi.
SELECT @@SESSION.time_zone AS session_zone,
@@GLOBAL.time_zone AS global_zone,
@@system_time_zone AS system_zone;
SESSION berlaku untuk koneksi saat ini, sedangkan pengaturan global memberikan nilai bawaan bagi koneksi baru. SYSTEM ditafsirkan menurut zona waktu sistem operasi server; jangan menyimpulkan pengaturan koneksi hanya dari lokasi komputer. Latihan ini memakai offset +09:00 dan +00:00 secara eksplisit sehingga tidak memerlukan tabel zona waktu bernama.
Rentang tahun normal DATE dan DATETIME adalah 1000 hingga 9999, sedangkan batas atas TIMESTAMP bergantung pada versi server. Sebelum MariaDB 11.5, rentang biasa TIMESTAMP berakhir pada 2038-01-19 03:14:07 UTC; mulai 11.5, batas atasnya 2106-02-07 06:28:15 UTC. Batas bawahnya 1970-01-01 00:00:01 UTC, terpisah dari nilai nol khusus. Cocokkan SELECT VERSION() server Anda dengan batas TIMESTAMP menurut versi. Paket distribusi dan paket pengembang dapat berbeda versi.
Sisipkan sekali dan ubah hanya zona waktu sesi
Contoh time_lab lengkap memasukkan komponen kalender yang sama ke DATETIME dan TIMESTAMP, lalu mengubah satu pengaturan: zona waktu sesi. Kedua pengaturan sesi disimpan lebih dahulu. Deklarasi TIMESTAMP NULL DEFAULT NULL yang eksplisit menghindari ketergantungan pada nilai bawaan implisit kolom TIMESTAMP pertama yang berbeda menurut versi dan konfigurasi. Panduan definisi tabel menjelaskan pemeriksaan struktur tersimpan.
USE shopcourse;
SET @saved_sql_mode = @@SESSION.sql_mode;
SET SESSION sql_mode = 'STRICT_TRANS_TABLES';
SET @saved_time_zone = @@SESSION.time_zone;
SET SESSION time_zone = '+09:00';
CREATE TABLE time_lab (
item_id INT PRIMARY KEY,
event_date DATE NOT NULL,
wall_time DATETIME NOT NULL,
instant_time TIMESTAMP NULL DEFAULT NULL
) ENGINE=InnoDB;
INSERT INTO time_lab VALUES
(1, '2026-10-13', '2026-10-13 09:00:00', '2026-10-13 09:00:00');
SELECT item_id, event_date, wall_time, instant_time FROM time_lab;
SET SESSION time_zone = '+00:00';
SELECT item_id, event_date, wall_time, instant_time FROM time_lab;
SET SESSION time_zone = '+09:00';
SELECT item_id, wall_time, instant_time FROM time_lab;
| Zona waktu kueri | event_date | wall_time | instant_time |
|---|---|---|---|
| +09:00 setelah INSERT | 2026-10-13 | 2026-10-13 09:00:00 | 2026-10-13 09:00:00 |
| +00:00 | 2026-10-13 | 2026-10-13 09:00:00 | 2026-10-13 00:00:00 |
| +09:00 dikembalikan | 2026-10-13 | 2026-10-13 09:00:00 | 2026-10-13 09:00:00 |
Kolom TIMESTAMP tidak berubah menjadi dua peristiwa berbeda. Satu saat yang sama ditampilkan menurut dua offset koneksi. DATETIME mempertahankan komponen kalendernya. Periksa definisi DATETIME dan aturan konversi TIMESTAMP untuk menentukan perilaku yang dibutuhkan aplikasi.
Tentukan nilai otomatis dan pecahan detik dengan sengaja
Gunakan DEFAULT CURRENT_TIMESTAMP secara eksplisit jika kolom harus menerima waktu pembuatan secara otomatis. ON UPDATE CURRENT_TIMESTAMP merupakan pilihan terpisah untuk perubahan otomatis saat baris diperbarui. Kolom waktu perubahan terakhir tidak otomatis menunjukkan kapan peristiwa eksternal sebenarnya terjadi.
DATETIME(6) dan TIMESTAMP(6) menentukan presisi hingga enam digit pecahan detik. Angka 6 menjelaskan presisi di bawah satu detik, bukan rentang tahun atau panjang keseluruhan teks. Sesuaikan presisi kolom dan ekspresi nilai bawaan dengan sengaja; jangan menganggap setiap catatan membutuhkan mikrodetik.
Gunakan format yang tidak ambigu seperti YYYY-MM-DD dan YYYY-MM-DD HH:MM:SS. Teks yang bergantung pada kebiasaan wilayah seperti 10/11/26, atau tanggal yang disimpan sebagai teks sembarang, membuat konversi dan perbandingan lebih sulit dipastikan. Referensi DATE menjelaskan format serta rentangnya.
Telusuri tanggal tidak valid dan selisih zona waktu
Setelah berkas normal selesai, jalankan kesalahan yang disengaja ini secara terpisah pada koneksi mode ketat yang sama. Tanggal 30 Februari tidak ada:
INSERT INTO time_lab VALUES (2, '2026-02-30', '2026-10-13 09:00:00', NULL);
Anda seharusnya memperoleh kesalahan Incorrect date value, dengan satu baris tetap tersimpan dalam time_lab. Mode SQL memengaruhi penanganan tanggal tidak valid dan nilai nol. Mengubah mode hanya untuk melewati kesalahan dapat mengubah makna data. Dokumentasi mode SQL menjelaskan kondisinya.
Jika hasil kueri tiba-tiba berbeda sembilan jam, periksa tipe kolom dan @@SESSION.time_zone terlebih dahulu. Sebelum menjalankan UPDATE untuk menambah atau mengurangi sembilan jam, pastikan aplikasi dan koneksi tidak melakukan konversi dua kali.
Offset tetap tidak dapat mewakili seluruh riwayat perubahan waktu musiman suatu wilayah. Penanganan zona bernama memerlukan data zona waktu server yang sesuai serta kebijakan aplikasi. Latihan ini sengaja hanya menunjukkan konversi offset tetap.
Pulihkan pengaturan koneksi semula
SET SESSION time_zone = @saved_time_zone;
SET SESSION sql_mode = @saved_sql_mode;
SELECT @@SESSION.time_zone, @@SESSION.sql_mode;
Pulihkan pengaturan sesi pada koneksi yang sama dengan yang menyimpan variabel awal. Jika koneksi terputus, variabel tersebut tidak lagi berisi nilai sebelumnya. Periksa koneksi baru, bukan menerapkan variabel simpanan yang kosong.
Sebelum mengulang latihan, gunakan SELECT DATABASE() dan SHOW CREATE TABLE time_lab untuk memastikan sasarannya memang tabel latihan yang dibuat di sini. Cadangkan data yang perlu dipertahankan. Hanya setelah sasaran dipastikan, hapus dengan:
DROP TABLE shopcourse.time_lab;
Perintah ini menghapus tabel yang disebut beserta barisnya. DROP TABLE tidak dibalik dengan ROLLBACK biasa. Setelah itu, jalankan kembali contoh normal lengkap. Tabel products dari latihan produk pertama berada di luar cakupan pengaturan ulang ini.




