tz_offset 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f9363efb498a8b6180965d24800702afb397ce68
+  data.tar.gz: 50c57cf3be860d0f7e8674b7499a8aec964c552f
+SHA512:
+  metadata.gz: 31dbb1f263b893d1299772afcaadb0e7e87e90565ff35c91af64482946f81f5737ebef7274520dba33eb601847e7f4274a0bb4088fea979befab07cf5bece8f5
+  data.tar.gz: dc8e375a8e93506c02ad56c95d91d365059564add20ab516568c9ef50cdc831a2d31e470b3e2357c77ea6c9c072a3b1e690600ec4432b37dc73cc752446ee7d4

data/.yardopts

@@ -0,0 +1,2 @@
+--markup=markdown
+--no-private

data/README.md

@@ -0,0 +1,110 @@
+# TZOffset
+
+[![Gem Version](https://badge.fury.io/rb/tz_offset.svg)](http://badge.fury.io/rb/tz_offset)
+[![Dependency Status](https://gemnasium.com/molybdenum-99/tz_offset.svg)](https://gemnasium.com/molybdenum-99/tz_offset)
+[![Build Status](https://travis-ci.org/molybdenum-99/tz_offset.svg?branch=master)](https://travis-ci.org/molybdenum-99/tz_offset)
+
+Ever tried to convert your distant friend's or colleague's phrase "OK, let's connect tomorrow
+at 6 pm my time (GMT+8)" into easily calculatable Ruby code? E.g. what time it would be in your
+timezone at 18:00 GMT+8? What is your favorite solution? Now it should be that:
+
+```ruby
+TZOffset.parse('GMT+8').local(2016, 10, 20, 18).localtime
+# => 2016-10-20 13:00:00 +0300
+
+# or just
+TZOffset.parse('+8').local(2016, 10, 20, 18).localtime
+# => 2016-10-20 13:00:00 +0300
+
+# Also works with most common timezone abbreviations
+TZOffset.parse('CEST').local(2016, 10, 20, 18).localtime
+# => 2016-10-20 19:00:00 +0300
+```
+
+In other words, `TZOffset` is simple, no-magic, incapsulated abstraction of "time offset".
+
+## Features and problems
+
+* Easy-to-use, intuitive, dead simple, OS independent;
+* No brains included: no huge and comprehensive database of historical times, no automatic
+  DST conversion; you just know offset you need, and have it as a near-to-mathematical
+  value;
+* Simple value objects, easily converted to/from YAML (so you can save them to databases,
+  pass to delayed jobs and so on);
+* Knows about all common timezone abbreviations (got them from
+  [Wikipedia list](https://en.wikipedia.org/wiki/List_of_time_zone_abbreviations));
+* For ambiguous abbreviations, just returns list of all of them:
+
+```ruby
+TZOffset.parse('EET')
+# => #<TZOffset +02:00 (EET)>
+TZOffset.parse('CDT')
+# => [#<TZOffset -05:00 (CDT)>, #<TZOffset -04:00 (CDT)>]
+```
+
+* For symbolic timezones, provides a description, if available:
+
+```ruby
+TZOffset.parse('CDT').map(&:description)
+# => ["Central Daylight Time (North America)", "Cuba Daylight Time"]
+TZOffset.parse('CDT').map(&:region)
+# => ["Central", "Cuba"]
+
+# NB: Just "Central", "Eastern" and so on is related to North America in timezones nomenclature
+```
+
+* for [DST](https://en.wikipedia.org/wiki/Daylight_saving_time) and non-DST timezones provides
+  dst-flag and counterpart timezone, if available:
+
+```ruby
+eet = TZOffset.parse('EET')
+# => #<TZOffset +02:00 (EET)>
+eet.dst?
+# => false
+eet.opposite
+# => #<TZOffset +03:00 (EEST)>
+[eet.description, eet.opposite.description]
+# => ["Eastern European Time", "Eastern European Summer Time"]
+```
+
+## Installation
+
+Do your usual routine with gem named `tz_offset` (e.g. `gem install tz_offset` or add
+`gem "tz_offset` to your `Gemfile`).
+
+## Usage
+
+Most of it is already shown above!
+
+```ruby
+require 'tz_offset'
+
+off = TZOffset.parse('-02:30')
+# => #<TZOffset -02:30>
+off.now
+# => 2016-10-25 16:07:55 -0230
+off.local(2016, 10, 1)
+# => 2016-10-01 00:00:00 -0230
+
+eet = TZOffset.parse('EET')
+# => #<TZOffset +02:00 (EET)>
+eet.now
+# => 2016-10-25 20:29:03 +0200
+eet.description
+# => "Eastern European Time"
+eet.region
+# => "Eastern European"
+eet.opposite
+# => #<TZOffset +03:00 (EEST)>
+eet.opposite.now
+# => 2016-10-25 21:39:26 +0300
+```
+
+## Author
+
+[Victor Shepelev](http://zverok.github.io/) -- extracted from [reality](https://github.com/molybdenum-99/reality)
+project.
+
+## License
+
+MIT.

data/lib/tz_offset.rb

@@ -0,0 +1,176 @@
+require 'time'
+
+# Simple class representing timezone offset (in minutes). Knows almost nothing
+# about timezone name, DST or other complications, but useful when ONLY offset is known.
+#
+# Usage:
+#
+# ```ruby
+# o = Reality::TZOffset.parse('UTC+3')
+# # => #<Reality::TZOffset(UTC+03:00)>
+#
+# o.now
+# # => 2016-04-16 19:01:40 +0300
+# o.local(2016, 4, 1, 20, 30)
+# # => 2016-04-01 20:30:00 +0300
+# o.convert(Time.now)
+# # => 2016-04-16 19:02:22 +0300
+# ```
+#
+class TZOffset
+  # Number of minutes in offset.
+  #
+  # @return [Fixnum]
+  attr_reader :minutes
+
+  # Symbolic offset name if available (like "EEST").
+  #
+  # @note
+  #   TZOffset never tries to "guess" the name, it is only known if an object was parsed/created
+  #   from it.
+  #
+  # @return [String]
+  attr_reader :name
+
+  # Full symbolic timezone description, as per wikipedia (like "Eastern European Summer Time"
+  # for "EEST").
+  #
+  # @return [String]
+  attr_reader :description
+
+  # "Region" part of {#description}, like "Eastern European" for "EEST".
+  #
+  # @return [String]
+  attr_reader :region
+
+  # @private
+  MINUSES = /[−—–]/
+
+  # Parses TZOffset from string. Understands several options like:
+  #
+  # * `GMT` (not all TZ names, just well-known
+  #   [abbreviations](https://en.wikipedia.org/wiki/List_of_time_zone_abbreviations));
+  # * `UTC+3` (or `GMT+3`);
+  # * `+03:30`;
+  # * ..and several combinations.
+  #
+  # @return [TZOffset]
+  def self.parse(text)
+    return ABBREV[text.upcase] if ABBREV.key?(text.upcase)
+
+    text = text.gsub(MINUSES, '-')
+    sec = case text
+          when /^[A-Z]{3}$/
+            Time.zone_offset(text)
+          when /^(?:UTC|GMT)?([+-]\d{1,2}:?\d{2})$/
+            offset = $1
+            Time.zone_offset(offset.sub(/^([+-])(\d):/, '\10\2:'))
+          when /^(?:UTC|GMT)?([+-]\d{1,2})/
+            $1.to_i * 3600
+          end
+
+    sec && new(sec / 60)
+  end
+
+  # Constructs offset from number of minutes. In most cases, you don't
+  # want to use it, but rather {TZOffset.parse}.
+  #
+  # @param minutes [Fixnum] Number of minutes in offset.
+  def initialize(minutes, name: nil, description: nil, region: nil, isdst: nil)
+    @minutes = minutes
+    @name = name
+    @description = description
+    @isdst = isdst
+    @region = region
+  end
+
+  # @return [String]
+  def inspect
+    if name
+      '#<%s %s%02i:%02i (%s)>' % [self.class.name, sign, *minutes.abs.divmod(60), name]
+    else
+      '#<%s %s%02i:%02i>' % [self.class.name, sign, *minutes.abs.divmod(60)]
+    end
+  end
+
+  # @return [String]
+  def to_s
+    '%s%02i:%02i' % [sign, *minutes.abs.divmod(60)]
+  end
+
+  # If offset is symbolic (e.g., "EET", not just "+02:00"), returns whether it is daylight
+  # saving time offset.
+  #
+  # See also {#opposite} for obtaining non-DST related to current DST offset and vice versa.
+  def dst?
+    @isdst
+  end
+
+  # @return [Boolean]
+  def <=>(other)
+    other.is_a?(TZOffset) or raise ArgumentError, "Can't compare TZOffset with #{other.class}"
+    minutes <=> other.minutes
+  end
+
+  include Comparable
+
+  # @return [Boolean]
+  def ==(other)
+    other.class == self.class && other.minutes == minutes
+  end
+
+  # Like Ruby's `Time.local`, but in current offset.
+  #
+  # @return [Time] Constructed time in that offset.
+  def local(*values)
+    values << 0 until values.count == 6
+    mk(*values)
+  end
+
+  # Converts `tm` into current offset.
+  #
+  # @param tm [Time] Time object to convert (with any offset);
+  # @return [Time] Converted object.
+  def convert(tm)
+    t = tm.getutc + minutes * 60
+
+    # FIXME: usec are lost
+    mk(t.year, t.month, t.day, t.hour, t.min, t.sec)
+  end
+
+  # Like Ruby's `Time.now`, but in current offset.
+  #
+  # @return [Time] Current time in that offset.
+  def now
+    convert(Time.now)
+  end
+
+  # For symbolic offsets, returns opposite (DST for non-DST and vice versa) offset object if
+  # known, `nil` otherwise.
+  #
+  # @example
+  #   eet = TZOffset.parse('EET')
+  #   # => #<TZOffset +02:00 (EET)>
+  #   eet.opposite
+  #   # => #<TZOffset +03:00 (EEST)>
+  #   TZOffset.parse('+8').opposite
+  #   # => nil
+  #
+  # @return [TZOffset]
+  def opposite
+    return nil unless region
+    ABBREV.values.flatten.detect { |tz| tz.region == region && tz.dst? == !dst? }
+  end
+
+  private
+
+  def sign
+    minutes < 0 ? '-' : '+'
+  end
+
+  def mk(*components)
+    Time.new(*components, to_s)
+  end
+end
+
+require_relative 'tz_offset/abbrev'

data/lib/tz_offset/abbrev.rb

@@ -0,0 +1,28 @@
+require 'yaml'
+
+class TZOffset
+  # @private
+  PATH = File.expand_path('../data/abbreviations.yaml', __FILE__)
+
+  # @private
+  #
+  # List of Timezone abbreviations, loaded from datafile distributed with a gem
+  # (abbreviations.yaml) and used when parsing timezones.
+  #
+  # Rendered really ugly by YARD... So, private.
+  ABBREV =
+    YAML
+    .load_file(PATH)
+    .map { |row|
+      TZOffset.new(
+        row.fetch(:val),
+        name: row.fetch(:abbr),
+        description: row.fetch(:title),
+        region: row.fetch(:region),
+        isdst: row.fetch(:dst)
+      )
+    }
+    .group_by(&:name)
+    .map { |name, group| [name, group.count == 1 ? group.first : group] }
+    .to_h
+end

data/lib/tz_offset/data/abbreviations.yaml

@@ -0,0 +1,961 @@
+---
+- :abbr: ACDT
+  :title: Australian Central Daylight Savings Time
+  :region: Australian Central
+  :dst: true
+  :val: 630
+- :abbr: ACST
+  :title: Australian Central Standard Time
+  :region: Australian Central
+  :dst: false
+  :val: 570
+- :abbr: ACT
+  :title: Acre Time
+  :region: Acre
+  :dst: false
+  :val: -300
+- :abbr: ADT
+  :title: Atlantic Daylight Time
+  :region: Atlantic
+  :dst: true
+  :val: -180
+- :abbr: AEDT
+  :title: Australian Eastern Daylight Savings Time
+  :region: Australian Eastern
+  :dst: true
+  :val: 660
+- :abbr: AEST
+  :title: Australian Eastern Standard Time
+  :region: Australian Eastern
+  :dst: false
+  :val: 600
+- :abbr: AFT
+  :title: Afghanistan Time
+  :region: Afghanistan
+  :dst: false
+  :val: 270
+- :abbr: AKDT
+  :title: Alaska Daylight Time
+  :region: Alaska
+  :dst: true
+  :val: -480
+- :abbr: AKST
+  :title: Alaska Standard Time
+  :region: Alaska
+  :dst: false
+  :val: -540
+- :abbr: AMST
+  :title: Amazon Summer Time (Brazil)
+  :region: Amazon
+  :dst: true
+  :val: -180
+- :abbr: AMT
+  :title: Amazon Time (Brazil)
+  :region: Amazon
+  :dst: false
+  :val: -240
+- :abbr: AMT
+  :title: Armenia Time
+  :region: Armenia
+  :dst: false
+  :val: 240
+- :abbr: ART
+  :title: Argentina Time
+  :region: Argentina
+  :dst: false
+  :val: -180
+- :abbr: AST
+  :title: Arabia Standard Time
+  :region: Arabia
+  :dst: false
+  :val: 180
+- :abbr: AST
+  :title: Atlantic Standard Time
+  :region: Atlantic
+  :dst: false
+  :val: -240
+- :abbr: AWST
+  :title: Australian Western Standard Time
+  :region: Australian Western
+  :dst: false
+  :val: 480
+- :abbr: AZOST
+  :title: Azores Summer Time
+  :region: Azores
+  :dst: true
+  :val: 0
+- :abbr: AZOT
+  :title: Azores Standard Time
+  :region: Azores
+  :dst: false
+  :val: -60
+- :abbr: AZT
+  :title: Azerbaijan Time
+  :region: Azerbaijan
+  :dst: false
+  :val: 240
+- :abbr: BDT
+  :title: Brunei Time
+  :region: Brunei
+  :dst: false
+  :val: 480
+- :abbr: BIOT
+  :title: British Indian Ocean Time
+  :region: British Indian Ocean
+  :dst: false
+  :val: 360
+- :abbr: BIT
+  :title: Baker Island Time
+  :region: Baker Island
+  :dst: false
+  :val: -720
+- :abbr: BOT
+  :title: Bolivia Time
+  :region: Bolivia
+  :dst: false
+  :val: -240
+- :abbr: BRST
+  :title: Brasilia Summer Time
+  :region: Brasilia
+  :dst: true
+  :val: -120
+- :abbr: BRT
+  :title: Brasilia Time
+  :region: Brasilia
+  :dst: false
+  :val: -180
+- :abbr: BST
+  :title: Bangladesh Standard Time
+  :region: Bangladesh
+  :dst: false
+  :val: 360
+- :abbr: BST
+  :title: Bougainville Standard Time
+  :region: Bougainville
+  :dst: false
+  :val: 660
+- :abbr: BST
+  :title: British Summer Time (British Standard Time from Feb 1968 to Oct 1971)
+  :region: British
+  :dst: true
+  :val: 60
+- :abbr: BTT
+  :title: Bhutan Time
+  :region: Bhutan
+  :dst: false
+  :val: 360
+- :abbr: CAT
+  :title: Central Africa Time
+  :region: Central Africa
+  :dst: false
+  :val: 120
+- :abbr: CCT
+  :title: Cocos Islands Time
+  :region: Cocos Islands
+  :dst: false
+  :val: 390
+- :abbr: CDT
+  :title: Central Daylight Time (North America)
+  :region: Central
+  :dst: true
+  :val: -300
+- :abbr: CDT
+  :title: Cuba Daylight Time
+  :region: Cuba
+  :dst: true
+  :val: -240
+- :abbr: CEST
+  :title: Central European Summer Time (Cf. HAEC)
+  :region: Central European
+  :dst: true
+  :val: 120
+- :abbr: CET
+  :title: Central European Time
+  :region: Central European
+  :dst: false
+  :val: 60
+- :abbr: CHADT
+  :title: Chatham Daylight Time
+  :region: Chatham
+  :dst: true
+  :val: 825
+- :abbr: CHAST
+  :title: Chatham Standard Time
+  :region: Chatham
+  :dst: false
+  :val: 765
+- :abbr: CHOST
+  :title: Choibalsan Summer Time
+  :region: Choibalsan
+  :dst: true
+  :val: 540
+- :abbr: CHOT
+  :title: Choibalsan Standard Time
+  :region: Choibalsan
+  :dst: false
+  :val: 480
+- :abbr: CHST
+  :title: Chamorro Standard Time
+  :region: Chamorro
+  :dst: false
+  :val: 600
+- :abbr: CHUT
+  :title: Chuuk Time
+  :region: Chuuk
+  :dst: false
+  :val: 600
+- :abbr: CIST
+  :title: Clipperton Island Standard Time
+  :region: Clipperton Island
+  :dst: false
+  :val: -480
+- :abbr: CIT
+  :title: Central Indonesia Time
+  :region: Central Indonesia
+  :dst: false
+  :val: 480
+- :abbr: CKT
+  :title: Cook Island Time
+  :region: Cook Island
+  :dst: false
+  :val: -600
+- :abbr: CLST
+  :title: Chile Summer Time
+  :region: Chile
+  :dst: true
+  :val: -180
+- :abbr: CLT
+  :title: Chile Standard Time
+  :region: Chile
+  :dst: false
+  :val: -240
+- :abbr: COST
+  :title: Colombia Summer Time
+  :region: Colombia
+  :dst: true
+  :val: -240
+- :abbr: COT
+  :title: Colombia Time
+  :region: Colombia
+  :dst: false
+  :val: -300
+- :abbr: CST
+  :title: Central Standard Time (North America)
+  :region: Central
+  :dst: false
+  :val: -360
+- :abbr: CST
+  :title: China Standard Time
+  :region: China
+  :dst: false
+  :val: 480
+- :abbr: CST
+  :title: Cuba Standard Time
+  :region: Cuba
+  :dst: false
+  :val: -300
+- :abbr: CT
+  :title: China time
+  :region: China
+  :dst: false
+  :val: 480
+- :abbr: CVT
+  :title: Cape Verde Time
+  :region: Cape Verde
+  :dst: false
+  :val: -60
+- :abbr: CXT
+  :title: Christmas Island Time
+  :region: Christmas Island
+  :dst: false
+  :val: 420
+- :abbr: DAVT
+  :title: Davis Time
+  :region: Davis
+  :dst: false
+  :val: 420
+- :abbr: DDUT
+  :title: Dumont d'Urville Time
+  :region: Dumont d'Urville
+  :dst: false
+  :val: 600
+- :abbr: DFT
+  :title: AIX specific equivalent of Central European Time
+  :region: AIX specific equivalent of Central European
+  :dst: false
+  :val: 60
+- :abbr: EASST
+  :title: Easter Island Summer Time
+  :region: Easter Island
+  :dst: true
+  :val: -300
+- :abbr: EAST
+  :title: Easter Island Standard Time
+  :region: Easter Island
+  :dst: false
+  :val: -360
+- :abbr: EAT
+  :title: East Africa Time
+  :region: East Africa
+  :dst: false
+  :val: 180
+- :abbr: ECT
+  :title: Eastern Caribbean Time (does not recognise DST)
+  :region: Eastern Caribbean
+  :dst: false
+  :val: -240
+- :abbr: ECT
+  :title: Ecuador Time
+  :region: Ecuador
+  :dst: false
+  :val: -300
+- :abbr: EDT
+  :title: Eastern Daylight Time (North America)
+  :region: Eastern
+  :dst: true
+  :val: -240
+- :abbr: EEST
+  :title: Eastern European Summer Time
+  :region: Eastern European
+  :dst: true
+  :val: 180
+- :abbr: EET
+  :title: Eastern European Time
+  :region: Eastern European
+  :dst: false
+  :val: 120
+- :abbr: EGST
+  :title: Eastern Greenland Summer Time
+  :region: Eastern Greenland
+  :dst: true
+  :val: 0
+- :abbr: EGT
+  :title: Eastern Greenland Time
+  :region: Eastern Greenland
+  :dst: false
+  :val: -60
+- :abbr: EIT
+  :title: Eastern Indonesian Time
+  :region: Eastern Indonesian
+  :dst: false
+  :val: 540
+- :abbr: EST
+  :title: Eastern Standard Time (North America)
+  :region: Eastern
+  :dst: false
+  :val: -300
+- :abbr: FET
+  :title: Further-eastern European Time
+  :region: Further-eastern European
+  :dst: false
+  :val: 180
+- :abbr: FJT
+  :title: Fiji Time
+  :region: Fiji
+  :dst: false
+  :val: 720
+- :abbr: FKST
+  :title: Falkland Islands Summer Time
+  :region: Falkland Islands
+  :dst: true
+  :val: -180
+- :abbr: FKT
+  :title: Falkland Islands Time
+  :region: Falkland Islands
+  :dst: false
+  :val: -240
+- :abbr: FNT
+  :title: Fernando de Noronha Time
+  :region: Fernando de Noronha
+  :dst: false
+  :val: -120
+- :abbr: GALT
+  :title: Galapagos Time
+  :region: Galapagos
+  :dst: false
+  :val: -360
+- :abbr: GAMT
+  :title: Gambier Islands Time
+  :region: Gambier Islands
+  :dst: false
+  :val: -540
+- :abbr: GET
+  :title: Georgia Standard Time
+  :region: Georgia
+  :dst: false
+  :val: 240
+- :abbr: GFT
+  :title: French Guiana Time
+  :region: French Guiana
+  :dst: false
+  :val: -180
+- :abbr: GILT
+  :title: Gilbert Island Time
+  :region: Gilbert Island
+  :dst: false
+  :val: 720
+- :abbr: GIT
+  :title: Gambier Island Time
+  :region: Gambier Island
+  :dst: false
+  :val: -540
+- :abbr: GMT
+  :title: Greenwich Mean Time
+  :region: Greenwich Mean
+  :dst: false
+  :val: 0
+- :abbr: GST
+  :title: South Georgia and the South Sandwich Islands Time
+  :region: South Georgia and the South Sandwich Islands
+  :dst: false
+  :val: -120
+- :abbr: GST
+  :title: Gulf Standard Time
+  :region: Gulf
+  :dst: false
+  :val: 240
+- :abbr: GYT
+  :title: Guyana Time
+  :region: Guyana
+  :dst: false
+  :val: -240
+- :abbr: HADT
+  :title: Hawaii-Aleutian Daylight Time
+  :region: Hawaii-Aleutian
+  :dst: true
+  :val: -540
+- :abbr: HAEC
+  :title: Heure Avancée d'Europe Centrale francised name for CEST Time
+  :region: Heure Avancée d'Europe Centrale francised name for CEST
+  :dst: false
+  :val: 120
+- :abbr: HAST
+  :title: Hawaii-Aleutian Standard Time
+  :region: Hawaii-Aleutian
+  :dst: false
+  :val: -600
+- :abbr: HKT
+  :title: Hong Kong Time
+  :region: Hong Kong
+  :dst: false
+  :val: 480
+- :abbr: HMT
+  :title: Heard and McDonald Islands Time
+  :region: Heard and McDonald Islands
+  :dst: false
+  :val: 300
+- :abbr: HOVST
+  :title: Khovd Summer Time
+  :region: Khovd
+  :dst: true
+  :val: 480
+- :abbr: HOVT
+  :title: Khovd Standard Time
+  :region: Khovd
+  :dst: false
+  :val: 420
+- :abbr: ICT
+  :title: Indochina Time
+  :region: Indochina
+  :dst: false
+  :val: 420
+- :abbr: IDT
+  :title: Israel Daylight Time
+  :region: Israel
+  :dst: true
+  :val: 180
+- :abbr: IOT
+  :title: Indian Ocean Time
+  :region: Indian Ocean
+  :dst: false
+  :val: 180
+- :abbr: IRDT
+  :title: Iran Daylight Time
+  :region: Iran
+  :dst: true
+  :val: 270
+- :abbr: IRKT
+  :title: Irkutsk Time
+  :region: Irkutsk
+  :dst: false
+  :val: 480
+- :abbr: IRST
+  :title: Iran Standard Time
+  :region: Iran
+  :dst: false
+  :val: 210
+- :abbr: IST
+  :title: Indian Standard Time
+  :region: Indian
+  :dst: false
+  :val: 330
+- :abbr: IST
+  :title: Irish Standard Time
+  :region: Irish
+  :dst: false
+  :val: 60
+- :abbr: IST
+  :title: Israel Standard Time
+  :region: Israel
+  :dst: false
+  :val: 120
+- :abbr: JST
+  :title: Japan Standard Time
+  :region: Japan
+  :dst: false
+  :val: 540
+- :abbr: KGT
+  :title: Kyrgyzstan time
+  :region: Kyrgyzstan
+  :dst: false
+  :val: 360
+- :abbr: KOST
+  :title: Kosrae Time
+  :region: Kosrae
+  :dst: false
+  :val: 660
+- :abbr: KRAT
+  :title: Krasnoyarsk Time
+  :region: Krasnoyarsk
+  :dst: false
+  :val: 420
+- :abbr: KST
+  :title: Korea Standard Time
+  :region: Korea
+  :dst: false
+  :val: 540
+- :abbr: LHST
+  :title: Lord Howe Standard Time
+  :region: Lord Howe
+  :dst: false
+  :val: 630
+- :abbr: LHST
+  :title: Lord Howe Summer Time
+  :region: Lord Howe
+  :dst: true
+  :val: 660
+- :abbr: LINT
+  :title: Line Islands Time
+  :region: Line Islands
+  :dst: false
+  :val: 840
+- :abbr: MAGT
+  :title: Magadan Time
+  :region: Magadan
+  :dst: false
+  :val: 720
+- :abbr: MART
+  :title: Marquesas Islands Time
+  :region: Marquesas Islands
+  :dst: false
+  :val: -570
+- :abbr: MAWT
+  :title: Mawson Station Time
+  :region: Mawson Station
+  :dst: false
+  :val: 300
+- :abbr: MDT
+  :title: Mountain Daylight Time (North America)
+  :region: Mountain
+  :dst: true
+  :val: -360
+- :abbr: MEST
+  :title: Middle European Summer Time
+  :region: Middle European
+  :dst: true
+  :val: 120
+- :abbr: MET
+  :title: Middle European Time
+  :region: Middle European
+  :dst: false
+  :val: 60
+- :abbr: MHT
+  :title: Marshall Islands Time
+  :region: Marshall Islands
+  :dst: false
+  :val: 720
+- :abbr: MIST
+  :title: Macquarie Island Station Time
+  :region: Macquarie Island Station
+  :dst: false
+  :val: 660
+- :abbr: MIT
+  :title: Marquesas Islands Time
+  :region: Marquesas Islands
+  :dst: false
+  :val: -570
+- :abbr: MMT
+  :title: Myanmar Standard Time
+  :region: Myanmar
+  :dst: false
+  :val: 390
+- :abbr: MSK
+  :title: Moscow Time
+  :region: Moscow
+  :dst: false
+  :val: 180
+- :abbr: MST
+  :title: Malaysia Standard Time
+  :region: Malaysia
+  :dst: false
+  :val: 480
+- :abbr: MST
+  :title: Mountain Standard Time (North America)
+  :region: Mountain
+  :dst: false
+  :val: -420
+- :abbr: MUT
+  :title: Mauritius Time
+  :region: Mauritius
+  :dst: false
+  :val: 240
+- :abbr: MVT
+  :title: Maldives Time
+  :region: Maldives
+  :dst: false
+  :val: 300
+- :abbr: MYT
+  :title: Malaysia Time
+  :region: Malaysia
+  :dst: false
+  :val: 480
+- :abbr: NCT
+  :title: New Caledonia Time
+  :region: New Caledonia
+  :dst: false
+  :val: 660
+- :abbr: NDT
+  :title: Newfoundland Daylight Time
+  :region: Newfoundland
+  :dst: true
+  :val: -150
+- :abbr: NFT
+  :title: Norfolk Time
+  :region: Norfolk
+  :dst: false
+  :val: 660
+- :abbr: NPT
+  :title: Nepal Time
+  :region: Nepal
+  :dst: false
+  :val: 345
+- :abbr: NST
+  :title: Newfoundland Standard Time
+  :region: Newfoundland
+  :dst: false
+  :val: -210
+- :abbr: NT
+  :title: Newfoundland Time
+  :region: Newfoundland
+  :dst: false
+  :val: -210
+- :abbr: NUT
+  :title: Niue Time
+  :region: Niue
+  :dst: false
+  :val: -660
+- :abbr: NZDT
+  :title: New Zealand Daylight Time
+  :region: New Zealand
+  :dst: true
+  :val: 780
+- :abbr: NZST
+  :title: New Zealand Standard Time
+  :region: New Zealand
+  :dst: false
+  :val: 720
+- :abbr: OMST
+  :title: Omsk Time
+  :region: Omsk
+  :dst: false
+  :val: 360
+- :abbr: ORAT
+  :title: Oral Time
+  :region: Oral
+  :dst: false
+  :val: 300
+- :abbr: PDT
+  :title: Pacific Daylight Time (North America)
+  :region: Pacific
+  :dst: true
+  :val: -420
+- :abbr: PET
+  :title: Peru Time
+  :region: Peru
+  :dst: false
+  :val: -300
+- :abbr: PETT
+  :title: Kamchatka Time
+  :region: Kamchatka
+  :dst: false
+  :val: 720
+- :abbr: PGT
+  :title: Papua New Guinea Time
+  :region: Papua New Guinea
+  :dst: false
+  :val: 600
+- :abbr: PHOT
+  :title: Phoenix Island Time
+  :region: Phoenix Island
+  :dst: false
+  :val: 780
+- :abbr: PKT
+  :title: Pakistan Standard Time
+  :region: Pakistan
+  :dst: false
+  :val: 300
+- :abbr: PMDT
+  :title: Saint Pierre and Miquelon Daylight time
+  :region: Saint Pierre and Miquelon
+  :dst: true
+  :val: -120
+- :abbr: PMST
+  :title: Saint Pierre and Miquelon Standard Time
+  :region: Saint Pierre and Miquelon
+  :dst: false
+  :val: -180
+- :abbr: PONT
+  :title: Pohnpei Standard Time
+  :region: Pohnpei
+  :dst: false
+  :val: 660
+- :abbr: PST
+  :title: Pacific Standard Time (North America)
+  :region: Pacific
+  :dst: false
+  :val: -480
+- :abbr: PST
+  :title: Philippine Standard Time
+  :region: Philippine
+  :dst: false
+  :val: 480
+- :abbr: PYST
+  :title: Paraguay Summer Time (South America)
+  :region: Paraguay
+  :dst: true
+  :val: -180
+- :abbr: PYT
+  :title: Paraguay Time (South America)
+  :region: Paraguay
+  :dst: false
+  :val: -240
+- :abbr: RET
+  :title: Réunion Time
+  :region: Réunion
+  :dst: false
+  :val: 240
+- :abbr: ROTT
+  :title: Rothera Research Station Time
+  :region: Rothera Research Station
+  :dst: false
+  :val: -180
+- :abbr: SAKT
+  :title: Sakhalin Island time
+  :region: Sakhalin Island
+  :dst: false
+  :val: 660
+- :abbr: SAMT
+  :title: Samara Time
+  :region: Samara
+  :dst: false
+  :val: 240
+- :abbr: SAST
+  :title: South African Standard Time
+  :region: South African
+  :dst: false
+  :val: 120
+- :abbr: SBT
+  :title: Solomon Islands Time
+  :region: Solomon Islands
+  :dst: false
+  :val: 660
+- :abbr: SCT
+  :title: Seychelles Time
+  :region: Seychelles
+  :dst: false
+  :val: 240
+- :abbr: SGT
+  :title: Singapore Time
+  :region: Singapore
+  :dst: false
+  :val: 480
+- :abbr: SLST
+  :title: Sri Lanka Standard Time
+  :region: Sri Lanka
+  :dst: false
+  :val: 330
+- :abbr: SRET
+  :title: Srednekolymsk Time
+  :region: Srednekolymsk
+  :dst: false
+  :val: 660
+- :abbr: SRT
+  :title: Suriname Time
+  :region: Suriname
+  :dst: false
+  :val: -180
+- :abbr: SST
+  :title: Samoa Standard Time
+  :region: Samoa
+  :dst: false
+  :val: -660
+- :abbr: SST
+  :title: Singapore Standard Time
+  :region: Singapore
+  :dst: false
+  :val: 480
+- :abbr: SYOT
+  :title: Showa Station Time
+  :region: Showa Station
+  :dst: false
+  :val: 180
+- :abbr: TAHT
+  :title: Tahiti Time
+  :region: Tahiti
+  :dst: false
+  :val: -600
+- :abbr: TFT
+  :title: Indian/Kerguelen Time
+  :region: Indian/Kerguelen
+  :dst: false
+  :val: 300
+- :abbr: THA
+  :title: Thailand Standard Time
+  :region: Thailand
+  :dst: false
+  :val: 420
+- :abbr: TJT
+  :title: Tajikistan Time
+  :region: Tajikistan
+  :dst: false
+  :val: 300
+- :abbr: TKT
+  :title: Tokelau Time
+  :region: Tokelau
+  :dst: false
+  :val: 780
+- :abbr: TLT
+  :title: Timor Leste Time
+  :region: Timor Leste
+  :dst: false
+  :val: 540
+- :abbr: TMT
+  :title: Turkmenistan Time
+  :region: Turkmenistan
+  :dst: false
+  :val: 300
+- :abbr: TOT
+  :title: Tonga Time
+  :region: Tonga
+  :dst: false
+  :val: 780
+- :abbr: TRT
+  :title: Turkey Time
+  :region: Turkey
+  :dst: false
+  :val: 180
+- :abbr: TVT
+  :title: Tuvalu Time
+  :region: Tuvalu
+  :dst: false
+  :val: 720
+- :abbr: ULAST
+  :title: Ulaanbaatar Summer Time
+  :region: Ulaanbaatar
+  :dst: true
+  :val: 540
+- :abbr: ULAT
+  :title: Ulaanbaatar Standard Time
+  :region: Ulaanbaatar
+  :dst: false
+  :val: 480
+- :abbr: USZ1
+  :title: Kaliningrad Time
+  :region: Kaliningrad
+  :dst: false
+  :val: 120
+- :abbr: UYST
+  :title: Uruguay Summer Time
+  :region: Uruguay
+  :dst: true
+  :val: -120
+- :abbr: UYT
+  :title: Uruguay Standard Time
+  :region: Uruguay
+  :dst: false
+  :val: -180
+- :abbr: UZT
+  :title: Uzbekistan Time
+  :region: Uzbekistan
+  :dst: false
+  :val: 300
+- :abbr: VET
+  :title: Venezuelan Standard Time
+  :region: Venezuelan
+  :dst: false
+  :val: -240
+- :abbr: VLAT
+  :title: Vladivostok Time
+  :region: Vladivostok
+  :dst: false
+  :val: 600
+- :abbr: VOLT
+  :title: Volgograd Time
+  :region: Volgograd
+  :dst: false
+  :val: 240
+- :abbr: VOST
+  :title: Vostok Station Time
+  :region: Vostok Station
+  :dst: false
+  :val: 360
+- :abbr: VUT
+  :title: Vanuatu Time
+  :region: Vanuatu
+  :dst: false
+  :val: 660
+- :abbr: WAKT
+  :title: Wake Island Time
+  :region: Wake Island
+  :dst: false
+  :val: 720
+- :abbr: WAST
+  :title: West Africa Summer Time
+  :region: West Africa
+  :dst: true
+  :val: 120
+- :abbr: WAT
+  :title: West Africa Time
+  :region: West Africa
+  :dst: false
+  :val: 60
+- :abbr: WEST
+  :title: Western European Summer Time
+  :region: Western European
+  :dst: true
+  :val: 60
+- :abbr: WET
+  :title: Western European Time
+  :region: Western European
+  :dst: false
+  :val: 0
+- :abbr: WIT
+  :title: Western Indonesian Time
+  :region: Western Indonesian
+  :dst: false
+  :val: 420
+- :abbr: WST
+  :title: Western Standard Time
+  :region: Western
+  :dst: false
+  :val: 480
+- :abbr: YAKT
+  :title: Yakutsk Time
+  :region: Yakutsk
+  :dst: false
+  :val: 540
+- :abbr: YEKT
+  :title: Yekaterinburg Time
+  :region: Yekaterinburg
+  :dst: false
+  :val: 300