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.

Diperbarui

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:

SatuanDigit21 Nov 2026 09.00 WIB
Detik101795226400
Milidetik131795226400000
Mikrodetik161795226400000000
Nanodetik191795226400000000000

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

  1. Buka Konversi Unix Timestamp. Bagian atas menampilkan Unix timestamp sekarang (detik) dan nilai Dalam milidetik, masing-masing dengan tombol Salin.
  2. 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.
  3. Baca hasilnya sebagai waktu lokal, UTC, ISO 8601, RFC 2822, atau waktu relatif, lalu salin baris yang diperlukan.
  4. 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?
Timestamp dihitung dari UTC. Sistem yang menampilkan hasil dalam UTC akan 7 jam lebih awal dari WIB, 8 jam dari WITA, dan 9 jam dari WIT. Lihat baris waktu lokal, atau pilih zona yang benar saat mengubah tanggal menjadi timestamp.
Apakah timestamp bisa negatif?
Bisa. Waktu sebelum 1 Januari 1970 bernilai negatif, misalnya -86400 untuk 31 Desember 1969 pukul 00.00 UTC. Sistem yang menyimpan timestamp sebagai bilangan tanpa tanda tidak bisa menyimpan tanggal sebelum 1970.
Apakah JavaScript aman dari masalah 2038?
Ya. 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?
Keduanya bisa, asalkan tidak ambigu. Timestamp perlu disertai satuannya, misalnya nama kolom created_at_ms. Tanggal ISO 8601 perlu menyertakan zona, seperti 2026-11-21T09:00:00+07:00 atau akhiran Z untuk UTC.