rufus-scheduler 2.0.24 → 3.1.0

data/lib/rufus/scheduler/util.rb

@@ -0,0 +1,306 @@
+#--
+# Copyright (c) 2006-2015, John Mettraux, jmettraux@gmail.com
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+# Made in Japan.
+#++
+
+
+module Rufus
+
+  class Scheduler
+
+    #--
+    # time and string methods
+    #++
+
+    def self.parse(o, opts={})
+
+      opts[:no_error] = true
+
+      parse_cron(o, opts) ||
+      parse_in(o, opts) || # covers 'every' schedule strings
+      parse_at(o, opts) ||
+      raise(ArgumentError.new("couldn't parse \"#{o}\""))
+    end
+
+    def self.parse_in(o, opts={})
+
+      o.is_a?(String) ? parse_duration(o, opts) : o
+    end
+
+    def self.parse_at(o, opts={})
+
+      Rufus::Scheduler::ZoTime.parse(o, opts).time
+
+    rescue StandardError => se
+
+      return nil if opts[:no_error]
+      raise se
+    end
+
+    def self.parse_cron(o, opts)
+
+      CronLine.new(o)
+
+    rescue ArgumentError => ae
+
+      return nil if opts[:no_error]
+      raise ae
+    end
+
+    def self.parse_to_time(o)
+
+      t = o
+      t = parse(t) if t.is_a?(String)
+      t = Time.now + t if t.is_a?(Numeric)
+
+      raise ArgumentError.new(
+        "cannot turn #{o.inspect} to a point in time, doesn't make sense"
+      ) unless t.is_a?(Time)
+
+      t
+    end
+
+    DURATIONS2M = [
+      [ 'y', 365 * 24 * 3600 ],
+      [ 'M', 30 * 24 * 3600 ],
+      [ 'w', 7 * 24 * 3600 ],
+      [ 'd', 24 * 3600 ],
+      [ 'h', 3600 ],
+      [ 'm', 60 ],
+      [ 's', 1 ]
+    ]
+    DURATIONS2 = DURATIONS2M.dup
+    DURATIONS2.delete_at(1)
+
+    DURATIONS = DURATIONS2M.inject({}) { |r, (k, v)| r[k] = v; r }
+    DURATION_LETTERS = DURATIONS.keys.join
+
+    DU_KEYS = DURATIONS2M.collect { |k, v| k.to_sym }
+
+    # Turns a string like '1m10s' into a float like '70.0', more formally,
+    # turns a time duration expressed as a string into a Float instance
+    # (millisecond count).
+    #
+    # w -> week
+    # d -> day
+    # h -> hour
+    # m -> minute
+    # s -> second
+    # M -> month
+    # y -> year
+    # 'nada' -> millisecond
+    #
+    # Some examples:
+    #
+    #   Rufus::Scheduler.parse_duration "0.5"    # => 0.5
+    #   Rufus::Scheduler.parse_duration "500"    # => 0.5
+    #   Rufus::Scheduler.parse_duration "1000"   # => 1.0
+    #   Rufus::Scheduler.parse_duration "1h"     # => 3600.0
+    #   Rufus::Scheduler.parse_duration "1h10s"  # => 3610.0
+    #   Rufus::Scheduler.parse_duration "1w2d"   # => 777600.0
+    #
+    # Negative time strings are OK (Thanks Danny Fullerton):
+    #
+    #   Rufus::Scheduler.parse_duration "-0.5"   # => -0.5
+    #   Rufus::Scheduler.parse_duration "-1h"    # => -3600.0
+    #
+    def self.parse_duration(string, opts={})
+
+      string = string.to_s
+
+      return 0.0 if string == ''
+
+      m = string.match(/^(-?)([\d\.#{DURATION_LETTERS}]+)$/)
+
+      return nil if m.nil? && opts[:no_error]
+      raise ArgumentError.new("cannot parse '#{string}'") if m.nil?
+
+      mod = m[1] == '-' ? -1.0 : 1.0
+      val = 0.0
+
+      s = m[2]
+
+      while s.length > 0
+        m = nil
+        if m = s.match(/^(\d+|\d+\.\d*|\d*\.\d+)([#{DURATION_LETTERS}])(.*)$/)
+          val += m[1].to_f * DURATIONS[m[2]]
+        elsif s.match(/^\d+$/)
+          val += s.to_i
+        elsif s.match(/^\d*\.\d*$/)
+          val += s.to_f
+        elsif opts[:no_error]
+          return nil
+        else
+          raise ArgumentError.new(
+            "cannot parse '#{string}' (especially '#{s}')"
+          )
+        end
+        break unless m && m[3]
+        s = m[3]
+      end
+
+      mod * val
+    end
+
+    class << self
+      #-
+      # for compatibility with rufus-scheduler 2.x
+      #+
+      alias parse_duration_string parse_duration
+      alias parse_time_string parse_duration
+    end
+
+
+    # Turns a number of seconds into a a time string
+    #
+    #   Rufus.to_duration 0                    # => '0s'
+    #   Rufus.to_duration 60                   # => '1m'
+    #   Rufus.to_duration 3661                 # => '1h1m1s'
+    #   Rufus.to_duration 7 * 24 * 3600        # => '1w'
+    #   Rufus.to_duration 30 * 24 * 3600 + 1   # => "4w2d1s"
+    #
+    # It goes from seconds to the year. Months are not counted (as they
+    # are of variable length). Weeks are counted.
+    #
+    # For 30 days months to be counted, the second parameter of this
+    # method can be set to true.
+    #
+    #   Rufus.to_duration 30 * 24 * 3600 + 1, true   # => "1M1s"
+    #
+    # If a Float value is passed, milliseconds will be displayed without
+    # 'marker'
+    #
+    #   Rufus.to_duration 0.051                       # => "51"
+    #   Rufus.to_duration 7.051                       # => "7s51"
+    #   Rufus.to_duration 0.120 + 30 * 24 * 3600 + 1  # => "4w2d1s120"
+    #
+    # (this behaviour mirrors the one found for parse_time_string()).
+    #
+    # Options are :
+    #
+    # * :months, if set to true, months (M) of 30 days will be taken into
+    #   account when building up the result
+    # * :drop_seconds, if set to true, seconds and milliseconds will be trimmed
+    #   from the result
+    #
+    def self.to_duration(seconds, options={})
+
+      h = to_duration_hash(seconds, options)
+
+      return (options[:drop_seconds] ? '0m' : '0s') if h.empty?
+
+      s =
+        DU_KEYS.inject('') { |r, key|
+          count = h[key]
+          count = nil if count == 0
+          r << "#{count}#{key}" if count
+          r
+        }
+
+      ms = h[:ms]
+      s << ms.to_s if ms
+
+      s
+    end
+
+    class << self
+      #-
+      # for compatibility with rufus-scheduler 2.x
+      #+
+      alias to_duration_string to_duration
+      alias to_time_string to_duration
+    end
+
+    # Turns a number of seconds (integer or Float) into a hash like in :
+    #
+    #   Rufus.to_duration_hash 0.051
+    #     # => { :ms => "51" }
+    #   Rufus.to_duration_hash 7.051
+    #     # => { :s => 7, :ms => "51" }
+    #   Rufus.to_duration_hash 0.120 + 30 * 24 * 3600 + 1
+    #     # => { :w => 4, :d => 2, :s => 1, :ms => "120" }
+    #
+    # This method is used by to_duration behind the scenes.
+    #
+    # Options are :
+    #
+    # * :months, if set to true, months (M) of 30 days will be taken into
+    #   account when building up the result
+    # * :drop_seconds, if set to true, seconds and milliseconds will be trimmed
+    #   from the result
+    #
+    def self.to_duration_hash(seconds, options={})
+
+      h = {}
+
+      if seconds.is_a?(Float)
+        h[:ms] = (seconds % 1 * 1000).to_i
+        seconds = seconds.to_i
+      end
+
+      if options[:drop_seconds]
+        h.delete(:ms)
+        seconds = (seconds - seconds % 60)
+      end
+
+      durations = options[:months] ? DURATIONS2M : DURATIONS2
+
+      durations.each do |key, duration|
+
+        count = seconds / duration
+        seconds = seconds % duration
+
+        h[key.to_sym] = count if count > 0
+      end
+
+      h
+    end
+
+    #--
+    # misc
+    #++
+
+    # Produces the UTC string representation of a Time instance
+    #
+    # like "2009/11/23 11:11:50.947109 UTC"
+    #
+    def self.utc_to_s(t=Time.now)
+
+      "#{t.utc.strftime('%Y-%m-%d %H:%M:%S')}.#{sprintf('%06d', t.usec)} UTC"
+    end
+
+    # Produces a hour/min/sec/milli string representation of Time instance
+    #
+    def self.h_to_s(t=Time.now)
+
+      "#{t.strftime('%H:%M:%S')}.#{sprintf('%06d', t.usec)}"
+    end
+
+    # Debugging tools...
+    #
+    class D
+
+      def self.h_to_s(t=Time.now); Rufus::Scheduler.h_to_s(t); end
+    end
+  end
+end
+

data/lib/rufus/scheduler/zones.rb

@@ -0,0 +1,174 @@
+#--
+# Copyright (c) 2006-2015, John Mettraux, jmettraux@gmail.com
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+# Made in Japan.
+#++
+
+
+class Rufus::Scheduler
+
+TIMEZONES = %w[
+GB NZ UCT EET CET PRC ROC WET GMT EST ROK UTC MST HST MET Zulu Cuba Iran W-SU
+Eire GMT0 Libya Japan Egypt GMT+0 GMT-0 Israel Poland Navajo Turkey GB-Eire
+Iceland PST8PDT Etc/UCT CST6CDT NZ-CHAT MST7MDT Jamaica EST5EDT Etc/GMT Etc/UTC
+US/Samoa Etc/GMT0 Portugal Hongkong Etc/Zulu Singapore Asia/Baku Etc/GMT-9
+Etc/GMT+1 Etc/GMT+0 Asia/Aden Etc/GMT+2 Etc/GMT+3 Etc/GMT+4 Etc/GMT+5 Etc/GMT+6
+Etc/GMT+7 Etc/GMT+8 Etc/GMT+9 Etc/GMT-0 Etc/GMT-1 Universal Asia/Dili Greenwich
+Asia/Gaza Etc/GMT-8 Etc/GMT-7 US/Alaska Asia/Oral Etc/GMT-6 Etc/GMT-5 Etc/GMT-4
+Asia/Hovd Etc/GMT-3 US/Hawaii Etc/GMT-2 Kwajalein Asia/Omsk Asia/Macao
+Etc/GMT-14 Asia/Kabul US/Central Etc/GMT-13 US/Arizona Asia/Macau Asia/Qatar
+Asia/Seoul Asia/Tokyo Asia/Dubai US/Pacific Etc/GMT-12 Etc/GMT-11 Etc/GMT-10
+Asia/Dhaka Asia/Dacca Asia/Chita Etc/GMT+12 Etc/GMT+10 Asia/Amman Asia/Aqtau
+Etc/GMT+11 US/Eastern Asia/Thimbu Asia/Brunei Asia/Tehran Asia/Beirut
+Europe/Rome Europe/Riga Brazil/Acre Brazil/East Europe/Oslo Brazil/West
+Africa/Lome Asia/Taipei Asia/Saigon Asia/Riyadh Asia/Aqtobe Asia/Anadyr
+Europe/Kiev Asia/Almaty Africa/Juba Pacific/Yap US/Aleutian Asia/Muscat
+US/Mountain Asia/Harbin Asia/Hebron Asia/Manila Asia/Kuwait Asia/Urumqi
+US/Michigan Indian/Mahe SystemV/EST5 Asia/Kashgar Indian/Cocos Asia/Jakarta
+Asia/Kolkata Asia/Kuching America/Atka Asia/Irkutsk Pacific/Apia Asia/Magadan
+Africa/Dakar America/Lima Pacific/Fiji Pacific/Guam Europe/Vaduz Pacific/Niue
+Asia/Nicosia Africa/Ceuta Pacific/Truk America/Adak Pacific/Wake Africa/Tunis
+Africa/Cairo Asia/Colombo SystemV/AST4 SystemV/CST6 Asia/Karachi Asia/Rangoon
+SystemV/MST7 Asia/Baghdad Europe/Malta Africa/Lagos Europe/Minsk SystemV/PST8
+Canada/Yukon Asia/Tbilisi America/Nome Asia/Bahrain Africa/Accra Europe/Paris
+Asia/Bangkok Asia/Bishkek Asia/Thimphu SystemV/YST9 Asia/Yerevan Asia/Yakutsk
+Europe/Sofia Asia/Ust-Nera Australia/ACT Australia/LHI Europe/Tirane
+Asia/Tel_Aviv Australia/NSW Africa/Luanda Asia/Tashkent Africa/Lusaka
+Asia/Shanghai Africa/Malabo Asia/Sakhalin Africa/Maputo Africa/Maseru
+SystemV/HST10 Africa/Kigali Africa/Niamey Pacific/Samoa America/Sitka
+Pacific/Palau Pacific/Nauru Pacific/Efate Asia/Makassar Pacific/Chuuk
+Africa/Harare Africa/Douala America/Aruba America/Thule America/Bahia
+America/Jujuy America/Belem Asia/Katmandu America/Boise Indian/Comoro
+Indian/Chagos Asia/Jayapura Europe/Zurich Asia/Istanbul Europe/Zagreb
+Etc/Greenwich Europe/Warsaw Europe/Vienna Etc/Universal Asia/Dushanbe
+Europe/Athens Europe/Berlin Africa/Bissau Asia/Damascus Africa/Banjul
+Europe/Dublin Africa/Bangui Africa/Bamako Europe/Jersey Africa/Asmera
+Europe/Lisbon Africa/Asmara Europe/London Asia/Ashgabat Asia/Calcutta
+Europe/Madrid Europe/Monaco Europe/Moscow Europe/Prague Europe/Samara
+Europe/Skopje Asia/Khandyga Canada/Pacific Africa/Abidjan America/Manaus
+Asia/Chongqing Asia/Chungking Africa/Algiers America/Maceio US/Pacific-New
+Africa/Conakry America/La_Paz America/Juneau America/Nassau America/Inuvik
+Europe/Andorra Africa/Kampala Asia/Ashkhabad Asia/Hong_Kong America/Havana
+Canada/Eastern Europe/Belfast Canada/Central Australia/West Asia/Jerusalem
+Africa/Mbabane Asia/Kamchatka America/Virgin America/Guyana Asia/Kathmandu
+Mexico/General America/Panama Europe/Nicosia America/Denver Europe/Tallinn
+Africa/Nairobi America/Dawson Europe/Vatican Europe/Vilnius America/Cuiaba
+Africa/Tripoli Pacific/Wallis Atlantic/Faroe Pacific/Tarawa Pacific/Tahiti
+Pacific/Saipan Pacific/Ponape America/Cayman America/Cancun Asia/Pontianak
+Asia/Pyongyang Asia/Vientiane Asia/Qyzylorda Pacific/Noumea America/Bogota
+Pacific/Midway Pacific/Majuro Asia/Samarkand Indian/Mayotte Pacific/Kosrae
+Asia/Singapore Indian/Reunion America/Belize America/Regina America/Recife
+Pacific/Easter Mexico/BajaSur America/Merida Pacific/Chatham Pacific/Fakaofo
+Pacific/Gambier America/Rosario Asia/Ulan_Bator Indian/Maldives Pacific/Norfolk
+America/Antigua Asia/Phnom_Penh America/Phoenix America/Caracas America/Cayenne
+Atlantic/Azores Pacific/Pohnpei Atlantic/Canary America/Chicago Atlantic/Faeroe
+Africa/Windhoek America/Cordoba America/Creston Africa/Timbuktu America/Curacao
+Africa/Sao_Tome Africa/Ndjamena SystemV/AST4ADT Europe/Uzhgorod Europe/Tiraspol
+SystemV/CST6CDT Africa/Monrovia America/Detroit Europe/Sarajevo Australia/Eucla
+America/Tijuana America/Toronto America/Godthab America/Grenada Europe/Istanbul
+America/Ojinaga America/Tortola Australia/Perth Europe/Helsinki Australia/South
+Europe/Guernsey SystemV/EST5EDT Europe/Chisinau SystemV/MST7MDT Europe/Busingen
+Europe/Budapest Europe/Brussels America/Halifax America/Mendoza America/Noronha
+America/Nipigon Canada/Atlantic America/Yakutat SystemV/PST8PDT SystemV/YST9YDT
+Canada/Mountain Africa/Kinshasa Africa/Khartoum Africa/Gaborone Africa/Freetown
+America/Iqaluit America/Jamaica US/East-Indiana Africa/El_Aaiun America/Knox_IN
+Africa/Djibouti Africa/Blantyre America/Moncton America/Managua Asia/Choibalsan
+America/Marigot Australia/North Europe/Belgrade America/Resolute
+America/Mazatlan Pacific/Funafuti Pacific/Auckland Pacific/Honolulu
+Pacific/Johnston America/Miquelon America/Santarem Mexico/BajaNorte
+America/Santiago Antarctica/Troll America/Asuncion America/Atikokan
+America/Montreal America/Barbados Africa/Bujumbura Pacific/Pitcairn
+Asia/Ulaanbaatar Indian/Mauritius America/New_York Antarctica/Syowa
+America/Shiprock Indian/Kerguelen Asia/Novosibirsk America/Anguilla
+Indian/Christmas Asia/Vladivostok Asia/Ho_Chi_Minh Antarctica/Davis
+Atlantic/Bermuda Europe/Amsterdam Antarctica/Casey America/St_Johns
+Atlantic/Madeira America/Winnipeg America/St_Kitts Europe/Volgograd
+Brazil/DeNoronha Europe/Bucharest Africa/Mogadishu America/St_Lucia
+Atlantic/Stanley Europe/Stockholm Australia/Currie Europe/Gibraltar
+Australia/Sydney Asia/Krasnoyarsk Australia/Darwin America/Dominica
+America/Edmonton America/Eirunepe Europe/Podgorica America/Ensenada
+Europe/Ljubljana Australia/Hobart Europe/Mariehamn Africa/Lubumbashi
+America/Goose_Bay Europe/Luxembourg America/Menominee America/Glace_Bay
+America/Fortaleza Africa/Nouakchott America/Matamoros Pacific/Galapagos
+America/Guatemala Pacific/Kwajalein Pacific/Marquesas America/Guayaquil
+Asia/Kuala_Lumpur Europe/San_Marino America/Monterrey Europe/Simferopol
+America/Araguaina Antarctica/Vostok Europe/Copenhagen America/Catamarca
+Pacific/Pago_Pago America/Sao_Paulo America/Boa_Vista America/St_Thomas
+Chile/Continental America/Vancouver Africa/Casablanca Europe/Bratislava
+Pacific/Enderbury Pacific/Rarotonga Europe/Zaporozhye US/Indiana-Starke
+Antarctica/Palmer Asia/Novokuznetsk Africa/Libreville America/Chihuahua
+America/Anchorage Pacific/Tongatapu Antarctica/Mawson Africa/Porto-Novo
+Asia/Yekaterinburg America/Paramaribo America/Hermosillo Atlantic/Jan_Mayen
+Antarctica/McMurdo America/Costa_Rica Antarctica/Rothera America/Grand_Turk
+Atlantic/Reykjavik Atlantic/St_Helena Australia/Victoria Chile/EasterIsland
+Asia/Ujung_Pandang Australia/Adelaide America/Montserrat America/Porto_Acre
+Africa/Brazzaville Australia/Brisbane America/Kralendijk America/Montevideo
+America/St_Vincent America/Louisville Australia/Canberra Australia/Tasmania
+Europe/Isle_of_Man Europe/Kaliningrad Africa/Ouagadougou America/Rio_Branco
+Pacific/Kiritimati Africa/Addis_Ababa America/Metlakatla America/Martinique
+Asia/Srednekolymsk America/Guadeloupe America/Fort_Wayne Australia/Lindeman
+America/Whitehorse Arctic/Longyearbyen America/Pangnirtung America/Mexico_City
+America/Los_Angeles America/Rainy_River Atlantic/Cape_Verde Pacific/Guadalcanal
+Indian/Antananarivo America/El_Salvador Australia/Lord_Howe Africa/Johannesburg
+America/Tegucigalpa Canada/Saskatchewan America/Thunder_Bay Canada/Newfoundland
+America/Puerto_Rico America/Yellowknife Australia/Melbourne America/Porto_Velho
+Australia/Queensland Australia/Yancowinna America/Santa_Isabel
+America/Blanc-Sablon America/Scoresbysund America/Danmarkshavn
+Pacific/Port_Moresby Antarctica/Macquarie America/Buenos_Aires
+Africa/Dar_es_Salaam America/Campo_Grande America/Dawson_Creek
+America/Indianapolis Pacific/Bougainville America/Rankin_Inlet
+America/Indiana/Knox America/Lower_Princes America/Coral_Harbour
+America/St_Barthelemy Australia/Broken_Hill America/Cambridge_Bay
+America/Indiana/Vevay America/Swift_Current America/Port_of_Spain
+Antarctica/South_Pole America/Santo_Domingo Atlantic/South_Georgia
+America/Port-au-Prince America/Bahia_Banderas America/Indiana/Winamac
+America/Indiana/Marengo America/Argentina/Jujuy America/Argentina/Salta
+Canada/East-Saskatchewan America/Indiana/Vincennes America/Argentina/Tucuman
+America/Argentina/Ushuaia Antarctica/DumontDUrville America/Indiana/Tell_City
+America/Argentina/Mendoza America/Argentina/Cordoba America/Indiana/Petersburg
+America/Argentina/San_Luis America/Argentina/San_Juan America/Argentina/La_Rioja
+America/North_Dakota/Center America/Kentucky/Monticello
+America/North_Dakota/Beulah America/Kentucky/Louisville
+America/Argentina/Catamarca America/Indiana/Indianapolis
+America/North_Dakota/New_Salem America/Argentina/Rio_Gallegos
+America/Argentina/Buenos_Aires America/Argentina/ComodRivadavia
+]
+
+##
+## http://en.wikipedia.org/wiki/List_of_time_zone_abbreviations
+#
+#ABBREVIATIONS = %w[
+#ACDT ACST ACT ADT AEDT AEST AFT AKDT AKST AMST AMST AMT AMT ART AST AST AWDT
+#AWST AZOST AZT BDT BIOT BIT BOT BRT BST BST BTT CAT CCT CDT CDT CEDT CEST CET
+#CHADT CHAST CHOT ChST CHUT CIST CIT CKT CLST CLT COST COT CST CST CST CST CST
+#CT CVT CWST CXT DAVT DDUT DFT EASST EAST EAT ECT ECT EDT EEDT EEST EET EGST EGT
+#EIT EST EST FET FJT FKST FKST FKT FNT GALT GAMT GET GFT GILT GIT GMT GST GST
+#GYT HADT HAEC HAST HKT HMT HOVT HST ICT IDT IOT IRDT IRKT IRST IST IST IST JST
+#KGT KOST KRAT KST LHST LHST LINT MAGT MART MAWT MDT MET MEST MHT MIST MIT MMT
+#MSK MST MST MST MUT MVT MYT NCT NDT NFT NPT NST NT NUT NZDT NZST OMST ORAT PDT
+#PET PETT PGT PHOT PKT PMDT PMST PONT PST PST PYST PYT RET ROTT SAKT SAMT SAST
+#SBT SCT SGT SLST SRET SRT SST SST SYOT TAHT THA TFT TJT TKT TLT TMT TOT TVT UCT
+#ULAT USZ1 UTC UYST UYT UZT VET VLAT VOLT VOST VUT WAKT WAST WAT WEDT WEST WET
+#WIT WST YAKT YEKT Z
+#].uniq
+
+end
+

data/lib/rufus/scheduler/zotime.rb

@@ -0,0 +1,154 @@
+#--
+# Copyright (c) 2006-2015, John Mettraux, jmettraux@gmail.com
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+# Made in Japan.
+#++
+
+require 'rufus/scheduler/zones'
+
+
+class Rufus::Scheduler
+
+  #
+  # Zon{ing|ed}Time, whatever.
+  #
+  class ZoTime
+
+    attr_accessor :seconds
+    attr_accessor :zone
+
+    def initialize(s, zone)
+
+      @seconds = s.to_f
+      @zone = zone
+    end
+
+    def time
+
+      in_zone do
+
+        t = Time.at(@seconds)
+
+        if t.isdst
+          t1 = Time.at(@seconds + 3600)
+          t = t1 if t.zone != t1.zone && t.hour == t1.hour && t.min == t1.min
+            # ambiguous TZ (getting out of DST)
+        else
+          t.hour # force t to compute itself
+        end
+
+        t
+      end
+    end
+
+    def utc
+
+      time.utc
+    end
+
+    def add(s)
+
+      @seconds += s.to_f
+    end
+
+    def substract(s)
+
+      @seconds -= s.to_f
+    end
+
+    def to_f
+
+      @seconds
+    end
+
+    #DELTA_TZ_REX = /^[+-][0-1][0-9]:?[0-5][0-9]$/
+
+    def self.envtzable?(s)
+
+      TIMEZONES.include?(s)
+    end
+
+    def self.parse(str, opts={})
+
+      if defined?(::Chronic) && t = ::Chronic.parse(str, opts)
+        return ZoTime.new(t, ENV['TZ'])
+      end
+
+      begin
+        DateTime.parse(str)
+      rescue
+        raise ArgumentError, "no time information in #{o.inspect}"
+      end if RUBY_VERSION < '1.9.0'
+
+      zone = nil
+
+      s =
+        str.gsub(/\S+/) { |m|
+          if envtzable?(m)
+            zone ||= m
+            ''
+          else
+            m
+          end
+        }
+
+      return nil unless zone.nil? || is_timezone?(zone)
+
+      zt = ZoTime.new(0, zone || ENV['TZ'])
+      zt.in_zone { zt.seconds = Time.parse(s).to_f }
+
+      zt.seconds == nil ? nil : zt
+    end
+
+    def self.is_timezone?(str)
+
+      return false if str == nil
+
+      return true if Time.zone_offset(str)
+      return true if str == 'Zulu'
+
+      return !! (::TZInfo::Timezone.get(str) rescue nil) if defined?(::TZInfo)
+
+      zt = ZoTime.new(0, str)
+      t = zt.time
+
+      return false if t.zone == ''
+      return false if str.match(/[a-z]/) && str.start_with?(t.zone)
+
+      return false if RUBY_PLATFORM.include?('java') && ! envtzable?(str)
+
+      true
+    end
+
+    def in_zone(&block)
+
+      current_timezone = ENV['TZ']
+      ENV['TZ'] = @zone
+
+      block.call
+
+    ensure
+
+      ENV['TZ'] = current_timezone
+    end
+  end
+end
+