Project

edtf-humanize

0.01
Low commit activity in last 3 years
A long-lived project that still receives updates
edtf-humanizeduke-libraries/edtf-humanizeHomepageDocumentationSource CodeBug TrackerWiki
This gem adds a humanize method to EDTF::Decade, EDTF::Interval, EDTF::Set, EDTF::Season, EDTF::Unknown, and Date (ISO 8601 compliant) objects.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
28,823
Stars
16
Forks
7
Watchers
8
 Releases
Current version
2.2.0
Total releases
10
First release
2016-04-21
Latest release
2024-03-05
 Issues
Open Issues
1
Closed Issues
15
Total Issues
16
Issue Closure Rate
93%
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
0
Merged Pull Requests
24
Pull Request Acceptance Rate
100%
 Development
Primary Language
Ruby
Licenses
BSD-3-Clause
Average date of last 50 commits
2021-05-04
Reverse Dependencies
0

 Dependencies

Runtime

activesupport
>= 4
edtf
>= 2.3, < 4
roman
~> 0.2.0
 Project Readme

edtf-humanize

The EDTF-humanize gem adds a humanize method to EDTF::Decade, EDTF::Century, EDTF::Interval, EDTF::Set, EDTF::Season, EDTF::Unknown, and Date (ISO 8601 compliant) objects. It uses the edtf-ruby gem for parsing EDTF date strings into Date and EDTF objects.

See the edtf-ruby project's documentation for details about supported EDTF string formats and other implementation details.

This gem is used in production by Duke University Library's digital repository to transform date metadata stored as Extended Date Time Format (EDTF) strings into human readable strings for display.

Installation

In a Rails application using Bundler

Add the following to your Gemfile:

gem 'edtf-humanize'

Then run:

> bundle install

To use in other contexts install the gem and require it:

> gem install edtf-humanize

require 'edtf-humanize'

Examples

Date (ISO 8601)

> d = Date.edtf('1975-07-01')
 => Tue, 01 Jul 1975
> d.humanize
 => "July 1, 1975"
> d = Date.edtf('1981~')
 => Thu, 01 Jan 1981
> d.humanize
 => "circa 1981"
> d = Date.edtf('198u')
 => Tue, 01 Jan 1980
> d.humanize
 => "198x"

EDTF::Season

> d = Date.edtf('1975-22')
 => #<EDTF::Season:0x0000000b6dd980 @year=1975, @season=:summer, @qualifier=nil>
> d.humanize
 => "summer 1975"

EDTF::Decade

> d = Date.edtf('197x')
=> #<EDTF::Decade:0x0000000b6fe798 @year=1970>
> d.humanize
=> "1970s"

EDTF::Century

> d = Date.edtf('19xx')
=> #<EDTF::Century:0x0000000b6fe798 @year=1900>
> d.humanize
=> "1900s"

EDTF::Interval

> d = Date.edtf('1981/1985')
=> #<EDTF::Interval:0x0000000ceeab18 @from=Thu, 01 Jan 1981, @to=Tue, 01 Jan 1985>
> d.humanize
=> "1981 to 1985"

EDTF::Set

> d = Date.edtf('[1888, 1889, 1891]')
=> #<EDTF::Set:0x0000000cef5450 @dates=#<Set: {Sun, 01 Jan 1888, Tue, 01 Jan 1889, Thu, 01 Jan 1891}>, @choice=true, @later=false, @earlier=false>
> d.humanize
=> "1888, 1889 or 1891"

EDTF::Unknown

> d = Date.edtf('uuuu')
 => #<EDTF::Unknown:0x0000000c04c688 @d=1>
> d.humanize
 => "unknown"

Internationalization

EDTF-humanize supports the use of I18n as well as language specific module overrides for more nuanced control. English, French, German, and Italian are supported.

Examples with current locale :fr:

> Date.edtf('1975-24').humanize
 => "hiver 1975"
 > Date.edtf('20xx').humanize
 => "XXIe siècle"

Pull requests to add support for additional languages are welcome. You must add a new language module for the language and include the Default language module. A locales file with translations is also needed. The supporting files for French may be used as a reference for adding support for additional languages.:

edtf-humanize/lib/edtf/humanize.rb
edtf-humanize/config/locales/fr.edtf.yml
edtf-humanize/lib/edtf/humanize/language/french.rb
edtf-humanize/spec/edtf/humanize_fr_spec.rb

Contributions

Contributions, especially to add support for additional languages are welcome. Tests are expected and written using RSpec. Code style is enforced with Rubocop.