Published Oct 6, 2021Updated Jun 7, 2022
Contribute to Docs

Python has a built-in module called datetime that can be used to create and modify datetime objects.

Because the module comes built-in with Python, installation is not required, but we do need to import it at the top of a Python file.


import datetime

Creating datetime Objects

The datetime module has three main types available:

  • date: Returns a date in the year-month-day format.
  • time: Returns a time in the hour-minute-second format with optional microsecond and timezone information.
  • datetime: Returns a date and time in the year-month-day and hour-minute-second formats.

Durations between any of these types can be returned by the .timedelta() method.


Returns a new object with date and time properties.
Returns the current date and timestamp.
Returns the seconds elapsed since the epoch.
Returns a date object in the year-month-day format.
Returns a duration, resolved to microseconds, that occurs between dates, times, and datetimes.

All contributors

Looking to contribute?

Learn Python on Codecademy