import re from datetime import datetime, timezone from typing import Optional import arrow def dt_now() -> datetime: """Return the current datetime in UTC.""" return datetime.now(timezone.utc) def dt_utc(year: int, month: int, day: int, hour: int = 0, minute: int = 0, second: int = 0, microsecond: int = 0) -> datetime: """Return a datetime in UTC.""" return datetime(year, month, day, hour, minute, second, microsecond, tzinfo=timezone.utc) def dt_ts(dt: Optional[datetime] = None) -> int: """ Return dt in ms as a timestamp in UTC. If dt is None, return the current datetime in UTC. """ if dt: return int(dt.timestamp() * 1000) return int(dt_now().timestamp() * 1000) def dt_floor_day(dt: datetime) -> datetime: """Return the floor of the day for the given datetime.""" return dt.replace(hour=0, minute=0, second=0, microsecond=0) def dt_from_ts(timestamp: float) -> datetime: """ Return a datetime from a timestamp. :param timestamp: timestamp in seconds or milliseconds """ if timestamp > 1e10: # Timezone in ms - convert to seconds timestamp /= 1000 return datetime.fromtimestamp(timestamp, tz=timezone.utc) def shorten_date(_date: str) -> str: """ Trim the date so it fits on small screens """ new_date = re.sub('seconds?', 'sec', _date) new_date = re.sub('minutes?', 'min', new_date) new_date = re.sub('hours?', 'h', new_date) new_date = re.sub('days?', 'd', new_date) new_date = re.sub('^an?', '1', new_date) return new_date def dt_humanize(dt: datetime, **kwargs) -> str: """ Return a humanized string for the given datetime. :param dt: datetime to humanize :param kwargs: kwargs to pass to arrow's humanize() """ return arrow.get(dt).humanize(**kwargs)