https://github.com/pr0grammr/time-ago
🕐 Elixir module for calculating the range of two datetimes and get the days/hours/minutes/seconds
https://github.com/pr0grammr/time-ago
elixir time timeago
Last synced: 4 months ago
JSON representation
🕐 Elixir module for calculating the range of two datetimes and get the days/hours/minutes/seconds
- Host: GitHub
- URL: https://github.com/pr0grammr/time-ago
- Owner: pr0grammr
- License: mit
- Created: 2019-12-21T21:41:39.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-11-30T20:58:30.000Z (over 5 years ago)
- Last Synced: 2025-10-21T15:40:10.869Z (8 months ago)
- Topics: elixir, time, timeago
- Language: Elixir
- Homepage: https://hexdocs.pm/time_ago
- Size: 16.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TimeAgo
Module for getting the amount of days/hours/minutes/seconds since past a specific date.
This module is inspired by the functionality of many social networks and forums
## Installation
The package can be installed
by adding `time_ago` to your list of dependencies in `mix.exs`:
```elixir
def deps do
[
{:time_ago, "~> 1.1.0"}
]
end
```
## Usage
```elixir
# returns original date if amount of days are more than 7
iex> TimeAgo.from_date ~N[2019-12-10 23:00:00], ~N[2019-12-21 22:30:00]
{:date, ~N[2019-12-10 23:00:00]}
# returns days if amount of days are more than 0
iex> TimeAgo.from_date ~N[2019-12-18 12:00:00], ~N[2019-12-21 22:30:00]
{:days, 3}
# returns hours if amount of hours are more than 0
iex> TimeAgo.from_date ~N[2019-12-21 20:00:00], ~N[2019-12-21 22:30:00]
{:hours, 2}
# returns minutes if amount of minutes are more than 0
iex> TimeAgo.from_date ~N[2019-12-21 18:00:00], ~N[2019-12-21 18:30:00]
{:minutes, 30}
# returns seconds if amount of seconds are more than 0
iex> TimeAgo.from_date ~N[2019-12-21 13:00:00], ~N[2019-12-21 13:00:55]
{:seconds, 55}
```
## Pattern Matching
```elixir
case TimeAgo.from_date ~N[2019-12-21 20:00:00], ~N[2019-12-21 22:30:00] do
{:days, days} ->
IO.puts "#{days} days ago"
{:hours, hours} ->
IO.puts "#{hours} hours ago"
{:minutes, minutes} ->
IO.puts "#{minutes} minutes ago"
{:seconds, seconds} ->
IO.puts "#{seconds} seconds ago"
end
# => 2 hours ago
```
## License
This module is published under the MIT license