elapsed

README

Elapsed time

Golang package to return the elapsed time since a given time in a human readable format.

Installation

$ go get -u github.com/rvflash/elapsed

Usage

t := time.Now().Add(-time.Hour)
fmt.Println(elapsed.Time(t))
// Output: 1 hour ago

t = time.Now().Add(-time.Hour * 24 * 3)
fmt.Println(elapsed.Time(t))
// Output:  3 days ago

t, _ = time.Parse("2006-02-01", "2049-08-19")
fmt.Println(elapsed.Time(t))
// Output: not yet

Documentation

Index

• Variables
• func Time(t time.Time) string

Examples

• Time

Variables

var (
	NotYet     = `not yet`
	JustNow    = `just now`
	LastMinute = `1 minute ago`
	Minutes    = `%d minutes ago`
	LastHour   = `1 hour ago`
	Hours      = `%d hours ago`
	Yesterday  = `Yesterday`
	Days       = `%d days ago`
	Weeks      = `%d weeks ago`
	Months     = `%d months ago`
	Years      = `%d years ago`
)

Texts to be translated if necessary.

Functions

func Time

func Time(t time.Time) string

Time returns in a human readable format the elapsed time since the given datetime.

Example

package main

import (
	"fmt"
	"time"

	"github.com/rvflash/elapsed"
)

func main() {
	t := time.Now().Add(-time.Hour)
	fmt.Println(elapsed.Time(t))
	t = time.Now().Add(-time.Hour * 24 * 3)
	fmt.Println(elapsed.Time(t))
	t, _ = time.Parse("2006-02-01", "2049-08-19")
	fmt.Println(elapsed.Time(t))
}

Output:

1 hour ago
3 days ago
not yet