zones 0.5.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 93f46e66599119d3fc322a6f13b99004465fb68341036264e1d38e3c4c939a63
+  data.tar.gz: 1dc9d208033d43fc909be86b210122149277f9c01b4c6561ecb271b14417b350
+SHA512:
+  metadata.gz: df746b79666d56534e923d5e63b6690cf7b92a9f93cf646167c8e610e9d362967abffb07cf431bce3aa1fbfbbb468585a5901821f46c12fe0bdae990cc0a6da3
+  data.tar.gz: b83975032a26e13b851f0efbd3cf3f136714c63ce62c9082e01351fd1661b761ff6c86a1e51290e316194797de736f30f5dc0c41b5bb059eeeb825c4eada6519

data/.ruby-version

@@ -0,0 +1 @@
+2.5.0

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Steve Shreeve
+
+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.

data/README.md

@@ -0,0 +1,19 @@
+# zones
+
+`zones` is a Ruby gem that makes it easy to parse time and convert it between time zones.
+
+## Examples
+
+```ruby
+# when parsing, the "!" means to ignore the supplied time zone / offset
+x = "3 August 2017 11:43 +0415".to_tz("US/Pacific")  # 2017-08-03 00:28:00 -0700
+y = "3 August 2017 11:43 +0415".to_tz!("US/Pacific") # 2017-08-03 11:43:00 -0700
+
+# when converting, the "!" means to only change the offset
+x.to_tz("US/Eastern")  # 2017-08-03 03:28:00 -0400
+y.to_tz!("US/Eastern") # 2017-08-03 11:43:00 -0400
+```
+
+## License
+
+This software is licensed under terms of the MIT License.

data/lib/zones.rb

