datetime.md 1.3 KB


icon: package

label: datetime

datetime

Basic local dates and times, backed by time.localtime().

API Purpose
date(year, month, day) Store a calendar date.
date.today() Current local date.
datetime(year, month, day, hour, minute, second) Store date and time; all six arguments are required.
datetime.now() Current local date and time.
value.date() Extract a date from a datetime.
timedelta(days=0, seconds=0) Store days and seconds.
from datetime import date, datetime

deadline = date(2026, 10, 2)
meeting = datetime(2026, 10, 2, 9, 30, 0)
assert meeting.date() == deadline
assert str(meeting) == '2026-10-02 09:30:00'
assert date(2026, 10, 1) < deadline

Dates and datetimes support field access, string representations, and comparisons. This module does not implement timezone objects, parsing with strptime, formatting with strftime, microseconds, or date arithmetic. timedelta stores its two fields without CPython's normalization and arithmetic behavior. Validate calendar inputs in your application; the date constructor does not perform full calendar validation.

Implementation: datetime.py.