TimezoneParser

Library for parsing Timezone names and abbreviations to corresponding UTC offsets and much more. Supports multiple languages.

• Parse Timezone name to UTC offset
• Support for all TZ database abbreviations
• Ruby on Rails Timezone names supported
• Recognition of localized timezone names
• Check if string is a valid Timezone or abbreviation
• Present and Historical Timezones and offsets
• Filter results by Time, Region, Locale and DST

Input formats:

• Timezone abbreviations (eg. "EST")
• Timezone names (eg. "China Summer Time")
• Localized Timezone names in different languages (eg. "阿尤恩")
• Windows zone names (eg. "Azerbaijan Summer Time")
• Localized Windows zone names (eg. "كوريا - التوقيت الرسمي")
• Ruby on Rails Timezone names (eg. "Eastern Time (US & Canada)")
• Translated Ruby on Rails Timezone names (eg. "노보시비르스크")

Output formats:

• UTC offsets (eg. "-18000")
• Timezone identifiers (eg. "Europe/Istanbul")
• Original Zone (eg. "Mid-Atlantic Standard Time")
• Metazones (eg. "North_Mariana")

Add this line to your application's Gemfile:

gem 'TimezoneParser'

And then execute:

$ bundle

Or install it yourself as:

$ gem install TimezoneParser

• tzinfo (only required for Timezone offsets in some cases)
• insensitive_hash

> require 'timezone_parser'
=> true
> offsets = TimezoneParser::Abbreviation.new('FKT').getOffsets
=> [-14400]
> offsets.first
=> -14400

> TimezoneParser::Timezone.new('Nord-Marianene-tid').getTimezones
=> ["Pacific/Saipan"]

> TimezoneParser::WindowsZone.new('Jerusalem (normaltid)').getZone
=> "Israel Standard Time"

> tz = Time.now.zone # on localized Windows
=> "FLE standarta laiks"
> TimezoneParser::getTimezones(tz)
=> ["Europe/Helsinki", "Europe/Kiev", "Europe/Mariehamn", "Europe/Riga", "Europe/Simferopol", "Europe/Sofia", "Europe/Tallinn", "Europe/Uzhgorod", "Europe/Vilnius", "Europe/Zaporozhye"]

YARD with markdown is used for documentation (redcarpet required)

RSpec and simplecov are required, to run tests just rake spec code coverage will also be generated

Did you found this library useful? Tell about it

You can also

All text, documentation, code and files in this repository are in public domain (including this text, README). It means you can copy, modify, distribute and include in your own work/code, even for commercial purposes, all without asking permission.

About Unlicense

Feel free to improve as you see.

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Export .yaml data files to binary .dat with rake export
4. Commit your changes (git commit -am 'Add some feature')
5. Push to the branch (git push origin my-new-feature)
6. Create new Pull Request

Warning: By sending pull request to this repository you dedicate any and all copyright interest in pull request (code files and all other) to the public domain. (files will be in public domain even if pull request doesn't get merged)

Also before sending pull request you acknowledge that you own all copyrights or have authorization to dedicate them to public domain.

If you don't want to dedicate code to public domain or if you're not allowed to (eg. you don't own required copyrights) then DON'T send pull request.