Skip to content
🕐 Date and Time - Golang Formatting Library
Branch: master
Clone or download
Latest commit 90a619b Feb 23, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore [First] Bugs!!! Oct 3, 2018
.travis.yml [Refact] Doc Oct 5, 2018
Gopkg.lock [First] Bugs!!! Oct 3, 2018
Gopkg.toml [First] Bugs!!! Oct 3, 2018
LICENSE Initial commit Oct 3, 2018
README.md Update README Feb 23, 2019
_config.yml Set theme jekyll-theme-slate Dec 27, 2018
kair.go [Doc]Refactor Oct 6, 2018
kair_test.go [Doc]Refactor Oct 6, 2018

README.md

Kair

Date and Time - Golang Formatting Library

Mentioned in Awesome Go License: MIT Go Report Card codecov Build Status GitHub GoDoc

Setup

To get Kair

> Go CLI
go get github.com/GuilhermeCaruso/kair
> Go DEP
dep ensure -add github.com/GuilhermeCaruso/kair
> Govendor
govendor fetch github.com/GuilhermeCaruso/kair

Example

package main

import (
	"fmt"

	k "github.com/GuilhermeCaruso/kair"
)

func main() {
	now := k.Now()

    fmt.Printf("Right now is %s \n", now.CustomFormat("dd/MM/YYYY hh:mm:ss"))

	date := k.Date(29, 05, 1980)

	fmt.Printf("The %s was a %s in %s\n",
		date.Format("L"),
		date.CustomFormat("DD"),
        date.CustomFormat("MMMM")) //The 29/05/1980 was a Thursday in May 
}

Formatters

  • Standard
    "LT":   10:20 AM,
    "LTS":  10:20:00 AM,
    "L":    20/05/2018,
    "l":    20/5/2018,
    "LL":   May 20, 2018,
    "ll":   May 20, 2018,
    "LLL":  May 20, 2018 10:20 AM,
    "lll":  May 20, 2018 10:20 AM,
    "LLLL": Sunday, May 20, 2018 10:20 AM,
    "llll": Sun, May 20, 2018 10:20 AM,
    "":     2018-05-20 10:20:00 +0000 UTC,
  • Custom
    "MMMM": Long Month,
    "MMM":  Month,
    "MM":   Zero Number Month,
    "M":    Number Month,
    "YYYY": Long Year,
    "YY":   Year,
    "DD":   Long Day,
    "D":    Day,
    "dd":   Long Number Day,
    "d":    Number Day,
    "hh":   Long Hour,
    "h":    Hour,
    "mm":   Long Minute,
    "m":    Minute,
    "ss":   Long Second,
    "s":    Second

Contributing

Please feel free to make suggestions, create issues, fork the repository and send pull requests!

To do:

  • Implement Standard Format
  • Implement Custom Format
  • Implement Now(), Date() and DateTime() initializers
  • Implement Relative Time (FromNow, StartOf ...)
  • Implement CalendarTime (add, subtract, calendar)

License

MIT License © Guilherme Caruso

You can’t perform that action at this time.