Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
lib
 
 
rbi
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

RelativeTime

Build Status Code Climate Test Coverage

Micro lib without any dependency for getting relative time.

Motivation

I love rails but sometimes we need to create web apps (or CLI) without rails and AS. That's why I created #time_ago_in_words analog on pure ruby without any dependencies.

Installation

Add this line to your application's Gemfile:

gem 'relative_time'

And then execute:

$ bundle

Or install it yourself as:

$ gem install relative_time

Usage

Just call #in_words method with any time object:

RelativeTime.in_words(Date.today)
RelativeTime.in_words(Time.now)          # => less than a minute

RelativeTime.in_words(Time.now - 1 * 60) # => a minute ago
RelativeTime.in_words(Time.now - 3 * 60) # => 3 minutes ago

RelativeTime.in_words(Time.now + 1 * 60) # => in a minute
RelativeTime.in_words(Time.now + 3 * 60) # => in 3 minutes

Also you can use second argument as a from date:

date_from = Time.now - 60 * 60 # one hour ago
RelativeTime.in_words(Time.now, date_from)          # => an hour ago

Supported intervals

  • minutes
  • hours
  • days
  • weeks
  • months
  • years

I18n

Relative time use i18n for pluralization and translation to other languages. For using specific locale just call #in_words with specific locale:

RelativeTime.in_words(Time.now, locale: :ru)            # => через 3 часа
RelativeTime.in_words(Time.now, date_from, locale: :ru) # => минуту назад

List of supported locales:

  • en
  • id
  • ru
  • tr
  • uk
  • be
  • pt

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/davydovanton/relative_time. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.

About

Micro lib without any dependency for getting relative time

Topics

Resources

License

Packages

No packages published

Languages

You can’t perform that action at this time.