Repository files navigation

This is a Go language package for formatting and parsing date time strings.

package mainimport ("fmt""log""github.com/itchyny/timefmt-go")funcmain() {t,err:=timefmt.Parse("2020/07/24 09:07:29","%Y/%m/%d %H:%M:%S")iferr!=nil {log.Fatal(err)}fmt.Println(t)// 2020-07-24 09:07:29 +0000 UTCstr:=timefmt.Format(t,"%Y/%m/%d %H:%M:%S")fmt.Println(str)// 2020/07/24 09:07:29str=timefmt.Format(t,"%a, %d %b %Y %T %z")fmt.Println(str)// Fri, 24 Jul 2020 09:07:29 +0000}

Please refer toman 3 strftime andman 3 strptime for formatters.As an extension,%f directive is supported for zero-padded microseconds, which originates from Python.Note thatE andO modifier characters are not supported.

• This library
  • provides both formatting and parsing functions in pure Go language,
  • depends only on the Go standard libraries not to grow up dependency.
• Format (strftime) implements glibc extensions including
  • width specifier like%6Y %10B %4Z (limited to 1024 bytes),
  • omitting padding modifier like%-y-%-m-%-d,
  • space padding modifier like%_y-%_m-%_d,
  • upper case modifier like%^a %^b,
  • swapping case modifier like%#Z,
  • time zone offset modifier like%:z %::z %:::z,
  • and its performance is very good.
• AppendFormat is provided for reducing allocations.
• Parse (strptime) allows to parse
  • composed directives like%F %T,
  • century years like%C %y,
  • week directives like%W %a and%G-W%V-%u.
• ParseInLocation is provided for configuring the default location.

Report bug atIssues・itchyny/timefmt-go - GitHub.

itchyny (https://github.com/itchyny)

This software is released under the MIT License, see LICENSE.