fmtdate

README

fmtdate

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 (
		"github.com/metakeule/fmtdate"
		"fmt"
	)

	func main() {
		date := fmtdate.Format("DD.MM.YYYY", time.Now())
		fmt.Println(date)

		var err
		date, err = fmtdate.Parse("M/D/YY", "2/3/07")
		fmt.Println(date, err)
	}

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 http://godoc.org/github.com/metakeule/fmtdate

Documentation

Overview

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 (
	"gopkg.in/metakeule/fmtdate.v1"
	"fmt"
)

func main() {
	date := fmtdate.Format("DD.MM.YYYY", time.Now())
	fmt.Println(date)

	var err
	date, err = fmtdate.Parse("M/D/YY", "2/3/07")
	fmt.Println(date, err)
}

Index

• Variables
• func Format(format string, date time.Time) string
• func FormatDate(date time.Time) string
• func FormatDateTime(date time.Time) string
• func FormatTime(date time.Time) string
• func Parse(format string, value string) (time.Time, error)
• func ParseDate(value string) (time.Time, error)
• func ParseDateTime(value string) (time.Time, error)
• func ParseTime(value string) (time.Time, error)

Variables

var (
	DefaultTimeFormat     = "hh:mm:ss"
	DefaultDateFormat     = "YYYY-MM-DD"
	DefaultDateTimeFormat = "YYYY-MM-DD hh:mm:ss"
)

var Placeholder = []p{
	p{"hh", "15"},
	p{"h", "03"},
	p{"mm", "04"},
	p{"ss", "05"},
	p{"MMMM", "January"},
	p{"MMM", "Jan"},
	p{"MM", "01"},
	p{"M", "1"},
	p{"pm", "PM"},
	p{"ZZZZ", "-0700"},
	p{"ZZZ", "MST"},
	p{"ZZ", "Z07:00"},
	p{"YYYY", "2006"},
	p{"YY", "06"},
	p{"DDDD", "Monday"},
	p{"DDD", "Mon"},
	p{"DD", "02"},
	p{"D", "2"},
}

Functions

func Format

func Format(format string, date time.Time) string

Format formats a date based on Microsoft Excel (TM) conventions

func FormatDate

func FormatDate(date time.Time) string

FormatDate formats the given date to the DefaultDateFormat

func FormatDateTime

func FormatDateTime(date time.Time) string

FormatTime formats the given date to the DefaultDateTimeFormat

func FormatTime

func FormatTime(date time.Time) string

FormatTime formats the given date to the DefaultTimeFormat

func Parse

func Parse(format string, value string) (time.Time, error)

Parse parses a value to a date based on Microsoft Excel (TM) formats

func ParseDate

func ParseDate(value string) (time.Time, error)

Parse parses a date in DefaultDateFormat to a date

func ParseDateTime

func ParseDateTime(value string) (time.Time, error)

Parse parses a date in DefaultDateTimeFormat to a date

func ParseTime

func ParseTime(value string) (time.Time, error)

Parse parses a date in DefaultTimeFormat to a date