Unix timestamp: cara kerja, zona waktu, dan jebakannya
Angka seperti 1795226400 muncul di log server, database, dan respons API. Panduan ini menjelaskan cara membacanya, kenapa angka itu sama di Jakarta dan di London, dan di mana konversinya biasanya salah.
Hitungan detik sejak 1970
Unix timestamp adalah jumlah detik sejak epoch, yaitu 1 Januari 1970 pukul 00:00:00 UTC. Standar POSIX mendefinisikannya dengan rumus kalender di mana setiap hari dihitung tepat 86.400 detik. Contohnya, 1795226400 adalah 21 November 2026 pukul 02:00:00 UTC, atau 09.00 WIB. Waktu sebelum 1970 bernilai negatif: -86400 adalah 31 Desember 1969 pukul 00.00 UTC.
Karena hanya berupa satu bilangan bulat, timestamp mudah disimpan, dibandingkan, dan dikurangi. Selisih dua timestamp adalah jarak waktunya dalam detik, tanpa perlu memikirkan panjang bulan atau tahun kabisat.
Detik atau milidetik
Banyak sistem menyimpan epoch dalam satuan yang lebih halus. Cara tercepat mengenalinya adalah jumlah digit. Untuk tanggal antara 9 September 2001 dan 20 November 2286, timestamp detik selalu 10 digit:
| Satuan | Digit | 21 Nov 2026 09.00 WIB |
|---|---|---|
| Detik | 10 | 1795226400 |
| Milidetik | 13 | 1795226400000 |
| Mikrodetik | 16 | 1795226400000000 |
| Nanodetik | 19 | 1795226400000000000 |
Date.now() di JavaScript dan System.currentTimeMillis() di Java memberi milidetik; time() di PHP memberi detik. time.time() di Python memberi detik dengan pecahan, misalnya 1795226400.25, dan UnixNano() di Go memberi nanodetik. Kesalahan yang paling sering adalah mencampur keduanya. Milidetik yang dibaca sebagai detik menjadi tahun 58858, sedangkan detik yang dibaca sebagai milidetik menjadi 21 Januari 1970. Kalau tanggal di layar muncul sebagai Januari 1970, hampir pasti satuannya tertukar.
Timestamp tidak punya zona waktu
Satu timestamp menunjuk satu saat yang sama di seluruh dunia. Zona waktu baru berperan saat angka itu ditampilkan sebagai jam dinding. 1795226400 adalah 09.00 WIB, 10.00 WITA, 11.00 WIT, dan 02.00 di London. Indonesia tidak memakai jam musim panas, tetapi banyak negara memakainya, sehingga selisih Jakarta ke London atau New York berubah dua kali setahun.
Aturan praktisnya: simpan waktu sebagai timestamp atau UTC, lalu ubah ke zona pengguna hanya saat ditampilkan. Pakai nama zona IANA seperti Asia/Jakarta, Asia/Makassar, atau Asia/Jayapura, bukan selisih tetap +7, agar aturan jam musim panas di negara lain ikut terhitung.
Waspadai teks tanggal tanpa zona. Di JavaScript, new Date('2026-11-21') dibaca sebagai tengah malam UTC, sedangkan new Date('2026-11-21T09:00') dibaca sebagai jam lokal perangkat. Dua baris yang mirip itu menghasilkan acuan zona yang berbeda.
Detik kabisat
UTC sesekali menyisipkan detik kabisat agar tetap dekat dengan rotasi bumi. Sejak 1972 sudah 27 kali; yang terakhir adalah 23:59:60 UTC pada 31 Desember 2016, dan sejak itu UTC tertinggal 37 detik dari waktu atom TAI. Unix time mengabaikan detik kabisat karena setiap hari dihitung tepat 86.400 detik. Akibatnya, selisih dua timestamp yang mengapit akhir 2016 satu detik lebih pendek daripada waktu yang benar-benar berlalu. Saat detik kabisat terjadi, sistem mengulang satu detik atau menyebarnya; server NTP publik Google, misalnya, memperlambat jam selama 24 jam dari tengah hari ke tengah hari UTC.
Detik kabisat berikutnya belum dijadwalkan. Buletin C IERS edisi Juli 2026 menyatakan tidak ada detik kabisat di akhir Desember 2026, dan Konferensi Umum untuk Berat dan Ukuran (CGPM) pada 2022 memutuskan batas selisih UT1−UTC dinaikkan paling lambat 2035, dengan tujuan UTC tidak perlu disela setidaknya selama seratus tahun.
Masalah tahun 2038
Sistem lama menyimpan timestamp sebagai bilangan 32 bit bertanda, yang maksimalnya 2.147.483.647: 19 Januari 2038 pukul 03:14:07 UTC, atau 10.14.07 WIB. Satu detik kemudian nilainya berbalik menjadi −2.147.483.648, yang terbaca sebagai 13 Desember 1901. Bilangan 32 bit tanpa tanda bertahan sampai 7 Februari 2106, dan 64 bit praktis tidak terbatas.
Batas itu masih ada di banyak tempat. Kolom TIMESTAMP di MySQL hanya menerima sampai 2038-01-19 03:14:07 UTC, sedangkan DATETIME sampai tahun 9999. Masalahnya juga tidak menunggu 2038: tenor kredit 15 tahun yang dimulai hari ini berakhir pada 2041, dan aplikasi yang menghitung jadwal angsurannya sudah melewati batas itu sekarang.
Konversi di berbagai bahasa
JavaScript:
Math.floor(Date.now() / 1000) // sekarang
const d = new Date(1795226400 * 1000);
d.toISOString();
// '2026-11-21T02:00:00.000Z'
d.toLocaleString('id-ID',
{ timeZone: 'Asia/Jakarta' });
// '21/11/2026, 09.00.00'
Date.parse('2026-11-21T09:00:00+07:00')
/ 1000; // 1795226400
Python 3.9 ke atas:
from datetime import datetime
from zoneinfo import ZoneInfo
jkt = ZoneInfo('Asia/Jakarta')
datetime.fromtimestamp(1795226400, jkt)
# 2026-11-21 09:00:00+07:00
dt = datetime(2026, 11, 21, 9, 0,
tzinfo=jkt)
int(dt.timestamp()) # 1795226400
PHP, SQL, dan terminal:
// PHP
$d = new DateTime('@1795226400');
$d->setTimezone(
new DateTimeZone('Asia/Jakarta'));
echo $d->format('c');
// 2026-11-21T09:00:00+07:00
-- PostgreSQL
SELECT to_timestamp(1795226400);
-- MySQL, memakai zona waktu sesi
SELECT FROM_UNIXTIME(1795226400);
date +%s # sekarang
date -u -d @1795226400 # Linux
date -u -r 1795226400 # macOS
Mengonversi di swift.id
- Buka Konversi Unix Timestamp. Bagian atas menampilkan Unix timestamp sekarang (detik) dan nilai Dalam milidetik, masing-masing dengan tombol Salin.
- Tempel angka di kolom Unix timestamp. Pada satuan Otomatis, angka di bawah 1011 dibaca sebagai detik, di bawah 1014 milidetik, di bawah 1017 mikrodetik, dan sisanya nanodetik. Pilih satuan sendiri kalau tebakannya salah. Angka berpecahan seperti keluaran Python dan angka dengan pemisah ribuan juga diterima.
- Baca hasilnya sebagai waktu lokal, UTC, ISO 8601, RFC 2822, atau waktu relatif, lalu salin baris yang diperlukan.
- Untuk arah sebaliknya, isi Tanggal dan Jam di bagian Tanggal ke timestamp, lalu pilih Zona waktu: WIB, WITA, WIT, UTC, atau zona perangkat Anda.
Timestamp juga tersimpan di dalam UUID versi 7; panduan UUID v4 dan v7 menunjukkan cara membacanya.
Pertanyaan umum
Kenapa hasil konversi saya selisih 7 jam?
Apakah timestamp bisa negatif?
Apakah JavaScript aman dari masalah 2038?
Date di JavaScript menyimpan milidetik sebagai bilangan pecahan 64 bit (double) dan menjangkau sampai tahun 275760. Masalah muncul kalau nilai itu dikirim ke kolom database atau program lain yang masih 32 bit.Sebaiknya API memakai timestamp atau tanggal ISO 8601?
created_at_ms. Tanggal ISO 8601 perlu menyertakan zona, seperti 2026-11-21T09:00:00+07:00 atau akhiran Z untuk UTC.