Memahami Date dan Time dalam Python

Tanggal dan waktu merupakan bagian penting dalam berbagai aplikasi pemrograman. Sistem informasi sekolah memerlukan tanggal untuk mencatat kehadiran siswa, aplikasi penjualan membutuhkan waktu untuk merekam transaksi, sedangkan program pengingat memerlukan perhitungan waktu untuk menentukan kapan suatu kegiatan harus dilakukan. Tanpa pengelolaan tanggal dan waktu yang tepat, program dapat menghasilkan informasi yang tidak akurat atau mengalami kesalahan ketika melakukan perhitungan.

Sebelum lebih lanjut mempelajari materi tentang cara Memahami Data dan Time dalam Python, terlebih dahulu pelajari materi tentang: Memahami Decorator dalam Python, Memahami Property dalam Python, dan Memahami Regular Expression dalam Python.

Python menyediakan modul `datetime` untuk menangani berbagai kebutuhan yang berkaitan dengan tanggal, waktu, serta durasi. Modul ini memungkinkan pengembang memperoleh tanggal saat ini, membaca waktu, membuat objek tanggal tertentu, menghitung selisih hari, mengubah format tanggal, dan mengolah informasi waktu secara terstruktur.

Penggunaan modul `datetime` lebih tepat dibandingkan mengandalkan teks biasa untuk seluruh operasi tanggal dan waktu. Teks seperti `"20-10-2026"` hanya berupa rangkaian karakter, sedangkan objek tanggal dapat digunakan untuk melakukan perbandingan dan perhitungan berdasarkan kalender. Perbedaan tersebut menjadi dasar penting dalam membangun program yang mampu mengelola informasi waktu secara konsisten.

Artikel ini membahas konsep dasar modul `datetime`, jenis objek yang tersedia, fungsi-fungsi penting, pengaturan format, perhitungan durasi, serta contoh penerapannya dalam program Python.

Pengertian Modul datetime dalam Python

Modul `datetime` merupakan modul bawaan Python yang digunakan untuk membuat, menyimpan, membandingkan, dan memanipulasi data tanggal serta waktu. Modul ini menyediakan beberapa kelas utama, yaitu `date`, `time`, `datetime`, `timedelta`, dan `timezone`.

Setiap kelas memiliki fungsi yang berbeda. Kelas `date` digunakan untuk merepresentasikan tanggal, kelas `time` digunakan untuk merepresentasikan waktu dalam sehari, sedangkan kelas `datetime` menggabungkan informasi tanggal dan waktu. Kelas `timedelta` digunakan untuk merepresentasikan durasi atau selisih waktu, sementara `timezone` berkaitan dengan informasi zona waktu yang memiliki selisih tetap terhadap Waktu Universal Terkoordinasi (UTC).

Sebelum menggunakan fitur-fitur tersebut, modul perlu diimpor terlebih dahulu:
import datetime

Setelah diimpor, kelas di dalam modul dapat dipanggil menggunakan nama modul, misalnya `datetime.date` atau `datetime.datetime`. 

Alternatif lainnya adalah mengimpor kelas tertentu agar penulisan kode menjadi lebih ringkas:
from datetime import date, datetime, timedelta

Kedua pendekatan tersebut dapat digunakan sesuai kebutuhan dan gaya penulisan program.

Mengenal Kelas-Kelas dalam Modul datetime

Modul `datetime` memiliki sejumlah kelas yang mendukung pengelolaan tanggal, waktu, dan durasi. Pemahaman mengenai perbedaan setiap kelas akan membantu menentukan jenis objek yang sesuai dengan kebutuhan program.

