datetime di Python: tanggal, waktu, timedelta, dan zona waktu

Dua tipe inti: date dan datetime

Modul datetime memberimu empat hal yang perlu kamu tahu: date, time, datetime, dan timedelta. Tiga yang pertama sesuai namanya; yang keempat adalah rentang waktu.

from datetime import date, datetime, timedelta

today = date.today()
now = datetime.now()

print(today)
print(now)
print(type(today), type(now))

date mewakili satu hari (tahun, bulan, tanggal) tanpa jam. datetime adalah tanggal ditambah waktu. Kalau kamu tidak butuh jamnya, date adalah pilihan yang lebih rapi.

Membuat tanggal tertentu

Buat secara langsung:

from datetime import date, datetime

launch = date(2026, 1, 15)
meeting = datetime(2026, 1, 15, 14, 30)

print(launch)
print(meeting)

Argumennya adalah year, month, day untuk date, dan sampai year, month, day, hour, minute, second, microsecond untuk datetime.

Membaca field

Setiap date/datetime punya atribut:

from datetime import datetime

now = datetime(2026, 4, 20, 9, 30, 15)

print(now.year, now.month, now.day)
print(now.hour, now.minute, now.second)
print(now.weekday())        # 0 = Monday, 6 = Sunday
print(now.isoweekday())     # 1 = Monday, 7 = Sunday
print(now.isoformat())

isoformat() sangat membantu untuk output yang bisa dibaca mesin: hasilnya seperti "2026-04-20T09:30:15", yang bisa diurai sistem lain tanpa ambigu.

Memformat dengan strftime

Untuk output yang mudah dibaca manusia, .strftime(fmt) mengubah date atau datetime menjadi string yang sudah diformat:

from datetime import datetime

now = datetime(2026, 4, 20, 9, 30)

print(now.strftime("%Y-%m-%d"))          # 2026-04-20
print(now.strftime("%d %B %Y"))          # 20 April 2026
print(now.strftime("%I:%M %p"))          # 09:30 AM
print(now.strftime("%A, %d %b"))         # Monday, 20 Apr

Kode format yang paling sering perlu diingat:

• %Y: tahun 4 digit (2026)
• %m: nomor bulan, diawali nol (04)
• %d: tanggal dalam bulan, diawali nol (20)
• %H / %I: jam, format 24/12 jam
• %M: menit
• %S: detik
• %A / %a: nama hari lengkap / singkat (Monday / Mon)
• %B / %b: nama bulan lengkap / singkat (April / Apr)
• %p: AM/PM

Kamu tidak perlu menghafalnya; simpan sebuah referensi dan lihat saat kamu membutuhkannya.

Mengurai dengan strptime

Arah sebaliknya: ambil string dengan bentuk yang sudah diketahui lalu ubah menjadi datetime:

from datetime import datetime

text = "2026-04-20 09:30"
parsed = datetime.strptime(text, "%Y-%m-%d %H:%M")

print(parsed)
print(parsed.year, parsed.hour)

String format harus cocok persis dengan input. Kalau tidak, strptime memunculkan ValueError.

Untuk string ISO-8601 (standar yang bisa dibaca mesin), Python modern punya jalan pintas yang lebih sederhana:

from datetime import datetime

d = datetime.fromisoformat("2026-04-20T09:30:00")
print(d)

Kalau kamu berhadapan dengan format yang macam-macam, package luar dateutil (pip install python-dateutil) punya parser.parse() yang toleran dan mencoba menebak dengan masuk akal.

Aritmetika dengan timedelta

Untuk menghitung dengan tanggal, pakai timedelta untuk selisih atau pergeseran waktu:

from datetime import date, datetime, timedelta

today = date(2026, 4, 20)
next_week = today + timedelta(days=7)
yesterday = today - timedelta(days=1)

print(next_week, yesterday)

# Subtracting two dates gives you a timedelta.
gap = date(2027, 1, 1) - today
print(gap)
print(gap.days)

