from datetime import datetime, timezone def utcnow() -> datetime: return datetime.now(timezone.utc) def format_time(value: datetime) -> str: if value.tzinfo is None: value = value.replace(tzinfo=timezone.utc) return value.astimezone(timezone.utc).strftime("%Y-%m-%dT%H:%M:%S.%fZ") def parse_time(value: str) -> datetime: if not isinstance(value, str) or not value.endswith("Z"): raise ValueError("time") parsed = datetime.fromisoformat(value[:-1] + "+00:00") if parsed.tzinfo is None: raise ValueError("time") return parsed.astimezone(timezone.utc)