Kelas	Fungsi	Contoh Penggunaan
date	Menyimpan informasi tahun, bulan, dan hari tanpa menyertakan waktu.	Mencatat tanggal lahir, tanggal kegiatan, atau tanggal pengumpulan tugas.
time	Menyimpan informasi jam, menit, detik, dan mikrodetik tanpa menyertakan tanggal.	Menentukan waktu mulai pelajaran, jadwal rapat, atau jam operasional.
datetime	Menyimpan informasi tanggal dan waktu dalam satu objek.	Mencatat waktu transaksi, waktu kehadiran, atau waktu pengiriman data.
timedelta	Merepresentasikan durasi atau selisih antara dua tanggal maupun waktu.	Menghitung selisih hari, menentukan tenggat waktu, atau memperkirakan lama kegiatan.
timezone	Merepresentasikan zona waktu dengan selisih tetap terhadap Waktu Universal Terkoordinasi (UTC).	Menentukan waktu dengan selisih zona waktu tertentu, seperti UTC+7 untuk WIB.

Kelima kelas tersebut saling melengkapi. Misalnya, program dapat menggunakan `datetime` untuk mencatat waktu peminjaman buku, `timedelta` untuk menghitung lama peminjaman, dan `date` untuk menentukan tanggal pengembalian.

Menggunakan date untuk Membuat Tanggal

Kelas `date` digunakan untuk membuat objek yang menyimpan informasi tahun, bulan, dan hari. Objek ini cocok digunakan ketika program hanya membutuhkan informasi tanggal tanpa memperhatikan jam atau menit.

Pembuatan objek `date` dilakukan dengan memberikan tiga argumen, yaitu tahun, bulan, dan hari:
from datetime import date
tanggal = date(2026, 10, 20)
print(tanggal)
print(tanggal.year)
print(tanggal.month)
print(tanggal.day)

Hasil program:
2026-10-20
2026
10
20

Pada contoh tersebut, `date(2026, 10, 20)` menghasilkan objek tanggal 20 Oktober 2026. Informasi tahun, bulan, dan hari dapat diakses melalui atribut `year`, `month`, dan `day`.

Python juga menyediakan fungsi `date.today()` untuk memperoleh tanggal lokal saat program dijalankan:
from datetime import date
hari_ini = date.today()
print(hari_ini)

Hasil program mengikuti tanggal lokal pada komputer yang menjalankan program.

Fungsi tersebut berguna ketika program perlu menampilkan tanggal saat ini, mencatat tanggal pendaftaran, atau membandingkan tanggal kegiatan dengan tanggal berjalan.

Menggunakan time untuk Menyimpan Waktu

Kelas `time` digunakan untuk menyimpan informasi waktu dalam sehari, meliputi jam, menit, detik, dan mikrodetik. Berbeda dengan `datetime`, objek `time` tidak menyimpan tanggal.

Contoh pembuatannya adalah sebagai berikut:
from datetime import time
waktu = time(14, 30, 45)
print(waktu)
print(waktu.hour)
print(waktu.minute)
print(waktu.second)

Hasil program:
14:30:45
14
30
45

Objek tersebut merepresentasikan pukul 14.30.45. Atribut `hour`, `minute`, dan `second` digunakan untuk memperoleh bagian waktu secara terpisah.

Kelas `time` dapat digunakan untuk menyimpan jadwal kegiatan, seperti waktu mulai pembelajaran, jadwal rapat, atau jam operasional. Namun, apabila program perlu mengetahui tanggal sekaligus waktu kegiatan, kelas `datetime` lebih sesuai.

Menggunakan datetime untuk Menggabungkan Tanggal dan Waktu

Kelas `datetime` menggabungkan informasi tanggal dan waktu dalam satu objek. Kelas ini banyak digunakan ketika program harus mencatat kapan suatu peristiwa terjadi secara lengkap.

Contohnya sebagai berikut:
from datetime import datetime
waktu_kegiatan = datetime(2026, 10, 20, 14, 30, 45)
print(waktu_kegiatan)
print(waktu_kegiatan.year)
print(waktu_kegiatan.month)
print(waktu_kegiatan.day)
print(waktu_kegiatan.hour)
print(waktu_kegiatan.minute)

Hasil program:
2026-10-20 14:30:45
2026
10
20
14
30

