mirror of
https://github.com/wassname/Open-Assistant.git
synced 2026-06-30 16:40:05 +08:00
Alex Ott
49 lines
1.1 KiB
Python
49 lines
1.1 KiB
Python
# -*- coding: utf-8 -*-
|
|
"""Utility functions."""
|
|
import typing as t
|
|
from datetime import datetime
|
|
|
|
import hikari
|
|
|
|
|
|
def format_time(dt: datetime, fmt: t.Literal["t", "T", "D", "f", "F", "R"]) -> str:
|
|
"""Format a datetime object into the discord time format.
|
|
|
|
```
|
|
| t | HH:MM | 16:20
|
|
| T | HH:MM:SS | 16:20:11
|
|
| D | D Mo Yr | 20 April 2022
|
|
| f | D Mo Yr HH:MM | 20 April 2022 16:20
|
|
| F | W, D Mo Yr HH:MM | Wednesday, 20 April 2022 16:20
|
|
| R | relative | in an hour
|
|
```
|
|
"""
|
|
match fmt:
|
|
case "t" | "T" | "D" | "f" | "F" | "R":
|
|
return f"<t:{dt.timestamp():.0f}:{fmt}>"
|
|
case _:
|
|
raise ValueError(f"`fmt` must be 't', 'T', 'D', 'f', 'F' or 'R', not {fmt}")
|
|
|
|
|
|
EMPTY = "\u200d"
|
|
"""Zero-width joiner.
|
|
|
|
This appears as an empty message in Discord.
|
|
"""
|
|
|
|
|
|
def mention(
|
|
id: hikari.Snowflakeish,
|
|
type: t.Literal["channel", "role", "user"],
|
|
) -> str:
|
|
"""Mention an object."""
|
|
match type:
|
|
case "channel":
|
|
return f"<#{id}>"
|
|
|
|
case "user":
|
|
return f"<@{id}>"
|
|
|
|
case "role":
|
|
return f"<@&{id}>"
|