https://github.com/infertux/ordinalize_full

Turns a number into an ordinal string such as first, second, third or 1st, 2nd, 3rd.
https://github.com/infertux/ordinalize_full

i18n language ordinalize rails ruby rubygem

Last synced: 3 months ago
JSON representation

Turns a number into an ordinal string such as first, second, third or 1st, 2nd, 3rd.

• Host: GitHub
• URL: https://github.com/infertux/ordinalize_full
• Owner: infertux
• License: mit
• Created: 2014-06-30T20:11:49.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2023-09-27T02:24:25.000Z (over 1 year ago)
• Last Synced: 2024-09-22T21:23:57.245Z (4 months ago)
• Topics: i18n, language, ordinalize, rails, ruby, rubygem
• Language: Ruby
• Size: 45.9 KB
• Stars: 9
• Watchers: 4
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# OrdinalizeFull

[![Build Status](https://github.com/infertux/ordinalize_full/actions/workflows/tests.yml/badge.svg)](https://github.com/infertux/ordinalize_full/actions)

[![Gem Version](https://badge.fury.io/rb/ordinalize_full.svg)](https://badge.fury.io/rb/ordinalize_full)

Like Rails' [ordinalize](http://api.rubyonrails.org/classes/ActiveSupport/Inflector.html#method-i-ordinalize) method but with the ability to return the ordinal string spelled out in full words such as _"first"_, _"second"_, _"third"_.

Features:

- i18n support

- doesn't require monkey-patching

- easy to integrate with Rails but doesn't require Rails

## Usage

### Monkey-patching `Integer` (like Rails does)

```ruby

require "ordinalize_full/integer"

42.ordinalize_in_full #=> "forty second"

42.ordinalize_full #=> "forty second"

42.ordinalize(in_full: true) #=> "forty second"

42.ordinalize #=> "42nd"

I18n.locale = :fr

42.ordinalize_in_full #=> "quarante-deuxième"

42.ordinalize #=> "42ème"

I18n.locale = :es

14.ordinalize_in_full(gender: :feminine, plurality: :plural) #=> decimocuartas

1.ordinalize_in_full #=> primer // default masculine, singular

22.ordinalize_in_full(gender: :feminine) #=> vigésima segunda // default singular

1.ordinalize #=> 1.ᵉʳ

55.ordinalize #=> 55.ᵒ

```

### Without monkey-patching

```ruby

require "ordinalize_full"

42.ordinalize_in_full #=> NoMethodError: undefined method `ordinalize_in_full' for 42:Fixnum

class MyIntegerLikeClass; include OrdinalizeFull; def to_s; "42"; end; end #=> :to_s

MyIntegerLikeClass.new.ordinalize_in_full #=> "forty second"

```

## Limitations

- only works up to 100 for non-English languages

- locales only available in English, French, Italian, Spanish, and Dutch (pull requests welcome!)

## License

`SPDX-License-Identifier: MIT`