@@ -0,0 +1,98 @@
+require "tzinfo"
+
+class Time
+  def self.parse_str(str, ignore_offset=false)
+    case str
+    when %r!^((?:19|20)\d\d)(\d\d)(\d\d)(\d\d)(\d\d)(\d\d)?\.?(\d+)?([-+]\d\d:?\d\d)?!
+      ymd = [$1.to_i, $2.to_i, $3.to_i]
+      hms = [$4.to_i, $5.to_i, "#{$6}.#{$7}".to_f]
+      off = $8.sub(/(\d)(\d\d)$/,"\1:\2") if $8 && !ignore_offset
+    when %r!^
+      (?:(0[1-9]|[12]\d|3[01]|[1-9][-/ ])[-/ ]? #  $1: day
+         ((?>[a-z]{3,9}))[-/ ]?                 #  $2: month
+         ((?>19|20)\d\d)                        #  $3: year
+      | # or...
+         ((?>19|20)\d\d)[-/]?                   #  $4: year
+         (0[1-9]|1[012]|[1-9][-/])[-/]?         #  $5: month
+         (0[1-9]|[12]\d|3[01]|[1-9][\sT])       #  $6: day
+      | # or...
+         (0[1-9]|1[012]|[1-9][-/])[-/]?         #  $7: month
+         (0[1-9]|[12]\d|3[01]|[1-9][-/])[-/]?   #  $8: day
+         ((?>19|20)\d\d)                        #  $9: year
+      )\s?T?\s?
+      (\d\d?)?                                  # $10: hour
+      :?(\d\d)?                                 # $11: min
+      :?(\d\d)?                                 # $12: sec
+      \.?(\d+)?                                 # $13: dec
+      \s?(?:(a|p)?m)?                           # $14: am/pm
+      \s?(([-+])?(\d\d):?(\d\d)|UTC|GMT)?       # $15: offset ($16=sign, $17=hours, $18=mins)
+    !iox
+      ymd = $1 ? [$3.to_i, month_num($2), $1.to_i] : $4 ? [$4.to_i, $5.to_i, $6.to_i] : [$9.to_i, $7.to_i, $8.to_i]
+      hms = [$14 ? ($10.to_i % 12) + (($14=="P" || $14=="p") ? 12 : 0) : $10.to_i, $11.to_i, "#{$12}.#{$13}".to_f]
+      off = ($17 ? "#{$16||'+'}#{$17}:#{$18}" : "+00:00") if $15 && !ignore_offset
+    else
+      raise "can't parse: #{str}"
+    end
+    off ? [ymd, hms, off] : [ymd, hms]
+  end
+
+  # get month number
+  def self.month_num(str)
+    (@month_num ||= {
+      "jan" => 1, "january"  =>  1, "jul" =>  7, "july"      =>  7,
+      "feb" => 2, "february" =>  2, "aug" =>  8, "august"    =>  8,
+      "mar" => 3, "march"    =>  3, "sep" =>  9, "septmeber" =>  9,
+      "apr" => 4, "april"    =>  4, "oct" => 10, "october"   => 10,
+      "may" => 5,                   "nov" => 11, "november"  => 11,
+      "jun" => 6, "june"     =>  6, "dec" => 12, "december"  => 12,
+    })[str.downcase] or raise "bad month: #{str}"
+  end
+
+  # parse time and honor desired timezone
+  def self.to_tz(str, to_tz=nil, ignore_offset=false)
+    ymd, hms, off = parse_str(str, ignore_offset)
+    out = Time.new(*ymd, *hms, off)
+    if to_tz
+      if off
+        out = out.to_tz(to_tz)
+      else
+        utc = out.utc
+        off = TZInfo::Timezone.get(to_tz).utc_to_local(utc) - utc
+        out = Time.new(*ymd, *hms, off)
+      end
+    else
+      out
+    end
+  end
+
+  # ignore supplied timezone, use local
+  def self.to_tz!(str, to_tz=nil)
+    to_tz(str, to_tz, true)
+  end
+
+  # transform time to new timezone
+  def to_tz(to_tz)
+    utc = utc? ? self : getutc
+    raw = TZInfo::Timezone.get(to_tz).utc_to_local(utc)
+    all = raw.to_a[1,5].reverse.push(strftime("%S.%6N").to_f) # retain fractional seconds
+    out = Time.new(*all, raw - utc)
+  end
+
+  # preserve time but change offset
+  def to_tz!(to_tz)
+    all = to_a[1,5].reverse.push(strftime("%S.%6N").to_f) # retain fractional seconds
+    raw = Time.utc(*all)
+    utc = TZInfo::Timezone.get(to_tz).local_to_utc(raw)
+    out = Time.new(*all, raw - utc)
+  end
+end
+
+class String
+  def to_tz(*args)
+    Time.to_tz(self, *args)
+  end
+
+  def to_tz!(*args)
+    Time.to_tz!(self, *args)
+  end
+end

data/zones.gemspec

@@ -0,0 +1,13 @@
+# encoding: utf-8
+
+Gem::Specification.new do |s|
+  s.name        = "zones"
+  s.version     = "0.5.0"
+  s.author      = "Steve Shreeve"
+  s.email       = "steve.shreeve@gmail.com"
+  s.summary     = "Easy time parsing and conversion between time zones"
+  s.description = "This gem makes it easy to work with time zones."
+  s.homepage    = "https://github.com/shreeve/zones"
+  s.license     = "MIT"
+  s.files       = `git ls-files`.split("\n") - %w[.gitignore]
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: zones
+version: !ruby/object:Gem::Version
+  version: 0.5.0
+platform: ruby
+authors:
+- Steve Shreeve
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-05-24 00:00:00.000000000 Z
+dependencies: []
+description: This gem makes it easy to work with time zones.
+email: steve.shreeve@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".ruby-version"
+- Gemfile
+- LICENSE
+- README.md
+- lib/zones.rb
+- zones.gemspec
+homepage: https://github.com/shreeve/zones
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: Easy time parsing and conversion between time zones
+test_files: []