Objek `datetime` tersebut menyimpan tanggal 20 Oktober 2026 pukul 14.30.45. Informasinya dapat diakses menggunakan atribut yang berkaitan dengan tanggal dan waktu.

Untuk memperoleh tanggal dan waktu lokal saat program dijalankan, gunakan `datetime.now()`:
from datetime import datetime
sekarang = datetime.now()
print(sekarang)

Hasil program bergantung pada jam sistem dan zona waktu lokal komputer yang menjalankan kode.

Penggunaan `datetime.now()` bermanfaat untuk membuat catatan waktu otomatis, mencatat aktivitas pengguna, dan menampilkan waktu ketika suatu proses berlangsung.

Mengambil Bagian Tanggal dan Waktu

Objek `datetime` menyediakan sejumlah atribut yang memungkinkan setiap komponen tanggal dan waktu diakses secara terpisah.

Atribut	Fungsi	Contoh Nilai
year	Mengambil nilai tahun dari objek tanggal atau waktu.	2026
month	Mengambil nilai bulan, mulai dari 1 hingga 12.	10
day	Mengambil tanggal dalam bulan, mulai dari 1 hingga 31 sesuai bulan.	20
hour	Mengambil nilai jam dalam format 24 jam, dari 0 hingga 23.	14
minute	Mengambil nilai menit, mulai dari 0 hingga 59.	30
second	Mengambil nilai detik, mulai dari 0 hingga 59.	45
microsecond	Mengambil pecahan detik dalam satuan mikrodetik, mulai dari 0 hingga 999.999.	0

Atribut tersebut dapat dimanfaatkan ketika program hanya memerlukan bagian tertentu dari informasi tanggal dan waktu. Sebagai contoh, aplikasi laporan bulanan dapat mengambil atribut `month` dan `year` untuk mengelompokkan transaksi berdasarkan periode.

Berikut contoh penggunaannya:
from datetime import datetime
data = datetime(2026, 10, 20, 14, 30)
print("Tahun:", data.year)
print("Bulan:", data.month)
print("Tanggal:", data.day)
print("Jam:", data.hour)

Hasil program:
Tahun: 2026
Bulan: 10
Tanggal: 20
Jam: 14

Memformat Tanggal dan Waktu dengan strftime()

Informasi tanggal dan waktu sering perlu ditampilkan dalam format tertentu. Format bawaan objek `datetime` menggunakan bentuk tahun-bulan-hari, tetapi aplikasi mungkin memerlukan bentuk hari-bulan-tahun atau tampilan yang lebih mudah dibaca.

Python menyediakan metode `strftime()` untuk mengubah objek tanggal atau waktu menjadi teks berdasarkan format yang ditentukan.

Perhatikan contoh berikut:
from datetime import datetime
data = datetime(2026, 10, 20, 14, 30)
print(data.strftime("%d-%m-%Y"))
print(data.strftime("%H:%M"))
print(data.strftime("%d %B %Y"))

Hasil program:
20-10-2026
14:30
20 October 2026

Pada contoh tersebut, `%d` mewakili hari, `%m` mewakili bulan dalam angka, `%Y` mewakili tahun empat digit, `%H` mewakili jam dalam format 24 jam, dan `%M` mewakili menit. Sementara itu, `%B` menghasilkan nama bulan sesuai pengaturan lokal yang digunakan.

Beberapa kode format yang umum digunakan adalah sebagai berikut:

Kode	Makna	Contoh
%d	Menampilkan tanggal dalam bulan dengan dua digit.	20
%m	Menampilkan bulan dalam bentuk angka dengan dua digit.	10
%Y	Menampilkan tahun dengan empat digit.	2026
%y	Menampilkan tahun dengan dua digit.	26
%H	Menampilkan jam dalam format 24 jam, dari 00 hingga 23.	14
%I	Menampilkan jam dalam format 12 jam, dari 01 hingga 12.	02
%M	Menampilkan menit dengan dua digit.	30
%S	Menampilkan detik dengan dua digit.	45
%A	Menampilkan nama lengkap hari dalam bahasa yang digunakan sistem.	Tuesday
%a	Menampilkan nama singkat hari dalam bahasa yang digunakan sistem.	Tue
%B	Menampilkan nama lengkap bulan dalam bahasa yang digunakan sistem.	October
%b	Menampilkan nama singkat bulan dalam bahasa yang digunakan sistem.	Oct
%p	Menampilkan penanda waktu sebelum atau sesudah tengah hari dalam format 12 jam.	PM

