An integration for Slack that converts time string in a message to all timezones (MIT License)

Slack Timezone Converter

An integration for Slack that converts any time string in a message to all timezones where the team is.

Usage

Just invite the @bot to your channel. Then, any message that mentions @time and contains a time will be converted, for example: Let's meet at 8am PDT please @time .

Description

Currently supports any format parsable by ActiveSupport .

Any time a time string is found in a message that mentions @time , the integration, running in a server, converts it to all timezones where the team has at least one member. A message is sent back to the Slack channel with all the conversions and a fancy clock icon that represents the time. It supports any channel joined by the user whose token is passed as parameter. This user's timezone is used as the default when a timezone is not present on the parsed message.

Example message that would be parsed: Hey, our meeting is at 12h30 PDT @time .

Installation

In order to use this integration, the following Ruby libraries are needed:

• slack-rtmapi
• active_support
• json

But they can be installed by using bundle :

bundle install

After all requirements are met, it's just necessary to run the code, passing the Slack token as parameter:

ruby slack-timezone-converter.rb <Slack token> <number of times per line (defaults to 1)> <additional message>

This program runs indefinitely and listens for new messages on the Slack channels. It can be stopped by just stopping the process.

TODO

• Correctly identify the format where a dot is the separator between hour and minutes (e.g., "8.30am")

References

• https://api.slack.com/web#basics
• https://api.slack.com/rtm
• https://github.com/caiosba/slack-rtmapi