https://github.com/rardevelopment/timezone-bot-dotnet
A Discord Bot for easily converting times in a Discord server. It can also remind you about birthdays!
https://github.com/rardevelopment/timezone-bot-dotnet
active
Last synced: about 1 year ago
JSON representation
A Discord Bot for easily converting times in a Discord server. It can also remind you about birthdays!
- Host: GitHub
- URL: https://github.com/rardevelopment/timezone-bot-dotnet
- Owner: rarDevelopment
- License: agpl-3.0
- Created: 2022-12-12T01:23:21.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-03-02T03:04:36.000Z (over 1 year ago)
- Last Synced: 2025-03-02T04:18:48.774Z (over 1 year ago)
- Topics: active
- Language: C#
- Homepage: https://rardk.com/bots
- Size: 140 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# TimeZoneBot
TimeZoneBot has 2 main features:
- Converting times between time zones for users in your Discord
- Checking users birthdays (and a birthday post on their birthday)
Now written in C# and .NET 9.
## Links
[Invite TimeZoneBot to your Discord Server](https://discord.com/api/oauth2/authorize?client_id=736720417166721105&permissions=414464859200&scope=bot%20applications.commands)
[Discord Support Server](https://discord.gg/Za4NAtJJ9v)
## Getting Started
- Invite the bot to your server using the invite link above.
- Each user will have to set up their time zone. To do this, it is recommended that you visit [the TimeZoneBot website](https://rardk.com/bots/timezonebot) using the instructions below.
- Each user can also set up their birthday. For birthday alerts to work, the user will have to set up their time zone as well.
- **NOTE:** If your server is made up of users who are entirely in the same time zone, and you just wish to use this bot for birthday wishes, you can set a default time zone using the `/set-default-time-zone` command - for more on this command, see the [Commands section](#commands) below.
## Using the Website
- Browse to [the TimeZoneBot website](https://rardk.com/bots/timezonebot/). If you're brought to the home page with a list of bots, click Settings under TimeZoneBot.
- You'll be asked to log into your Discord account and authorize for the website. Click Authorize.
- You'll be redirected to the time zone list.
- Search for your time zone, and either click the "Set" button to set it immediately, or use the copy icon button to copy it and use it with either the `/set-time-zone` or `/set-default-time-zone` commands in Discord.
## Time Reactions
When TimeZoneBot detects a valid time in a user's message, it will react with a "Time" emote reaction. If you tap that reaction, TimeZoneBot will respond with that time converted to your time. You must have your time zone set up for this to work.
## Commands
**Note:** Commands or descriptions below with * can only be used by the administrators.
### Time Commands
---
`/time`
Get the current time for the specified user in their time zone. Optionally, can also specify a time, and it will convert that time to the specified user's time zone.
---
`/time-all`
Get the current time for the all users in their respective time zones. Optionally, you can also specify a time, and it will convert that time to all other user's time zones.
---
`/set-time-zone`
Sets your time zone. NOTE: You must use a valid IANA Zone ID. You can [use our website](#using-the-website) to set it more easily.
---
`/set-default-time-zone`*
Set the default time zone for birthday checks when members have not set their time zone. NOTE: You must use a valid IANA Zone ID. You can [use our website](#using-the-website) to find a valid ID.
---
`/set-reactions`*
Set [time reactions](#time-reactions) on/off.
---
### Birthday Commands
---
`/birthday`
Get the birthday for the specified user.
---
`/birthday-all`
Get the birthdays for all users. You can also specify a method by which to sort the birthdays: Alphabetical (by username), Age, or Next Birthday.
---
`/set-birthday`
Set your birthday.
---
`/set-birthday-announcements`*
Set birthday announcements for the server on/off.
---