timing 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 513cf98c752998d82ff09b269bf4754776c2859f31f8c34a09bbfb63e2c34d82
-  data.tar.gz: 3ef7a9b880f6b045909566f6b9a9f1c4c96ab760af4866197ef069f19ea49b23
+  metadata.gz: 8b759b410d5c8ac1cbdbbe5868ebbceab9a7a11a8b5e8edba0678a1336e5c0de
+  data.tar.gz: 58cf565f2bbcf85484940e33906ab03418d4fd04ad191cd85edc25f8dde6c149
 SHA512:
-  metadata.gz: 6695542acd878fa25fa098b60c6288925e9882afb5fd1e3b9f926e61c72c17e7f2e794f4e19c70367f770e6c2be63b0feab55f0aefcb97ce69f1d4010db1e9a8
-  data.tar.gz: d62cf015cf052d8d9495acb5097254dcf20b7ec41bab900da6ad80f0ae9588bf2c228a6c2d0f9d2e6516babc10e929433ec3d468d68b349a898df1b720692399
+  metadata.gz: 0fbc1aa7065242e4354ddf4275dea30b228e526a116dcc7e7ae8db73e8dc10b4181d5618d965b26837e86dabbeac65e396441e1db7bbbe73a2cf474a68f7b80b
+  data.tar.gz: 131b24b4d1b443d1c4ed35e0adcf4ab99c211dad29d4d9ac1b218f299280f4afa924dfb387e597901b39fe706dacfec8fdfc49eb88428e9f287bb1ca2893ebb9

data/README.md

@@ -94,6 +94,7 @@ Timing::NaturalTimeLanguage.parse 'now'
 ```
 
 Named moments
+```
 - now
 - Now -0500
 - today
@@ -101,37 +102,47 @@ Named moments
 - Today -0600
 - yesterday -0400
 - tomorrow -0300
+```
 
 Last/Next day name
+```
 - last Monday +0200
 - last fri +0100
 - next tuesday +0000
 - next sat -0100
 - last thursday including today -0300
 - next mon including today +0200
+```
 
 Date (at 00:00:00)
+```
 - 6 April
 - 14 Jul 2010 +0400
 - 2015-09-03
 - 2015-06-20 -0800
-    
+```
+
 Beginning/End of interval
+```
 - Beginning of month
 - end of year +0700
 - beginning of week
 - End of Day -0100
 - end of hour +0400
+```
 
 Time ago (now - interval)
+```
 - 1 minute ago
 - 3 hours ago -0500
 - 5 days ago -0100
 - 4 weeks ago +0100
 - 10 months ago +0330
 - 7 years ago -0700
+```
 
 Date at time
+```
 - today at 15:40
 - last sunday at 08:43:21 -0300
 - yesterday at beginning
@@ -142,8 +153,10 @@ Date at time
 - 2001-07-14 at 18:41
 - 2012-08-17 14:35:20
 - 1980-04-21T08:15:03-0500
+```
 
 Before/After moment
+```
 - 15 minutes from now
 - 3 days before yesterday
 - 1 month from today
@@ -152,6 +165,40 @@ Before/After moment
 - 1 month before beginning of month
 - 1 year before 9 Sep +0300
 - 2 years from 2001-05-21T12:30:40 -0500
