Sha256: 00011986b9d5674fe520c039ca1a943978765ae30cef64428670ac30142e42e4

Contents?: true

Size: 1.64 KB

Versions: 7

Compression:

Stored size: 1.64 KB

Contents

require 'date' # needed for 1.9.1

module ICU
  class Util

=begin rdoc

== Parsing dates

The method _parsedate!_ parses strings into date objects, interpreting nn/nn/nnnn as dd/mm/yyyy. It raises an exception on error.

  Util.parsedate!('1955-11-09')       # => Date (1955-11-09)
  Util.parsedate!('02/03/2009')       # => Date (2009-03-02)
  Util.parsedate!('02/23/2009')       # => Date (2009-02-23)
  Util.parsedate!('16th June 1986')   # => Date (1986-06-16)
  Util.parsedate!('not a date')       # exception raised

Note that the parse method of the Date class behaves differently in Ruby 1.8.7 and 1.9.1.
In 1.8.7 it assumes American dates and will raise ArgumentError on "30/03/2003".
In 1.9.1 it assumes European dates and will raise ArgumentError on "03/30/2003".

== Diffing dates

The method _age_ returns the difference of two dates:

  Util.age(born, date)               # age in years at the given date (Float)
  Util.age(born)                     # age in years now (today)

Internally it uses _parsedate!_ so can throw a exception if an invalid date is supplied.

=end

    def self.parsedate!(date)
      return date.clone if date.is_a?(Date)
      string = date.to_s.strip
      raise "invalid date (#{date})" unless string.match(/[1-9]/)
      string = [$3].concat($2.to_i > 12 ? [$1, $2] : [$2, $1]).join('-') if string.match(/^(\d{1,2}).(\d{1,2}).(\d{4})$/)
      begin
        Date.parse(string, true)
      rescue
        raise "invalid date (#{date})"
      end
    end

    def self.age(born, date=Date.today)
      born = parsedate!(born)
      date = parsedate!(date)
      date.year - born.year + (date.yday - born.yday) / 366.0
    end
  end
end

Version data entries

7 entries across 7 versions & 1 rubygems

Version Path
icu_ratings-1.0.4 lib/icu_ratings/util.rb
icu_ratings-1.0.3 lib/icu_ratings/util.rb
icu_ratings-1.0.2 lib/icu_ratings/util.rb
icu_ratings-1.0.1 lib/icu_ratings/util.rb
icu_ratings-1.0.0 lib/icu_ratings/util.rb
icu_ratings-0.3.1 lib/icu_ratings/util.rb
icu_ratings-0.3.0 lib/icu_ratings/util.rb