cactus/gostrftime

strftime for Go

gostrftime

About

A Go pkg for formatting time.Time in an strftime(3) like way. Basically, strftime for Go, with a couple of additions.

Installing

$ go get github.com/cactus/gostrftime

Supported formats:

code	example	Description
%A	Sunday	full weekday name
%a	Sun	abbreviated weekday name
%B	September	full month name
%b	Sep	abbreviated month name
%C	20	(year / 100) as number. Single digits are preceded by zero
%D	09/21/14	equivalent to %m/%d/%y
%d	21	day of month as number. Single digits are preceded by zero
%e	21	day of month as number. Single digits are preceded by a blank
%f	001234	microsecond as a six digit decimal number, zero-padded on the left
%F	2014-09-21	equivalent to %Y-%m-%d
%H	15	the hour (24 hour clock) as a number. Single digits are preceded by zero
%h	Sep	same as %b
%I	03	the hour (12 hour clock) as a number. Single digits are preceded by zero
%j	264	the day of the year as a decimal number. Single digits are preced by zeros
%k	15	the hour (24 hour clock) as a number. Single digits are preceded by a blank
%L	001	millisecond as a three digit decimal number, zero-padded on the left
%l	11	replaced by the hour (12 hour clock) as a number. Single digits are preceded by blank
%M	32	replaced by the minute as a decimal number. Single digits are preceded by a zero
%m	09	replaced by the month as a decimal number. Single digits are preceded by a zero
%N	001234567	nanosecond as a 9 digit decimal number, zero-padded on the left
%n	\n	a newline
%P	am	am or pm as appropriate
%p	AM	AM or PM as appropriate
%R	15:32	equivalent to %H:%M
%r	03:32:05 AM	equivalent to %I:%M:%S %p
%S	05	the second as a number. Single digits are preceded by a zero
%s	1461497457	the number of seconds since the Epoch, UTC
%T	15:32:05	equivalant to %H:%M:%S
%t	\t	a tab
%v	21-Sep-2014	equivalent to %e-%b-%Y
%w	0	the weekday (Sunday as first day of the week) as a number
%Y	2014	replaced by the year with century as a number
%y	14	year without century as a number. Single digits are preceded by zero
%Z	UTC	time zone name
%z	-0700	the time zone offset from UTC

Using

import (
    "fmt"
    "time"
    "github.com/cactus/gostrftime"
)

func main() {
    now := time.Now()
    fmt.Println(gostrftime.Format("%Y-%m-%d", now))
}

License

Released under an ISC license. See LICENSE.md file for details.