+```
+
+
+#### HourMinutesSeconds
+
+Hour, minutes and seconds model.
+
+```ruby
+HourMinutesSeconds.new 9, 23, 41 # => 09:23:41
+HourMinutesSeconds.new 9, 23     # => 09:23:00
+HourMinutesSeconds.new 9         # => 09:23:00
+
+hhmmss = HourMinutesSeconds.parse '9:23:41'
+hhmmss.hour    # => 9
+hhmmss.minutes # => 23
+hhmmss.seconds # => 41
+hhmmss.iso8601 # => 09:23:41
+```
+
+
+#### ZoneOffset
+
+Seconds wrapper helper for utc offset
+
+```ruby
+Timing::ZoneOffset.new -10800 # => -0300 (-10800.0)
+Timing::ZoneOffset.new 21600  # => +0600 (21600.0)
+
+Timing::ZoneOffset.parse '-0300' # => -0300 (-10800.0)
+Timing::ZoneOffset.parse '+0600' # => +0600 (21600.0)
+
+zone_offset = Timing::ZoneOffset.parse '-0300'
+zone_offset.iso8601 # => '-03:00'
+```
 
 ## Contributing
 

data/lib/timing/hour_minutes_seconds.rb

@@ -0,0 +1,78 @@
+module Timing
+  class HourMinutesSeconds
+
+    HH_MM_SS_REGEX = /^(?<hour>\d{1,2})(:(?<minutes>\d{1,2}))?(:(?<seconds>\d{1,2}))?$/
+
+    attr_reader :hour, :minutes, :seconds
+
+    def initialize(hour, minutes=0, seconds=0)
+      raise ArgumentError, "Invalid hour #{hour}" if !hour.is_a?(Integer) || hour < 0 || hour > 23
+      raise ArgumentError, "Invalid minutes #{minutes}" if !minutes.is_a?(Integer) || minutes < 0 || minutes > 59
+      raise ArgumentError, "Invalid minutes #{seconds}" if !seconds.is_a?(Integer) || seconds < 0 || seconds > 59
+
+      @hour = hour
+      @minutes = minutes
+      @seconds = seconds
+    end
+
+    def iso8601
+      [hour, minutes, seconds].map { |d| d.to_s.rjust(2, '0') }.join(':')
+    end
+    alias_method :to_s, :iso8601
+    alias_method :inspect, :iso8601
+
+    def ==(other)
+      other.kind_of?(self.class) && hash == other.hash
+    end
+    alias_method :eql?, :==
+
+    def hash
+      [hour, minutes, seconds].hash
+    end
+
+    def >(other)
+      raise ArgumentError, "Invalid argument #{other}" unless other.is_a?(HourMinutesSeconds)
+
+      (hour > other.hour) ||
+      (hour == other.hour && minutes > other.minutes) ||
+      (hour == other.hour && minutes == other.minutes && seconds > other.seconds)
+    end
+
+    def <(other)
+      raise ArgumentError, "Invalid argument #{other}" unless other.is_a?(HourMinutesSeconds)
+
+      (hour < other.hour) ||
+      (hour == other.hour && minutes < other.minutes) ||
+      (hour == other.hour && minutes == other.minutes && seconds < other.seconds)
+    end
+
+    def >=(other)
+      self > other || self == other
+    end
+
+    def <=(other)
+      self < other || self == other
+    end
+
+    def <=>(other)
+      if self == other
+        0
+      elsif self > other
+        1
+      else
+        -1
+      end
+    end
+
+    def between?(from, to)
+      self >= from && self <= to
+    end
+    
+    def self.parse(expression)
+      match = expression.to_s.match HH_MM_SS_REGEX
+      raise ArgumentError, "Invalid expression #{expression}" unless match
+      new(*match.names.map { |n| (match[n] || 0).to_i })
+    end
+
+  end
+end

data/lib/timing/time_in_zone.rb

@@ -6,7 +6,7 @@ module Timing
     REGEXP = /[+-]\d\d:?\d\d$/
 
     def_delegators :time, :to_i, :to_f, :to_date, :to_datetime, :between?, :==, :<, :<=, :>, :>=, :<=>, :hash
-    def_delegators :time_with_offset, :year, :month, :day, :hour, :min, :sec, :wday, :yday
+    def_delegators :time_with_offset, :year, :month, :day, :hour, :min, :sec, :wday, :yday, :sunday?, :monday?, :tuesday?, :wednesday?, :thursday?, :friday?, :saturday?
 
     attr_reader :zone_offset
     

data/lib/timing/version.rb

@@ -1,3 +1,3 @@
 module Timing
-  VERSION = '0.1.3'
+  VERSION = '0.2.0'
 end

data/lib/timing.rb

@@ -9,6 +9,7 @@ require 'timing/helpers'
 require 'timing/interval'
 require 'timing/zone_offset'
 require 'timing/time_in_zone'
+require 'timing/hour_minutes_seconds'
 require 'timing/natural_time_language'
 require 'timing/natural_time_language_interpreters'
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: timing
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - Gabriel Naiman
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-12-15 00:00:00.000000000 Z
+date: 2018-12-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: treetop
@@ -168,6 +168,7 @@ files:
 - Rakefile
 - lib/timing.rb
 - lib/timing/helpers.rb
+- lib/timing/hour_minutes_seconds.rb
 - lib/timing/interval.rb
 - lib/timing/natural_time_language.rb
 - lib/timing/natural_time_language.treetop