datetime dan time — Bekerja dengan Tanggal, Waktu, dan Elapsed Time

Artikel ini menelusuri tiga standard library yang menangani tanggal, waktu, dan elapsed time — datetime / time / calendar. Kamu akan melihat aritmetika tanggal dengan date / datetime / timedelta, konversi string dua arah dengan strftime / strptime, dan pengukuran elapsed time dengan time.perf_counter.

date / datetime / timedelta — Membuat Tanggal dan Menghitung Selisih

Saat kamu bekerja dengan tanggal di Python, kamu memilih dari tiga class di modul datetime. date menyimpan hanya tahun/bulan/hari, datetime menambahkan jam/menit/detik, dan timedelta merepresentasikan durasi seperti "3 hari" atau "2 jam". Desainnya simetris: date + timedelta memberimu "3 hari dari sekarang", dan date - date mengembalikan selisih antara dua tanggal sebagai timedelta.

from datetime import date, datetime, timedelta

# Buat tanggal
order_date = date(2024, 3, 15)
print(order_date)            # 2024-03-15

# Tiga hari kemudian
delivery = order_date + timedelta(days=3)
print(delivery)              # 2024-03-18

# Selisih antara dua tanggal adalah timedelta
elapsed = delivery - order_date
print(elapsed.days)          # 3

# Waktu saat ini
now = datetime.now()
print(now.year, now.month, now.day)

datetime.now dan Ketergantungan Lingkungan

datetime.now() mengembalikan waktu saat ini dari mesin yang menjalankan kode, jadi nilainya berubah setiap kali run entah kamu di runtime Pyodide browser atau mesin nyata. Latihan praktik memakai date(2024, 3, 15) tetap untuk menjaga reproducibility — coba now() terpisah di konsol untuk melihat perilakunya.

Hitung tanggal kirim (3 hari kemudian) dan tanggal jatuh tempo bayar (14 hari kemudian) dari tanggal pesanan 2024-03-15.

① Impor date dan timedelta dari datetime, lalu bangun tanggal pesanan date(2024, 3, 15).

② Hitung tanggal kirim = tanggal pesanan + timedelta(days=3) dan jatuh tempo bayar = tanggal pesanan + timedelta(days=14).

③ Cetak keduanya sebagai Ship date: ... dan Pay due: ....

Menghitung Selisih Antara Dua Tanggal

Mengurangkan satu tanggal dari yang lain mengembalikan objek timedelta. Atribut .days memberimu hanya jumlah hari, jadi pertanyaan seperti "berapa hari sampai X?" punya jawaban integer yang rapi.

Hitung berapa hari memisahkan tanggal kirim dan jatuh tempo bayar dari Latihan 1.

① Buat ulang tanggal pesanan, tanggal kirim, dan jatuh tempo bayar yang sama seperti di Latihan 1.

② Hitung pay_due - ship_date untuk mendapat timedelta, lalu baca atribut .days.

③ Cetak jumlah hari sebagai Interval: ... days.

strftime / strptime — Konversi Antara Tanggal dan String

Tanggal di dalam file, log, atau JSON hampir selalu datang sebagai string. Di Python, strftime (format time) mengubah datetime → string, dan strptime (parse time) mengubah string → datetime. Keduanya mengambil kode format yang memetakan simbol ke arti — %Y adalah tahun 4 digit, %m adalah bulan 2 digit, dan seterusnya.

from datetime import datetime

# string -> datetime
text = "2024-03-15 14:30:00"
dt = datetime.strptime(text, "%Y-%m-%d %H:%M:%S")
print(dt.year, dt.month, dt.day)   # 2024 3 15

# datetime -> string
dt2 = datetime(2024, 3, 15, 14, 30)
print(dt2.strftime("%Y/%m/%d"))               # 2024/03/15
print(dt2.strftime("%Y-%m-%d %H:%M"))          # 2024-03-15 14:30

Mismatch Format Memunculkan ValueError

Jika separator di stringmu tidak cocok dengan kode format — misalnya strptime("2024/03/15", "%Y-%m-%d") — kamu mendapat ValueError. Lihat format sebenarnya dari data inputmu dan luruskan tanda hubung dengan tanda hubung, slash dengan slash. Untuk string gaya ISO seperti "2024-03-15T14:30:00" yang mencampur tanda hubung dengan T dan titik dua, datetime.fromisoformat(text) lebih mudah.

