52 lines
2.3 KiB
Python
52 lines
2.3 KiB
Python
"""Время сервера: монотонные часы и формат RFC 3339.
|
|
|
|
`created_at` задаёт порядок истории `(created_at, id)`. Системные часы
|
|
могут шагнуть назад (NTP) или выдать одно значение двум записям подряд.
|
|
`MonotonicClock` отдаёт строго возрастающее время с шагом не меньше 1 мкс.
|
|
Хранилище берёт время у него перед вставкой. Процесс один, event loop
|
|
один, а `now()` не содержит `await`: два вызова не перемешаются.
|
|
|
|
Строгий рост — внутри одного процесса. Транзакции фиксируются не в том
|
|
порядке, в каком получили время, поэтому запись с меньшим `created_at`
|
|
может стать видимой чуть позже соседней (REPORT.md, «Пагинация»).
|
|
"""
|
|
|
|
from datetime import UTC, datetime, timedelta
|
|
|
|
# RFC 3339 в UTC: всегда шесть знаков микросекунд и суффикс Z
|
|
RFC3339_FORMAT = "%Y-%m-%dT%H:%M:%S.%fZ"
|
|
|
|
_TICK = timedelta(microseconds=1)
|
|
|
|
|
|
class MonotonicClock:
|
|
"""Строго возрастающее aware-время UTC.
|
|
|
|
Не потокобезопасен: вызывается только из event loop процесса.
|
|
"""
|
|
|
|
def __init__(self) -> None:
|
|
self._last: datetime | None = None
|
|
|
|
def now(self) -> datetime:
|
|
current = datetime.now(UTC)
|
|
if self._last is not None and current <= self._last:
|
|
current = self._last + _TICK
|
|
self._last = current
|
|
return current
|
|
|
|
|
|
def utc_now() -> datetime:
|
|
"""Текущее время UTC без монотонной поправки: для сравнения со сроком."""
|
|
return datetime.now(UTC)
|
|
|
|
|
|
def to_rfc3339(value: datetime) -> str:
|
|
"""Время для ответа API: `2026-09-01T12:00:00.000000Z`."""
|
|
return value.astimezone(UTC).strftime(RFC3339_FORMAT)
|
|
|
|
|
|
def from_rfc3339(value: str) -> datetime:
|
|
"""Обратно из `to_rfc3339()`: aware-время UTC с микросекундами."""
|
|
return datetime.strptime(value, RFC3339_FORMAT).replace(tzinfo=UTC)
|