time-helper 1.2 → 1.3

data/README

@@ -31,3 +31,24 @@ using .add or .substract
 | Time.local(2011,12,24,22,10,54) | add | {:year => 2, :month => 1 } | Time.local(2011,12,24,22,10,54) + (2*60*60*24*365 + 60*60*24*30) |
 | Time.local(2012,05,01,12,20,31) | substract | {:month => 2, :day => 3} | Time.local(2012,05,01,12,20,31) - (60*60*24*30*2 + 60*60*24*3)|
 | Time.local(2011,12,24,22,10,54) | add | {:day => 1, :hour => 3} |Time.local(2011,12,24,22,10,54) + (60*60*24 + 60*60*3) |
+
+
+**********************************************
+*How is this diferent than just "Time.parse"?*
+**********************************************
+
+Time.parse does not work well with non-American formats, if like me, you're working with strings that have dates in a for
+mat like: DD/MM/YYYY Time.parse will not do. In fact, if you rewrite strtotime so it just calls parse a few of the tests 
+included will fail.
+
+
+New in 1.3:
+Added support for time strings in the format you'd usualy pass to Time.parse
+Added utc_parse method for the lazy, it parses the date and converts it to utc
+
+New in 1.2
+Tomorrow and Yesterday methods
+
+New in 1.1 
+I skiped this version.... because I suck at versioning 
+

data/lib/time-helper.rb

@@ -1,26 +1,33 @@
-#@version 1.0.0
+#@version 1.3.0
 #@author Arthur
 class Time
+    require 'time'
     #class methods
     class << self
-        #@param string [String] a datetime string with many possible formats 
+        #@param string [String] a datetime string with many possible formats
         #@see Time#valid_datetime? or the feature file for valid format
         #@return [Time] set in the date of the string passed
         def strtotime string
-            abort 'invalid date' unless valid_datetime? string
+            unless valid_datetime? string
+                begin
+                    return Time.parse(string)
+                rescue 
+                    raise InvalidTimeStringFormat
+                end
+            end
             h,m,s = 0,0,0
 
             if date_or_dt( string ) == :datetime
                 separator = dt_get_separator string
                 date, time = 0, 0
-                if separator 
+                if separator
                     date, time = string.split( separator )
                 else
                     date, time = string[0..7], string[8..13]
                 end
                 h,m,s  = get_time_array time
                 string = date
-            end    
+            end
             separator = get_separator string
             order     = get_order string
             if separator
@@ -28,7 +35,7 @@ class Time
                 if order == :dmy
                     return Time.local( yd, mo, dy,h,m,s )
                 elsif order == :ymd
-                    return Time.local( dy, mo, yd,h,m,s) 
+                    return Time.local( dy, mo, yd,h,m,s)
                 end
             end
             if order == :dmy
@@ -36,12 +43,12 @@ class Time
             elsif order == :ymd
                 return Time.local( string[0..3].to_i, string[4..5].to_i, string[6..7].to_i,h,m,s )
             end
-            
+
         end
         #@param string [String] datetime string
-        #@return [Boolean] 
+        #@return [Boolean]
         def valid_datetime? string
-            return false unless string.match /\d{2,4}.?\d{2}.?\d{2,4}(?:.?\d{2}:?\d{2}:?\d{2})?/
+            return false unless string.match /^\d{2,4}.?\d{2}.?\d{2,4}(?:.?\d{2}:?\d{2}:?\d{2})?$/
             return true
         end
         #@return [Time] Time object set 24 hours ago
@@ -52,6 +59,13 @@ class Time
         def yesterday
             return Time.now.substract(:day => 1 )
         end
+        #Converts a Date in to utc format
+        #
+        #@param value [String] 
+        #@return [Time] in UTC
+        def utc_parse value
+            Time.strtotime(value).utc
+        end
         private
             def get_time_array time
                 h,m,s = 0,0,0
@@ -99,12 +113,12 @@ class Time
             #see Time#get_order
             def get_dt_order string
                 separator = dt_get_separator string