Nama hari dan bulan bergantung pada pengaturan lokal yang berlaku. Oleh karena itu, hasilnya tidak selalu menggunakan bahasa Indonesia. Jika aplikasi membutuhkan nama hari atau bulan dalam bahasa Indonesia, pengaturan lokal atau pemetaan nama secara eksplisit dapat diperlukan.

Mengubah Teks Menjadi Objek Tanggal dengan strptime()

Selain mengubah objek tanggal menjadi teks, Python juga dapat mengubah teks menjadi objek tanggal atau waktu. Proses ini dilakukan menggunakan metode `strptime()`.

Metode tersebut berguna ketika data tanggal berasal dari formulir, berkas teks, atau masukan pengguna. Dengan mengubah teks menjadi objek `datetime`, program dapat melakukan perbandingan dan perhitungan berdasarkan tanggal.

Contohnya sebagai berikut:
from datetime import datetime
teks_tanggal = "20-10-2026"
tanggal = datetime.strptime(teks_tanggal, "%d-%m-%Y")
print(tanggal)
print(tanggal.year)
print(tanggal.month)
print(tanggal.day)

Hasil program:
2026-10-20 00:00:00
2026
10
20

Pola `%d-%m-%Y` menunjukkan bahwa teks terdiri atas hari, bulan, dan tahun empat digit yang dipisahkan dengan tanda hubung. Jika teks tidak sesuai dengan format atau memuat tanggal yang tidak valid, Python dapat menghasilkan `ValueError`.

Perbedaan penting antara `strftime()` dan `strptime()` adalah arah konversinya. `strftime()` mengubah objek tanggal atau waktu menjadi teks, sedangkan `strptime()` mengubah teks menjadi objek tanggal atau waktu.

Menghitung Selisih Waktu dengan timedelta

Kelas `timedelta` digunakan untuk merepresentasikan durasi atau selisih antara dua tanggal maupun waktu. Objek ini dapat digunakan untuk menambahkan atau mengurangi sejumlah hari, detik, menit, dan satuan durasi lainnya.

Contoh berikut menunjukkan cara menghitung selisih dua tanggal:
from datetime import date
tanggal_awal = date(2026, 10, 20)
tanggal_akhir = date(2026, 10, 30)
selisih = tanggal_akhir - tanggal_awal
print(selisih)
print(selisih.days)

Hasil program:
10 days, 0:00:00
10

Pengurangan kedua objek `date` menghasilkan objek `timedelta`. Atribut `days` digunakan untuk mengambil jumlah hari dalam selisih tersebut.

Selain menghitung selisih, `timedelta` dapat digunakan untuk menentukan tanggal beberapa hari setelah atau sebelum tanggal tertentu.
from datetime import date, timedelta
tanggal = date(2026, 10, 20)
tujuh_hari_lagi = tanggal + timedelta(days=7)
tiga_hari_sebelumnya = tanggal - timedelta(days=3)
print(tujuh_hari_lagi)
print(tiga_hari_sebelumnya)

Hasil program:
2026-10-27
2026-10-17

Teknik ini dapat diterapkan pada penghitungan batas waktu pengumpulan tugas, jadwal pengembalian buku, masa berlaku suatu dokumen, dan berbagai kebutuhan penjadwalan lainnya.

Perlu diperhatikan bahwa penambahan `timedelta(days=1)` berarti menambahkan satu hari kalender pada objek tanggal atau waktu, bukan selalu menambahkan tepat 24 jam waktu nyata ketika perhitungan melibatkan perubahan zona waktu.

Membandingkan Dua Tanggal

