# TimeAlexa
A Discord Bot help translate mentioned time for user across timezone

TimeAlexa will check people's text content and react with messages containing text parts that **considerated a time**:
* Chat messages contain time text will be react <img style="width:16px" src="https://discordapp.com/assets/ab5b4d44e26e2cc47eb0da7289a93b75.svg"/>
![Imgur](https://i.imgur.com/0lXUphF.png)
* If you react with the same <img style="width:16px" src="https://discordapp.com/assets/ab5b4d44e26e2cc47eb0da7289a93b75.svg"/>
![Imgur](https://i.imgur.com/ys2R2iF.png)
* a time translate would be PM to you
![Imgur](https://i.imgur.com/kIKbvgH.png)
## Notice: auto reaction will be disable by default, only server owner can enable/disable it.

## Enable auto reaction <img style="width:16px" src="https://discordapp.com/assets/ab5b4d44e26e2cc47eb0da7289a93b75.svg"/> (only for server owner)
* Method 1: Explicit allow reaction for TimeAlexa in channel
* Method 2: `@TimeAleza reaction on`
## Disable auto reaction <img style="width:16px" src="https://discordapp.com/assets/ab5b4d44e26e2cc47eb0da7289a93b75.svg"/> (only for server owner)
* Remove the Explicit allow reaction for TimeAlexa in channel if be turned on before
* `@TimeAleza reaction off`
## Check Auto reaction status
	`@TimeAlexa reaction`

## Register Setting
 @TimeAlexa reg {timezone} [msg on|off]
### **New: Register by link
	![Register with link](https://i.imgur.com/qUiepW6.png)
## Check Settings
 `@TimeAlexa reg`
 without any arguments

## Find Timezone Name
 `@TimeAlexa find {keyword}`
* {keyword} with all upcase will take as abbreviation like `PST`
* otherwise will take as timezone name like `Los_Angeles` or just `los` or Country name like `Bulgari` or `Viet`

![Example usage](https://i.imgur.com/iKmCSR1.png)

## Current Time
 `@TimeAlexa now [@mention_user|timezone_search]`
* wo. @mention_user:
 _Display current time with your registerd timezone_
 Example: ` @TimeAlexa now `
* with @mention_user: 
 *will show current time in mentioned user's timezone (if he registed)*
 Example: ` @TimeAlexa now @username `
* with timezone_search: *will show current time in found first timezone*
 Example: ` @TimeAlexa now los `
* with search: *will show current time in found first timezone*
 Example: ` @TimeAlexa now bulgaria ` ` @TimeAlexa now paris ` ` @TimeAlexa now Fairfield US `
 
![Example usage](https://i.imgur.com/Duy55NB.png)

## Considerated time - Supported
* Short hour: `2 am` `5pm` 
* With minutes: `2:30am` `12:03 PM`
* With abbr: `2:30am est` `12:03 pm PST`

## Convert Time (in PM)
* From abbr to abbr:
 `2pm EST > PST`
 `11:00 AM PST > EST`
* from your registered tz:
 `2pm > PST`

TimeAlexa

Help translate mentioned time or question about remote place time for user across timezone

Votando por TimeAlexa

¿Quieres apoyarnos?