Konversi string log timestamp "2024-03-15 14:30:45" menjadi objek datetime, lalu reformat berbeda.

① Impor class datetime dari modul datetime.

② Simpan string timestamp di atas dalam variabel.

③ Parse string menjadi objek datetime (kode format mencerminkan layout input). Lalu cetak Type: datetime memakai type(value).__name__.

④ Tarik tahun, bulan, dan hari dari datetime sebagai atribut (d.year / d.month / d.day) dan cetak sebagai Year: ... Month: ... Day: ....

⑤ Format datetime yang sama menjadi tahun/bulan/hari jam:menit (lepas detik). Cetak tipe nilai yang sudah diformat sebagai Formatted type: str dengan type(formatted).__name__, lalu cetak nilainya sebagai Formatted: ... (mengonfirmasi datetime → str).

time dan calendar — Mengukur Elapsed Time dan Memeriksa Bulan

Modul time terpisah dari datetime dan mengekspos API waktu tingkat lebih rendah. Yang paling sering kamu pakai adalah time.perf_counter(), counter resolusi tinggi yang mengembalikan elapsed time saat ini dalam detik (sebagai float). Panggil dua kali — sebelum dan sesudah — dan selisihnya adalah waktu eksekusimu. Modul calendar menarik informasi kalender seperti berapa hari satu bulan punya atau hari apa tanggal pertama bulan itu.

import time
import calendar

# Mengukur waktu eksekusi
start = time.perf_counter()
total = sum(range(100000))
elapsed = time.perf_counter() - start
print("Total:", total)
print("Type:", type(elapsed).__name__)   # float

# Info kalender
weekday, last_day = calendar.monthrange(2024, 2)   # (hari pertama bulan, hari terakhir)
print("Last day of Feb 2024:", last_day)
print("Leap year:", calendar.isleap(2024))

Mengapa Pakai perf_counter Alih-alih time.time

time.time() mengembalikan Unix timestamp (detik dengan pecahan), tapi jika jam mesin disesuaikan mundur oleh NTP, selisihnya bisa jadi negatif. time.perf_counter() dijamin monotonic (selalu meningkat) dan dirancang khusus untuk pengukuran elapsed time, jadi untuk timing gaya stopwatch ia pilihan yang tepat setiap saat.

Gabungkan pengukuran elapsed time dengan info bulan.

① Impor time dan calendar.

② Mulai stopwatch (pakai counter presisi tinggi untuk elapsed time).

③ Jumlahkan integer dari 0 sampai 49999.

④ Hitung elapsed time dan cetak Total: ... dan Elapsed >= 0 seconds: True (waktu nyata bervariasi menurut lingkungan, jadi kita hanya konfirmasi non-negatif).

⑤ Cetak hari terakhir Februari 2024 sebagai Feb end: ... days dan cek tahun kabisat sebagai Leap year: True / False.

time.sleep — Berhenti Selama Interval Tertentu

`time.sleep(seconds)` adalah fungsi yang menghentikan eksekusi selama jumlah detik yang diberikan. Muncul di mana-mana — interval retry, rate limiting, timing animasi. Argumennya float, jadi kamu bisa melewatkan pecahan seperti time.sleep(0.5). Karena latihan ini berjalan di browser, jaga sleep pendek (0–1 detik) untuk memverifikasi perilaku.

Hentikan eksekusi dengan `time.sleep` dan cek apakah elapsed time setidaknya 0.3 detik. Waktu nyata sedikit goyang menurut lingkungan, jadi kita memverifikasinya sebagai boolean — apakah setidaknya 0.3 detik?

① Impor time.

② Catat waktu mulai dengan time.perf_counter().

③ Tunggu 0.3 detik dengan time.sleep(0.3).

④ Hitung elapsed time sebagai time.perf_counter() - start_time dan cetak Elapsed >= 0.2 seconds: True / False memakai >= 0.2.

(Jika kamu menjalankannya dengan benar, penjelasan muncul di bawah.)