Objek tanggal dan waktu dapat dibandingkan menggunakan operator perbandingan, seperti `<`, `>`, `<=`, `>=`, dan `==`. Fitur ini memungkinkan program menentukan apakah suatu tanggal telah berlalu, apakah tenggat waktu sudah dekat, atau apakah sebuah kegiatan berlangsung sebelum kegiatan lainnya.

Contoh program:
from datetime import date

tenggat = date(2026, 10, 25)
tanggal_pemeriksaan = date(2026, 10, 20)

if tanggal_pemeriksaan < tenggat:
  print("Tenggat belum tercapai")
elif tanggal_pemeriksaan == tenggat:
  print("Hari ini adalah tenggat")
else:
  print("Tenggat telah berlalu")

Hasil program:
Tenggat belum tercapai

Perbandingan tanggal memudahkan pengambilan keputusan berdasarkan waktu. Dalam aplikasi nyata, nilai tanggal pemeriksaan dapat diperoleh dari `date.today()` sehingga kondisi diperbarui sesuai tanggal lokal saat program dijalankan.

Menentukan Hari dalam Seminggu

Python menyediakan metode `weekday()` dan `isoweekday()` untuk memperoleh nomor hari dalam seminggu dari suatu objek tanggal.

Metode `weekday()` menggunakan angka 0 untuk Senin hingga 6 untuk Minggu. Sementara itu, `isoweekday()` menggunakan angka 1 untuk Senin hingga 7 untuk Minggu.
from datetime import date
tanggal = date(2026, 10, 20)
print(tanggal.weekday())
print(tanggal.isoweekday())

Hasil program:
1
2

Tanggal 20 Oktober 2026 jatuh pada hari Selasa. Karena itu, `weekday()` menghasilkan `1`, sedangkan `isoweekday()` menghasilkan `2`.

Informasi ini berguna ketika program perlu membedakan hari kerja dan akhir pekan, menyusun jadwal pembelajaran, atau menentukan kegiatan yang hanya berlangsung pada hari tertentu.

Mengenal Zona Waktu

Zona waktu menentukan hubungan antara waktu lokal dan UTC. Dalam aplikasi yang melibatkan pengguna dari wilayah berbeda, penggunaan zona waktu menjadi penting agar waktu suatu peristiwa tidak ditafsirkan secara keliru.

Python menyediakan kelas `timezone` untuk merepresentasikan zona waktu dengan selisih tetap terhadap UTC. Sebagai contoh, Waktu Indonesia Barat (WIB) memiliki selisih UTC+7.
from datetime import datetime, timezone, timedelta
zona_wib = timezone(timedelta(hours=7))
waktu = datetime(
2026, 10, 20, 14, 30,
tzinfo=zona_wib
)
print(waktu)
print(waktu.utcoffset())

Hasil program:
2026-10-20 14:30:00+07:00
7:00:00

Atribut `tzinfo` digunakan untuk menyertakan informasi zona waktu pada objek `datetime`. Metode `utcoffset()` memberikan selisih waktu terhadap UTC.

Contoh tersebut menggunakan zona waktu dengan selisih tetap. Untuk aplikasi yang membutuhkan penanganan aturan zona waktu berdasarkan wilayah dan perubahan historis, modul `zoneinfo` lebih sesuai karena dapat memanfaatkan basis data zona waktu. Dalam pengolahan waktu lintas wilayah, informasi zona waktu sebaiknya ditentukan secara eksplisit agar perbandingan dan konversi waktu lebih dapat diandalkan.

Contoh Penerapan datetime dalam Sistem Pengumpulan Tugas

Modul `datetime` dapat digunakan untuk memeriksa apakah tugas dikumpulkan sebelum tenggat waktu. Contoh berikut memperlihatkan perbandingan tanggal pengumpulan dengan tanggal batas yang telah ditentukan.
from datetime import date
tanggal_pengumpulan = date(2026, 10, 22)
tenggat = date(2026, 10, 25)

