discord-date-transformer

Reusable date and time transformers for discord.py application commands.

CI PyPI Python License: MIT

The package provides small, typed annotations that parse explicit temporal values in Discord slash commands. It intentionally avoids natural-language parsing.

Installation

pip install discord-date-transformer

Quick start

import discord
from discord import app_commands

from discord_date_transformer import (
    DurationTransform,
    ISODateTransform,
    TimeTransform,
)


@app_commands.command()
async def create_event(
    interaction: discord.Interaction,
    event_date: ISODateTransform,
    event_time: TimeTransform,
    duration: DurationTransform,
) -> None:
    await interaction.response.send_message(
        f"Event: {event_date} {event_time} ({duration})"
    )

Available transformers

Annotation Example input Return type Accepted syntax
ISODateTransform 2026-08-30 datetime.date Values accepted by date.fromisoformat()
ISODateTimeTransform 2026-08-30T18:30 datetime.datetime Values accepted by datetime.fromisoformat()
TimeTransform 18:30:45 datetime.time Values accepted by time.fromisoformat()
DurationTransform 2h datetime.timedelta One positive integer followed by s, m, h, d, or w

The concrete transformer classes are also public: ISODateTransformer, ISODateTimeTransformer, TimeTransformer, and DurationTransformer.

Duration syntax

Duration input uses exactly one unit and is case-sensitive:

Unit Meaning
s seconds
m minutes
h hours
d days
w weeks

Zero, negative, decimal, whitespace-padded, uppercase, and compound durations such as 1h30m are rejected in version 0.1.0.

Error handling

Invalid input raises discord.app_commands.TransformerError with the original parsing exception chained as its cause. This lets normal discord.py application command error handling process every parser failure consistently.

Requirements

  • Python 3.12 or newer
  • discord.py 2.7.1 or newer, below 3.0

Development

git clone https://github.com/ezer-mackenzie/discord-date-transformer.git
cd discord-date-transformer
uv sync --all-groups

Run the complete local checks:

uv run ruff check .
uv run ruff format --check .
uv run pytest
uv run mypy

See CONTRIBUTING.md for contribution and release instructions, SECURITY.md for private vulnerability reporting, and CHANGELOG.md for release history.

License

Released under the MIT License.

Project links

Data verified by PyPI on Aug 30, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for ezer-mackenzie from gravatar.com ezer-mackenzie

Credits

PyPI data
Data sourced directly from PyPI's database.

Author: Eli-ezer Reuven Ramirez Ruiz

GitHub Statistics

Data verified by PyPI on Aug 30, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.12

Tags

app-commands date datetime discord discord.py slash-commands transformer

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

discord_date_transformer-0.1.0.tar.gz (4.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

discord_date_transformer-0.1.0-py3-none-any.whl (6.7 kB view details)

Uploaded Python 3

File details

Details for the file discord_date_transformer-0.1.0.tar.gz.

File metadata

  • Download URL: discord_date_transformer-0.1.0.tar.gz
  • Upload date:
  • Size: 4.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for discord_date_transformer-0.1.0.tar.gz
Algorithm Hash digest
SHA256 00809dd5eb335cb7f89695f5596b2aa01864430f28f7be052ab15b21cf466172
MD5 4d3f620325298de73488b9a26919237e
BLAKE2b-256 365aa4ecb00615da4e113c09b159b8d98d21bdb01f5785512085b3096c62b9d0

See more details on using hashes here.

Provenance

The following attestation bundles were made for discord_date_transformer-0.1.0.tar.gz:

Publisher: publish.yml on ezer-mackenzie/discord-date-transformer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file discord_date_transformer-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for discord_date_transformer-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 71c0a4042dd811a755c76e331dca2b985f65c1a4d8e65332d011ecd6e9238058
MD5 b11a45965bf35d1b4e9250c4e3c4aaf3
BLAKE2b-256 011a0c025cf107948af0eb0fc46d3e2fcf952dd43320bea004cb11a4a587b97c

See more details on using hashes here.

Provenance

The following attestation bundles were made for discord_date_transformer-0.1.0-py3-none-any.whl:

Publisher: publish.yml on ezer-mackenzie/discord-date-transformer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.2.0

2 files

This release

0.1.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page