fmtdate

Note: If you are reading this on Github, please note that the repo has moved to Gitlab (gitlab.com/metakeule/fmtdate) and this is only a mirror.

100% test coverage (that was easy :-))

fmtdate provides a date formatter and parser using the syntax of Microsoft Excel (TM).

Additionally it offers default conversions for date time and datetime.

Why?

Microsoft Excel (TM) has a well known syntax for date formatting, that more memorable than the syntax chosen in the time package in the go library.

Usage

package main
import (
"gitlab.com/metakeule/fmtdate""fmt"
)
funcmain() {
date:=fmtdate.Format("DD.MM.YYYY", time.Now())
fmt.Println(date)
varerrdate, err=fmtdate.Parse("M/D/YY", "2/3/07")
fmt.Println(date, err)
}

For json

package main
import (
"gitlab.com/metakeule/fmtdate""fmt""encoding/json"
)
typePersonstruct {
NamestringBirthDay fmtdate.TimeDate
}
funcmain() {
bday, err:=fmtdate.NewTimeDate("YYYY-MM-DD", "2000-12-04")
// do error handlingpaul:=&Person{"Paul", bday}
data, err:=json.Marshal(paul)
// do error handling
}

Placeholders

M - month (1)
MM - month (01)
MMM - month (Jan)
MMMM - month (January)
D - day (2)
DD - day (02)
DDD - day (Mon)
DDDD - day (Monday)
YY - year (06)
YYYY - year (2006)
hh - hours (15)
mm - minutes (04)
ss - seconds (05)
AM/PM hours: 'h' followed by optional 'mm' and 'ss' followed by 'pm', e.g.
hpm - hours (03PM)
h:mmpm - hours:minutes (03:04PM)
h:mm:sspm - hours:minutes:seconds (03:04:05PM)
Time zones: a time format followed by 'ZZZZ', 'ZZZ' or 'ZZ', e.g.
hh:mm:ss ZZZZ (16:05:06 +0100)
hh:mm:ss ZZZ (16:05:06 CET)
hh:mm:ss ZZ (16:05:06 +01:00)

Documentation

see https://pkg.go.dev/gitlab.com/metakeule/fmtdate