if tanggal_pengumpulan <= tenggat:
  print("Tugas dikumpulkan tepat waktu")
else:
  print("Tugas terlambat")

Hasil program:
Tugas dikumpulkan tepat waktu

Operator `<=` berarti tanggal pengumpulan harus lebih awal atau sama dengan tanggal tenggat. Jika tanggal pengumpulan melampaui tenggat, program akan menampilkan pesan bahwa tugas terlambat.

Contoh ini dapat dikembangkan dengan mengambil tanggal dari masukan pengguna, menyimpan waktu pengumpulan hingga jam dan menit, serta menghitung berapa hari keterlambatan yang terjadi. Dengan demikian, modul `datetime` membantu mengubah aturan waktu menjadi logika program yang dapat dijalankan secara konsisten.

Kesalahan yang Perlu Dihindari

Penggunaan modul `datetime` memerlukan perhatian terhadap beberapa hal agar hasil perhitungan tidak keliru.

• Pertama, urutan tahun, bulan, dan hari pada saat membuat objek `date` atau `datetime` perlu ditulis dengan benar. Misalnya, `date(2026, 10, 20)` berarti tanggal 20 Oktober 2026, bukan tanggal 10 Februari atau bentuk lain.
• Kedua, teks tanggal perlu dipasangkan dengan format `strptime()` yang sesuai. Teks `20-10-2026` tidak menggunakan format yang sama dengan `2026/10/20`, sehingga pola konversinya juga harus berbeda.
• Ketiga, objek tanggal tidak selalu dapat diperlakukan seperti teks biasa. Jika dua tanggal perlu dibandingkan atau dikurangkan, keduanya sebaiknya dikonversi menjadi objek tanggal terlebih dahulu.
• Keempat, zona waktu perlu diperhatikan ketika program melibatkan waktu dari beberapa wilayah. Objek `datetime` tanpa informasi zona waktu disebut *naive*, sedangkan objek yang memiliki informasi zona waktu memadai disebut *aware*. Pencampuran kedua jenis objek tersebut dalam operasi perbandingan dapat menimbulkan kesalahan. Oleh karena itu, aplikasi yang menangani waktu lintas wilayah sebaiknya menerapkan aturan zona waktu secara konsisten.
• Kelima, hasil format tanggal dapat dipengaruhi pengaturan lokal. Jika program membutuhkan format yang konsisten untuk pertukaran data, format numerik yang jelas, seperti `YYYY-MM-DD`, dapat lebih sesuai daripada nama hari atau bulan yang bergantung pada bahasa.

Kesimpulan

Modul `datetime` merupakan bagian penting dalam pemrograman Python karena menyediakan sarana untuk membuat, membaca, membandingkan, memformat, dan menghitung tanggal serta waktu. Kelas `date`, `time`, dan `datetime` digunakan untuk merepresentasikan informasi kalender dan waktu, sedangkan `timedelta` mendukung perhitungan durasi dan selisih waktu. Kelas `timezone` membantu menangani zona waktu dengan selisih tetap terhadap UTC.

Metode seperti `strftime()` dan `strptime()` memudahkan konversi antara objek tanggal dan teks. Sementara itu, operator perbandingan dan operasi aritmetika memungkinkan program menentukan tenggat, menghitung lama kegiatan, dan menyusun jadwal secara otomatis.

Penguasaan modul `datetime` membantu pengembang membangun aplikasi yang lebih akurat dan terstruktur. Namun, ketepatan hasil tetap bergantung pada penggunaan format yang sesuai, pemilihan jenis objek yang tepat, serta penanganan zona waktu secara cermat. Dengan memahami konsep-konsep tersebut, pengolahan tanggal dan waktu dalam Python dapat dilakukan secara lebih efektif dan dapat diandalkan.

Artikel ini akan dibaca oleh: Hanik Arifah, Haninda Cahya Ramadhani, Hikmal Adi Wibowo, Hindatul Lailiyah, dan Intan Junita.

Location: Kota Semarang, Jawa Tengah, Indonesia

Berbagi :