Problem
README.md:812–813 correctly states:
Log timestamps use the host's local timezone and include its numeric offset by default.
But the example at README.md:865 shows:
2026-05-26 12:34:56 INFO path/to/file.py:42 message
No timezone offset. This directly contradicts the prose two paragraphs above it.
The actual datefmt in logging.py is "%Y-%m-%d %H:%M:%S %z" for local time, producing output like:
2026-05-26 12:34:56 -0400 INFO path/to/file.py:42 message
With LOG_UTC=1, the format is "%Y-%m-%d %H:%M:%S UTC", producing:
2026-05-26 16:34:56 UTC INFO path/to/file.py:42 message
Fix
Update the example at README.md:865 to include the timezone offset. Show both local and UTC variants if space allows, or add a note pointing to the LOG_UTC environment variable.
Problem
README.md:812–813correctly states:But the example at
README.md:865shows:No timezone offset. This directly contradicts the prose two paragraphs above it.
The actual
datefmtinlogging.pyis"%Y-%m-%d %H:%M:%S %z"for local time, producing output like:With
LOG_UTC=1, the format is"%Y-%m-%d %H:%M:%S UTC", producing:Fix
Update the example at
README.md:865to include the timezone offset. Show both local and UTC variants if space allows, or add a note pointing to theLOG_UTCenvironment variable.