A Telegram timezone bot that converts one time for everyone in the chat
Scheduling across zones fails in a specific way: somebody writes a time, everybody else silently assumes it is theirs, and one person joins an hour early. Posting UTC helps and nobody does it, because converting in your head is exactly the friction that caused the problem.
WhenIsItBot removes the conversion step from the conversation. Each member runs /tz once. After that, any time written into the chat can be expanded into a card showing that same moment in every zone the group actually contains, plus UTC, in one message everyone reads the same way.
Where the zones come from
The zone list is not configured, it is discovered. Whoever has run /tz in that chat contributes their zone, duplicates are collapsed, and the card shows the distinct set, up to twelve, with UTC alongside. A group of nine people spread over four countries produces a four-line card, not a nine-line one.
Daylight saving is computed at the moment you ask, through the platform's own timezone database, not stored as a fixed offset. That matters twice a year, when a hardcoded offset quietly becomes wrong for half the participants and nobody notices until somebody misses a call.
Zones can be given as IANA names (Europe/Warsaw, America/New_York), as the common abbreviations (UTC, GMT, CET, CEST, EST, EDT, PST, PDT, IST, JST, AEST), or as a plain offset like +2 or -5:30.
Inline mode works in any chat, including ones the bot has never been added to: type the bot's username followed by a time and it posts a one-off conversion card there.
?start=zovo so arrivals from this page are counted separately.Getting a group onto it
- Add the bot. No admin rights required. It only answers its own commands.
- Everyone runs /tz once. /tz Europe/Warsaw, or /tz CET, or /tz +2. This is per person and carries across every group the bot is in.
- Ask a question. /when 3pm tomorrow returns the card. /now does the same for the current moment.
- Save the zones you keep reusing. /preset add Asia/Tokyo keeps a zone under your account. Free holds three.
- Or use it without adding it. Type the bot's username and a time in any chat for a one-off conversion, with no membership and no setup.
Command reference
| Command | What it does |
|---|---|
| /tz Europe/Warsaw | Save your zone. IANA name, common abbreviation, or a plain offset. |
| /when 3pm tomorrow | Convert a time to every zone set by members of this chat, plus UTC. |
| /now | The current moment in the same set of zones. |
| /preset add Asia/Tokyo | Save a zone under your account. Free holds three. |
| /team add core Europe/Warsaw America/New_York | Pro: a named zone set the whole group can reuse. |
Free and Pro
Free
- 3 saved preset zones
- Unlimited /when and /now in any group
- Inline conversion against a default set of zones
Pro
- Unlimited saved preset zones
- Inline results built from your own presets instead of the defaults
- /team, a named zone set the whole group reuses
Pro is per person, one-time 150 Stars. Free presets are saved but not pulled into inline results; that connection is the Pro part.
What it stores
- Your saved zone and preset zones, under your user id.
- Named /team sets, stored against the group, for Pro groups.
- No message content. Nothing is stored except the zone names or offsets you explicitly save, and the DST offsets are computed live rather than kept.
Questions
- How many zones fit on one card?
- Every distinct zone set by members of that chat, deduplicated, capped at twelve, plus UTC.
- What does it do in a private chat?
- It shows your own zone only. The multi-zone card needs a group, because the group is where the other zones come from.
- Is daylight saving handled?
- Yes, and live. Offsets are resolved at the time of the query rather than stored, so a card is correct on both sides of a clock change.
- Can I use it in a chat where the bot is not a member?
- Yes. Inline mode posts a one-off card into any chat. A guest has no saved zone, so it reads as UTC plus a small default set.
- What is /team for?
- A recurring set of zones that is not the same as the group's membership: a client's hours, or three offices you always schedule against.
Other Telegram bots in this set
All of them are listed alongside the rest of Zovo's free online tools, and the browser-side half of the catalogue is under Chrome extensions.
Want the step-by-step walkthrough? Read Time zones across a distributed team: the full guide on tg.zovo.one.