-                if separator 
+                if separator
                     return get_order( string.split( separator )[0] )
                 end
                 return get_order( string[0..7] )
             end
-            
+
             #@param string [String] date string
             #@return [symbol] order dmy or ymd
             def get_order string
@@ -124,14 +138,14 @@ class Time
                     return no_separator_order string
                 end
             end
-             
+
             #@param string [String] date string
             #@return [symbol] order dmy or ymd
             #@note called when no separator is found on string
             #@note might not work well for years < 1970 or > 2020
             #@note experimental
             def no_separator_order string
-                if string[0..1].to_i <= 31 and string[2..3].to_i <= 12 and string[4..7].to_i >= 1970 
+                if string[0..1].to_i <= 31 and string[2..3].to_i <= 12 and string[4..7].to_i >= 1970
                     return :dmy
                 elsif string[0..3].to_i >= 1970 and string[4..5].to_i and string[6..7].to_i <= 31
                     return :ymd
@@ -141,11 +155,11 @@ class Time
     end
 
     #@param params [Hash] hash of time to be added {:time => amount } (can take several at once)
-    #@return [Time] new time object with date set to the result 
+    #@return [Time] new time object with date set to the result
     # @example add time
     #  t = Time.now()
     #  t.add(:year => 1 ) #=> a time object set for 365 days from now
-    #  t.add(:year => 2, :day => 1 ) #=>  a time object set 731 days from now    
+    #  t.add(:year => 2, :day => 1 ) #=>  a time object set 731 days from now
     #  accepts :year :month :day :minute :hour :second :week
     def add params
         seconds = get_seconds params
@@ -153,7 +167,7 @@ class Time
     end
 
     #@param params [Hash] hash of time to be added {:time => amount } (can take several at once)
-    #@return [Time] new time object with date set to the result 
+    #@return [Time] new time object with date set to the result
     # @example substract time
     #  t = Time.now()
     #  t.substract(:year => 1 ) returns a time object set for 365 days ago
@@ -163,7 +177,6 @@ class Time
         seconds = get_seconds params
         return self - seconds
     end
-
     private
         #@note may not account for leap years etc
         def get_seconds params
@@ -184,3 +197,5 @@ class Time
         end
 
 end
+class InvalidTimeStringFormat < StandardError
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: time-helper
 version: !ruby/object:Gem::Version 
-  version: "1.2"
+  version: "1.3"
 platform: ruby
 authors: 
 - Arthur Silva
@@ -9,11 +9,22 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-05-02 00:00:00 +01:00
+date: 2012-05-30 00:00:00 +01:00
 default_executable: 
 dependencies: []
 
-description: "Adds a few methods to the Time class, more significant:\n\n    strtotime which returns a Time object based on a string.\n\n    also methods add and substract that allow you to do some easy date math (doesn't take leap months/years into account)\n also tomorrow and yesterday methods witch are like Time.now +- 1 day "
+description: "  Adds a few methods to the Time class, more significant:\n\n    strtotime which returns a Time object based on a string.\n\n    also methods add and substract that allow you to do some easy date math (doesn't take leap months/years into account)\n also tomorrow and yesterday methods witch are like Time.now +- 1 day\n\n\
+  **********************************************\n\
+  *How is this diferent than just \"Time.parse\"?*\n\
+  **********************************************\n\n\
+  Time.parse does not work well with non-American formats, if like me, you're working with strings that have dates in a format like: DD/MM/YYYY Time.parse will not do. In fact, if you rewrite strtotime so it just calls parse a few of the tests included will fail.\n\n\n\
+  New in 1.3:\n\
+  Added support for time strings in the format you'd usualy pass to Time.parse\n\
+  Added utc_parse method for the lazy, it parses the date and converts it to utc\n\n\
+  New in 1.2\n\
+  Tomorrow and Yesterday methods\n\n\
+  New in 1.1 \n\
+  I skiped this version.... because I suck at versioning \n\n"
 email: awls99@gmail.com
 executables: []