diff options
Diffstat (limited to 'webmentions_ssg/template_filters.py')
| -rw-r--r-- | webmentions_ssg/template_filters.py | 31 |
1 files changed, 31 insertions, 0 deletions
diff --git a/webmentions_ssg/template_filters.py b/webmentions_ssg/template_filters.py new file mode 100644 index 0000000..e6cac2d --- /dev/null +++ b/webmentions_ssg/template_filters.py @@ -0,0 +1,31 @@ +# SPDX-FileCopyrightText: 2026 Dennis Fink <me+coding@dennisfink.me> +# +# SPDX-License-Identifier: BSD-3-Clause + +"""Helpers for displaying UTC timestamps in templates.""" + +from datetime import UTC, datetime + +import humanize + + +def as_utc(value: datetime) -> datetime: + """Normalize a timestamp to UTC, treating timezone-naive DB values as UTC.""" + if value.tzinfo is None: + return value.replace(tzinfo=UTC) + return value.astimezone(UTC) + + +def utc_isoformat(value: datetime) -> str: + """Return an unambiguous machine-readable timestamp for the time element.""" + return as_utc(value).isoformat() + + +def utc_timestamp(value: datetime) -> str: + """Return the complete UTC timestamp for the hover tooltip.""" + return as_utc(value).strftime("%Y-%m-%d %H:%M:%S UTC") + + +def relative_time(value: datetime) -> str: + """Render a timestamp as a human-readable age relative to the current UTC time.""" + return humanize.naturaltime(datetime.now(UTC) - as_utc(value)) |
