InterpretDate
Module to provide helper methods for interpreting American formatted date strings.
Installation
Add this line to your application's Gemfile:
gem 'interpret_date'
And then execute:
$ bundle
Or install it yourself as:
$ gem install interpret_date
Usage
Instance Methods
To utilize interpret_date
, mix in the InterpretDate
module into a
class that needs to interpret American formatted dates into ruby Date
objects and pass the date string into the interpret_date
or
interpret_dob_date
.
Example (setting attributes for an example ActiveRecord
model):
class Parcel < ActiveRecord::Base
include InterpretDate
def shipping_date=(value)
super(interpret_date(value))
end
def birthdate=(value)
super(interpret_dob_date(value))
end
end
ActiveRecord Date Type
You can also utilize InterpretDate
with the ActiveRecord Attribute
API to automatically cast dates with their interpreted values.
class Parcel < ActiveRecord::Base
attribute :shipping_date, InterpretDate::DateType.new
end
If you plan on using the Date Type extensively you can register it in an initializer.
# config/initializers/types.rb
ActiveRecord::Type.register(:interpreted_date, InterpretDate::DateType)
class Parcel < ActiveRecord::Base
attribute :shipping_date, :interpreted_date
end
Contributing
- Fork it ( https://github.com/sqm/interpret_date/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request