Quick Start

A brief overview of how to start using the bot.

How to add your Time Zone

Users can visit https://untimely.xyz/tz to add their time zone to Untimely automatically, pulling their systems local time. Or, they can manually specify by clicking the appropriate button and typing a time zone in the prompting modal.

Slash Commands

/autoconvert state: {on, off}

By default, this is turned on when the bot joins your server. If a server member has added their time zone to Untimely, when detected, Untimely will reply to their message with the time located, converted to all discord users local times.

/timestamp describe: {ex: Saturday at 6pm}

Available everywhere. This takes a sentence as an input and will use natural language processing to create a timestamp for you, and responds with an ephemeral message (only you can see) with the timestamps. You can then copy and paste them as need for an announcement or whatever purpose you need them for.

/time user: {discord user} time:{ex: 5pm}

Available everywhere. This command will return the current local time for the targeted user. If that user has not added their time zone within Untimely, it will let the user who called the command know.

using /time without giving a user will display your current local time.

This command takes an optional second parameter called time. When specified, it will convert the time specified, to your local time. Selecting yourself as an argument for this parameter will cause a bug saying "not a valid user" on mobile devices. Instead, use /time with no user argument given.

/sensitivity level: {High, Low}

This changes how sensitive the trigger is, for when the bot will react to a message containing a time. High means it is more sensitive to expression of time, low means it is less sensitive.

/privacy state: {Enable, Disable}

Turns Privacy Mode on or off. When enabled, users cannot use the /time command against you, and autoconversion will react with a greyscale untimely logo emote, showing that a time was detected, but the user has Privacy Mode enabled.

/format format:{Short time, Short date time, Long date time} relative:{On, Off}

This command takes 1 required argument "format" and 1 optional argument "relative". This allows a discord server to set their preferred timestamp format when the bot responds to messages. If you specify relative On, the bot will also include the relative timestamp difference with the detected datetime. Selecting off will remove it.

Commands (Non Slash Commands)

These are only available within discord servers.

$time

This command can be placed anywhere inside of a message, and will let the bot know that you want a time within that message to be converted. Ex: "I can't play till 5pm $time", "$time I'll be on at 8am".

using $time as the only content of a message will let Untimely know to check your previous message for a time. (this is for convenience incase you forgot to add $time to that message)

Note: This command usually is not necessary when a discord server has /autoconvert on.

$time welcome

This command can be used inside of a discord server, and will display the discord servers welcome message again, if it is needed.