sixarm_ruby_date_age 1.1.0

data/INSTALL.txt

@@ -0,0 +1,32 @@
+
+= SixArm.com Ruby Gem Install
+
+
+First-time users: add our gem certificate and source.
+When you do this once, it works for all our gems.
+
+  sudo wget http://sixarm.com/sixarm.pem
+  sudo gem cert --add sixarm.pem   
+  sudo gem sources --add http://sixarm.com
+
+Install the gem with advanced options.
+
+  sudo gem install sixarm_ruby_date_age --test --trust-policy HighSecurity
+
+
+== Notes
+
+Do you have any questions, comments, suggestions, or feedback?
+Let us know, we're happy to help. Our email is sixarm@sixarm.com
+
+Do you want to create your own high security gems?
+Learn how at http://www.rubygems.org/read/chapter/21
+
+To see your current gem certificate list:
+
+  sudo gem cert --list
+
+Our cert looks like this:
+
+  /C=US/ST=California/L=San Francisco/O=SixArm/CN=sixarm.com
+

data/LICENSE.txt

@@ -0,0 +1,12 @@
+LICENSE
+
+You may choose any of these licenses:
+
+  - CreativeCommons License, Non-commercial Share Alike
+  - LGPL, GNU Lesser General Public License
+  - MIT License
+  - Ruby License
+
+THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

data/README.rdoc

@@ -0,0 +1,24 @@
+
+
+= SixArm.com » Ruby » Date #age_in_years and #age_in_days methods
+
+Author:: Joel Parker Henderson, joelparkerhenderson@gmail.com
+Copyright:: Copyright (c) 2006-2011 Joel Parker Henderson
+License:: See LICENSE.txt file
+
+Date extensions to calculate an age in days and years.
+
+@example
+
+  date=Date.new(1980,10,31)
+  date.age_in_days => 11124
+  date.age_in_years => 31
+
+@example of custom dates
+
+  date=Date.new(1980,10,31)
+  new_years_eve=(2011,12,31)
+  date.age_in_days_on(new_years_eve) => 11383
+  date.age_in_years_on(new_years_eve) => 31
+
+

data/Rakefile

@@ -0,0 +1,8 @@
+# -*- coding: utf-8 -*-
+require 'rake'
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib' << 'test'
+  t.pattern = 'test/*.rb'
+end

data/lib/sixarm_ruby_date_age.rb

@@ -0,0 +1,93 @@
+# -*- coding: utf-8 -*-
+
+=begin rdoc
+
+= SixArm.com » Ruby » Date #age_in_years and #age_in_days methods
+
+Author:: Joel Parker Henderson, joelparkerhenderson@gmail.com
+Copyright:: Copyright (c) 2006-2011 Joel Parker Henderson
+License:: See LICENSE.txt file
+
+Date extensions to calculate an age in days and years.
+
+@example
+
+  date=Date.new(1980,10,31)
+  date.age_in_days => 11124
+  date.age_in_years => 31
+
+@example of custom dates
+
+  date=Date.new(1980,10,31)
+  new_years_eve=(2011,12,31)
+  date.age_in_days_on(new_years_eve) => 11383
+  date.age_in_years_on(new_years_eve) => 31
+
+
+=end
+
+
+class Date
+
+
+  # @return [Integer] the age in days for a given date.
+  #
+  # @example
+  #
+  #   date=Date.new(1980,10,31)
+  #   date.age_in_days => 11124
+  #
+  # @example of custom dates
+  #
+  #   date=Date.new(1980,10,31)
+  #
+  #   valentines = Date.new(2011,02,14)
+  #   date.age_in_days(valentines) => 11063
+  #
+  #   halloween = Date.new(2011,10,31)
+  #   date.age_in_days(halloween) => 11322
+  #
+  #   new_years_eve = Date.new(2011,12,31)
+  #   date.age_in_days(new_years_eve) => 11383
+
+  def age_in_days(compare_date=Date.today)
+    (compare_date.is_a? Date) or raise ArgumentError, "compare_date must be a date"
+    (compare_date-self).to_i
+  end
+
+  alias :age_in_days_on :age_in_days 
+
+
+  # @return [Integer] the age in years for a given date.
+  #
+  # @example
+  #
+  #   date=Date.new(1980,10,31)
+  #   date.age_in_years => 30
+  #
+  # @example of custom dates
+  #
+  #   date=Date.new(1980,10,31)
+  #
+  #   valentines = Date.new(2011,02,14)
+  #   date.age_in_years_on(valentines) => 30  # before the birthday
+  #
+  #   halloween = Date.new(2011,10,31)
+  #   date.age_in_years_on(halloween) => 31  # on the birthday is one year older
+  #
+  #   new_years_eve = Date.new(2011,12,31)
+  #   date.age_years(new_years_eve) => 31  # after the birthday is one year older
+
+  def age_in_years(compare_date=Date.today)
+    (compare_date.is_a? Date) or raise ArgumentError, "compare_date must be a date"
+    age=compare_date.year-year
+    compare_month = compare_date.month
+    age-=1 if compare_month < month or (compare_month==month and compare_date.day < day)
+    age
+  end
+
+  alias :age_in_years_on :age_in_years 
+
+end
+
+

data/test/sixarm_ruby_date_age_test.rb

