Daftar Referensi Python

timedelta merepresentasikan selisih atau durasi waktu. Dengannya kamu bisa menghitung “berapa hari lagi”, menambah/mengurangi tanggal, dan mengukur jarak antara dua waktu. Bagian dari modul datetime.

Sintaks

from datetime import timedelta

timedelta(days=7, hours=3, minutes=30)

Parameter

Parameter Wajib? Keterangan
days, hours, minutes, seconds Tidak Komponen durasi, default 0. Boleh negatif
weeks, milliseconds, microseconds Tidak Komponen tambahan (weeks = 7 hari)

Catatan: tidak ada parameter months atau years — panjang bulan/tahun tidak tetap.

Contoh

from datetime import date

mulai = date(2026, 7, 11)
ujian = date(2026, 8, 17)

sisa = ujian - mulai
print(sisa.days)

Coba di IDE

Output:

37

Selisih dua tanggal otomatis menghasilkan objek timedelta — ambil .days untuk angkanya.

Contoh Lainnya

Menambah dan mengurangi waktu

from datetime import datetime, timedelta

t = datetime(2026, 7, 11, 8, 0)
print(t + timedelta(hours=3, minutes=30))
print(t - timedelta(days=7))

Coba di IDE

Output:

2026-07-11 11:30:00
2026-07-04 08:00:00

Durasi dan total detik

from datetime import timedelta

durasi = timedelta(days=2, hours=5)
print(durasi)
print(durasi.total_seconds())

Coba di IDE

Output:

2 days, 5:00:00
190800.0

Kesalahan Umum

  • timedelta(months=1) → TypeError — tidak ada parameter bulan/tahun. Pakai days=30 (perkiraan) atau library tambahan.
  • Mengira hasil selisih tanggal berupa angka — hasilnya objek timedelta; angka harinya ada di .days.
  • .days membulatkan ke bawah untuk selisih ber-jam; kalau butuh presisi, pakai .total_seconds().

Pelajari Lebih Lanjut

← strftime()datetime.strptime() →