whenwords is a concise, open-source natural language scheduler that helps applications interpret date/time expressions (“tomorrow”, “next Friday at 3”, “in two hours”) in ordinary human language and convert them into precise scheduled events. It combines robust parsing logic with a flexible API so developers can embed scheduling understanding into chatbots, task managers, calendar tools, or productivity apps without building complex date interpreters from scratch. The library handles a wide range of expressions, time zones, and relative references, making it useful across different locales and contexts where users provide unconstrained scheduling input. It also includes utilities to validate, normalize, and format parsed results so applications can reliably present scheduled events and reminders in ways that match user expectations.
Features
- Natural language date/time interpretation engine
- Broad coverage of relative and absolute expressions
- Time zone awareness and normalization
- Validation and normalized scheduling output
- Easy API integration for apps and bots
- Multi-locale support for diverse users