Skip to content

call-datetime-fromtimestamp (DTZ006)

Added in v0.0.188 · Related issues · View source

Derived from the flake8-datetimez linter.

What it does

Checks for usage of datetime.datetime.fromtimestamp() that do not specify a timezone.

Why is this bad?

Python datetime objects can be naive or timezone-aware. While an aware object represents a specific moment in time, a naive object does not contain enough information to unambiguously locate itself relative to other datetime objects. Since this can lead to errors, it is recommended to always use timezone-aware objects.

datetime.datetime.fromtimestamp(ts) or datetime.datetime.fromtimestampe(ts, tz=None) returns a naive datetime object. Instead, use datetime.datetime.fromtimestamp(ts, tz=<timezone>) to create a timezone-aware object.

Example

import datetime

datetime.datetime.fromtimestamp(946684800)

Use instead:

import datetime

datetime.datetime.fromtimestamp(946684800, tz=datetime.timezone.utc)

Or, on Python 3.11 and later:

import datetime

datetime.datetime.fromtimestamp(946684800, tz=datetime.UTC)

References