Railsで1st、2nd、3rd、4thなどの序数を表示する方法（翻訳）

Railsで1st、2nd、3rd、4thなどの序数を表示する方法（翻訳）

Railsアプリケーションを開発するときに、数字を人間が読みやすい形式で表示する必要が生じることがよくあります。たとえば、「1」や「42」だけではなく、「1st」や「42nd」のような序数を表示したい場合があります。Railsは、Active Support のコア拡張機能でそれ用の優れたソリューションを提供しています。

🔗 以下のように書くよりも

序数を完全に避ける。つまり基本的な文字列式展開で表示位置を工夫してしのぐ。

position = 1
"You finished in position #{position}"
# => "You finished in position 1"
position = 32
"You finished in position #{position}"
# => "You finished in position 1"

🔗 以下のように書こう

Rails組み込みのordinalメソッドやordinalizeメソッドを使う。

position = 1
"You finished in #{position.ordinalize} place"
# => "You finished in 1st place"
position = 11
"You finished in #{position.ordinalize} place"
# => "You finished in 11th place"
position = 22
"You finished in #{position.ordinalize} place"
# => "You finished in 22nd place"
position = 43
"You finished in #{position.ordinalize} place"
# => "You finished in 43rd place"

🔗 そうする理由

序数を使えば、特に「ランキング」「日付」「リスト」を扱うときのテキストが自然で読みやすいものになります。

コード例では英語の序数を示していますが、これらのメソッドは国際化に対応しているので他の言語にもローカライズできます（localizeは英国風に書けばlocaliseですね！）。

これはいつものように、Active Supportで拡張されたRailsツールキットの一部です。正しい序数サフィックスを決定し、アプリケーション全体で一貫した処理を確保するために独自のロジックをわざわざ記述して維持する必要はありません。

コード例で示したordinalizeは完全な序数（1stや2ndなど）を返しますが、ordinalのようにサフィックスだけ（stやndなど）を返すものもあります。

これらのメソッドをビューで頻繁に利用している場合や、特定のマークアップと組み合わせて利用している場合は、以下のようにロジックをヘルパーまたはデコレータに移動してビューを整理することを検討しましょう。

# app/helpers/number_helper.rb
module NumberHelper
  def wrapped_ordinal(number)
    tag.span(sanitize(number.to_s) << tag.span(number.ordinal, class: "ordinal"))
  end
end

<!-- whatever.html.erb -->
<%= wrapped_ordinal(1) %>
#=> "<span>1<span class=\"ordinal\">st</span></span>"

🔗 そうしない理由があるとすれば

Rails以外のRubyプロジェクトで作業している場合は、依存関係にactivesupport gemを追加する必要があります。その場合、Rubyのコアクラスで多くのメソッドにパッチが適用されることになります。

ただし、ほとんどのRailsアプリケーションではordinalやordinalizeを使うのが最善の方法です。これらは現場のテストを経ていて効率もよく、車輪の再発明や読みにくい出力で我慢する必要がありません。

関連記事

Railsのblank?やpresent?は積極的に使おう（翻訳）

Rails: Active Supportの日付・時刻関連拡張はもっと活用すべき（翻訳）