Argumen timedelta: days, seconds, microseconds, milliseconds, minutes, hours, weeks. Tidak ada months atau years, karena panjang bulan berbeda-beda. Untuk perhitungan bulan/tahun, pakai dateutil.relativedelta:

from dateutil.relativedelta import relativedelta
from datetime import date

today = date.today()
next_quarter = today + relativedelta(months=3)
print(next_quarter)

Zona waktu: naive vs aware

datetime tanpa info zona waktu disebut naive: Python tidak tahu zona waktu mana yang diwakilinya. Menghitung waktu dengan datetime naive tidak masalah selama kamu tetap di satu zona waktu yang logis; masalahnya mulai begitu data dari zona yang berbeda bertemu.

Datetime aware membawa info zona waktu. Tambahkan zona waktu secara eksplisit:

from datetime import datetime, timezone, timedelta

utc_now = datetime.now(timezone.utc)
print(utc_now)
print(utc_now.tzinfo)

Python 3.9 menambahkan modul zoneinfo untuk zona waktu bernama (memakai database IANA milik sistem):

from datetime import datetime
from zoneinfo import ZoneInfo

now_tokyo = datetime.now(ZoneInfo("Asia/Tokyo"))
now_ny = datetime.now(ZoneInfo("America/New_York"))

print(now_tokyo)
print(now_ny)
print(now_tokyo - now_ny)   # timedelta is zero-ish - same moment, different clocks

Konversi antar zona dengan .astimezone():

from datetime import datetime
from zoneinfo import ZoneInfo

utc = datetime(2026, 4, 20, 12, 0, tzinfo=ZoneInfo("UTC"))
berlin = utc.astimezone(ZoneInfo("Europe/Berlin"))

print(utc)
print(berlin)

Aturan yang perlu kamu ingat: simpan datetime dalam UTC, dan konversi ke zona lokal hanya saat ditampilkan. Satu kebiasaan itu mencegah sebagian besar bug zona waktu.

Timestamp

Unix timestamp adalah jumlah detik sejak 1970-01-01 UTC. Python mengonversinya dengan mudah:

from datetime import datetime, timezone

now = datetime.now(timezone.utc)
ts = now.timestamp()

print(ts)
print(datetime.fromtimestamp(ts, tz=timezone.utc))

Timestamp berguna untuk perbandingan, pengurutan, dan bertukar data dengan sistem lain. Untuk output yang dilihat manusia, ubah dulu kembali menjadi datetime.

Mengukur berapa lama sesuatu berjalan

Untuk pengukuran waktu yang cepat, kurangkan dua datetime:

from datetime import datetime
import time

start = datetime.now()
time.sleep(0.2)
elapsed = datetime.now() - start

print(elapsed.total_seconds())

Untuk pengukuran performa yang lebih serius, pakai time.perf_counter(): resolusinya di bawah satu mikrodetik dan tidak terpengaruh perubahan jam sistem. datetime.now() sudah cukup untuk angka seperti "berapa lama panggilan API ini".

Pola yang akan kamu pakai berulang kali

from datetime import date, datetime, timedelta, timezone

# Today's date in ISO format
print(date.today().isoformat())

# Age in years (roughly - not exact across leap years)
dob = date(1990, 7, 15)
days_old = (date.today() - dob).days
print(days_old // 365, "years old")

# Start of current hour in UTC
now = datetime.now(timezone.utc)
start_of_hour = now.replace(minute=0, second=0, microsecond=0)
print(start_of_hour)

# Seven days ago
print(date.today() - timedelta(days=7))

Yang perlu diingat

• date, datetime, dan timedelta mencakup 90% kebutuhan.
• Pakai ISO-8601 untuk output yang dibaca mesin; strftime untuk yang dibaca manusia.
• Simpan dalam UTC; konversi saat ditampilkan.
• Pakai zoneinfo untuk zona waktu bernama.
• Untuk bulan dan tahun, pakai dateutil.relativedelta.

Satu alat lagi untuk perlengkapan dunia nyatamu: regular expression, berikutnya.