ActionView::Helpers::DateHelper

relative_time_in_words

API ドキュメント（Rails 8.1.4.1） ↗
def relative_time_in_words(from_time, options = {})

説明

今の時刻との差を distance_of_time_in_words と同じ文字列にして、訳の datetime.relative.past（過去のとき）か datetime.relative.future（未来のとき）の %{time} に入れて返します。

引数

値を変えると、ERB と HTML が変わります。

Time、DateTime、Date か、時刻にできる文字列（"2026-11-20"）です。数（秒）や nil を渡すと、ArgumentError になります。今の時刻（Time.now）より後なら future の訳を、それ以外は past の訳を使います。Rails は英語の訳しか持たず、rails-i18n にもまだ日本語の訳がないので、日本語では訳がないという文字列になります。このサイトでも、日本語の訳は用意していません。
options= {}
true にすると、1 分より短い差を、秒の区切りで言い分けます（distance_of_time_in_words と同じです）。
今のロケールの代わりに、このロケールの訳を使います。差の文字列と、過去と未来の訳の両方に使います。このページでは、日本語の訳がないので、初めは :en を渡しています。
:"datetime.custom"
過去と未来の訳を探す階層です。この階層の下の past と future のキーを探します。distance_of_time_in_words には渡さないので、差の文字列の訳は変わりません。このページの例の階層は、このサイトの訳にないので、訳がないという文字列になります。
ここにない options は、distance_of_time_in_words にそのまま渡します。HTML 属性にはなりません。

ERB

直前との違い： 追加 削除 変更


          

        


        

          

            
HTML