@@ -0,0 +1,43 @@
+# -*- coding: utf-8 -*-
+require 'simplecov'
+SimpleCov.start
+require 'test/unit'
+require 'sixarm_ruby_date_age'
+
+class DateAgeTest < Test::Unit::TestCase
+
+  # for test_age_years and test_age_days
+  BIRTHDATE     = Date.new(1980,10,31)
+  VALENTINES    = Date.new(2011,02,14)
+  HALLOWEEN     = Date.new(2011,10,31)
+  NEW_YEARS_EVE = Date.new(2011,12,31)
+
+  def test_age_in_days
+    assert_equal(11063,BIRTHDATE.age_in_days(VALENTINES),     '< birthday')
+    assert_equal(11322,BIRTHDATE.age_in_days(HALLOWEEN),      '= birthday')
+    assert_equal(11383,BIRTHDATE.age_in_days(NEW_YEARS_EVE),  '> birthday')
+  end
+
+  def test_age_in_days_with_non_date
+    assert_raise(ArgumentError){ BIRTHDATE.age_in_days('') }
+  end
+
+  def test_age_in_days_alias
+    assert_equal(BIRTHDATE.age_in_days(VALENTINES), BIRTHDATE.age_in_days_on(VALENTINES))
+  end
+
+  def test_age_in_years
+    assert_equal(30,BIRTHDATE.age_in_years(VALENTINES),    '< birthday')
+    assert_equal(31,BIRTHDATE.age_in_years(HALLOWEEN),     '= birthday')
+    assert_equal(31,BIRTHDATE.age_in_years(NEW_YEARS_EVE), '> birthday')
+  end
+
+  def test_age_in_years_with_non_date
+    assert_raise(ArgumentError){ BIRTHDATE.age_in_years('') }
+  end
+
+  def test_age_in_years_alias
+    assert_equal(BIRTHDATE.age_in_years(VALENTINES), BIRTHDATE.age_in_years_on(VALENTINES))
+  end
+
+end

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification 
+name: sixarm_ruby_date_age
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 1.1.0
+platform: ruby
+authors: 
+- SixArm
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDBDCCAm2gAwIBAgIJAKPwEETU5bHoMA0GCSqGSIb3DQEBBQUAMGAxCzAJBgNV
+  BAYTAlVTMRMwEQYDVQQIEwpDYWxpZm9ybmlhMRYwFAYDVQQHEw1TYW4gRnJhbmNp
+  c2NvMQ8wDQYDVQQKEwZTaXhBcm0xEzARBgNVBAMTCnNpeGFybS5jb20wHhcNMTAx
+  MjEzMjMyNzEzWhcNMTMwOTA4MjMyNzEzWjBgMQswCQYDVQQGEwJVUzETMBEGA1UE
+  CBMKQ2FsaWZvcm5pYTEWMBQGA1UEBxMNU2FuIEZyYW5jaXNjbzEPMA0GA1UEChMG
+  U2l4QXJtMRMwEQYDVQQDEwpzaXhhcm0uY29tMIGfMA0GCSqGSIb3DQEBAQUAA4GN
+  ADCBiQKBgQC94mD9JDwBsunsOI0VR3CXXbOWg9cWaWciwFyJNFiM7A9I8KPLfXUw
+  QC4czUe5ZuG4WHvinrWhkrCK+1dWBqoEClxdF/FoKO5a+tonGCjjmfy81JmFjjyx
+  eTsjsHyvw+Qik9kpf9aj6+pnkNrVswgNHVea2o9yabbEiS6VSeJWoQIDAQABo4HF
+  MIHCMB0GA1UdDgQWBBQzPJtqmSgc53eDN7aSzDQwr9TALDCBkgYDVR0jBIGKMIGH
+  gBQzPJtqmSgc53eDN7aSzDQwr9TALKFkpGIwYDELMAkGA1UEBhMCVVMxEzARBgNV
+  BAgTCkNhbGlmb3JuaWExFjAUBgNVBAcTDVNhbiBGcmFuY2lzY28xDzANBgNVBAoT
+  BlNpeEFybTETMBEGA1UEAxMKc2l4YXJtLmNvbYIJAKPwEETU5bHoMAwGA1UdEwQF
+  MAMBAf8wDQYJKoZIhvcNAQEFBQADgYEAooEexP/oPam1TP71SyuhxMb+uTrZbSQe
+  jVB+ExRwWadGwaNPUA56d39qwavwP+iu+3JpeonNMVvbWXF5naCX/dNFIeREHzER
+  ZDRQYMqru9TEMna6HD9zpcstF7vwThGovlOQ+3Y6plQ4nMzipXcZ9THqs65PIL0q
+  eabwpCbAopo=
+  -----END CERTIFICATE-----
+
+date: 2011-04-16 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: 
+email: sixarm@sixarm.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gemtest
+- Rakefile
+- README.rdoc
+- INSTALL.txt
+- LICENSE.txt
+- lib/sixarm_ruby_date_age.rb
+- test/sixarm_ruby_date_age_test.rb
+has_rdoc: true
+homepage: http://sixarm.com/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: "SixArm.com \xC2\xBB Ruby \xC2\xBB Date #age_in_days and #age_in_years methods"
+test_files: 
+- test/sixarm_ruby_date_age_test.rb