Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

American style month/day/year parsing for ruby 1.9

branch: master

Deal with new rake and old rdoc in Rakefile

Newer versions of rake have a rake/rdoctask that raises a
RuntimeError if you try to load it.  This is a poor design
decision (raising a LoadError would be better), but that's life.

In any case, if rdoc/task doesn't exist and rake/rdoctask raises
an error, don't create an rdoc task, and have the rake actually
run instead of exiting with an error.
latest commit 0020beb48d
Jeremy Evans authored
Octocat-spinner-32 lib Merge sd's changes into the master branch March 22, 2013
Octocat-spinner-32 spec Merge sd's changes into the master branch March 22, 2013
Octocat-spinner-32 .gitignore Initial commit December 12, 2011
Octocat-spinner-32 .travis.gemfile Minor changes to Travis config March 29, 2014
Octocat-spinner-32 .travis.yml Minor changes to Travis config March 29, 2014
Octocat-spinner-32 CHANGELOG Update README and bump version to 1.1.0 March 22, 2013
Octocat-spinner-32 MIT-LICENSE Bump version to 1.0.1 March 20, 2013
Octocat-spinner-32 README.rdoc Note why we don't handle - or . separated dates in the README March 29, 2014
Octocat-spinner-32 Rakefile Deal with new rake and old rdoc in Rakefile March 29, 2014
Octocat-spinner-32 american_date.gemspec Update README and bump version to 1.1.0 March 22, 2013
README.rdoc

ruby-american_date

ruby-american_date exists to make ruby 1.9+ parse american-style month/day/year dates correctly, with behavior matching ruby 1.8.7. It can also be used on earlier ruby version, but it is basically a noop there.

As far as I know, there isn't a gem that already handles this. You can find many snippets on the web that partially solve the issue, but most won't be compatible with ruby 1.9.3, because Date.parse and DateTime.parse no longer call Date._parse directly on 1.9.3. Also most don't handle cases where an american date format is used in addition to a time format.

Note that this gem only handles / separated dates. It does not handle - or . separated dates. This is by design, for compatibility with ruby 1.8.7.

Design

The general idea is fairly simple. We look for a month/day/year substring in the input string, and if we find it, we transform it into a year-month-day ISO format string before passing it to the standard date parsing methods. This is probably the least invasive way that works correctly on both the pure-ruby date parser (<1.9.3) and the C extension date parser (>=1.9.3).

Tested ruby versions

  • ruby 1.8.6, 1.8.7, 1.9.2, 1.9.3, 2.0.0, 2.1.0

  • rubinius 1.2.4, 2.2.6

  • jruby 1.6.5, 1.7.9 (both –1.8 and –1.9 modes)

Installation

ruby-american_date is distributed as a gem, and can be installed with:

gem install american_date

Source

ruby-american_date is hosted on GitHub:

https://github.com/jeremyevans/ruby-american_date

Issues

ruby-american_date uses GitHub Issues for issue tracking:

https://github.com/jeremyevans/ruby-american_date/issues

Author

Jeremy Evans <code@jeremyevans.net>

Something went wrong with that request. Please try again.