timedc 0.1.3

Утилита для генерации Discord timestamp

dctime

Утилита для генерации Discord timestamp с удобным синтаксисом для указания времени и формата отображения.

Установка

pip install timedc

Использование

from timedc import getTime

# Примеры:
print(getTime("10m"))      # через 10 минут
print(getTime("2h", "R")) # через 2 часа, формат "относительно"
print(getTime("3d", "f")) # через 3 дня, полная дата

Функции

getTime(duration: str, fmt: str = '') -> str

Генерация Discord timestamp.

Параметры:

• duration: строка с временем (например "10m", "2h", "3d").

  • s — секунды
  • m — минуты
  • h — часы
  • d — дни
  • w — недели

• fmt: формат отображения в Discord. Возможные значения:

  • t — короткое время
  • T — длинное время
  • d — короткая дата
  • D — длинная дата
  • f — короткая дата + время
  • F — полная дата + время
  • R — относительное время (например "через 5 минут")
  • Пустая строка — стандартное отображение

Возвращает:

Строку вида <t:UNIX:fmt> для вставки в Discord.

Примеры:

getTime("10m")      # <t:UNIX>
getTime("2h", "R") # <t:UNIX:R>
getTime("3d", "f") # <t:UNIX:f>

Ошибки

• Если передан неверный формат времени (например "10x" или "5"), выбрасывается ValueError.
• Если указан неверный формат отображения, выбрасывается ValueError.

Примечание

Этот пакет полезен для быстрого формирования timestamp'ов для сообщений Discord, поддерживающих динамическое отображение времени.