parsetime

package module

v0.4.0 Latest Latest Go to latest Published: Jul 4, 2026 License: MIT Imports: 9 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/jftuga/parsetime

Links

Open Source Insights

README ¶

parsetime

date/time parser for golang

This is a fork of https://github.com/tkuchiki/parsetime
Changes documented here:
- https://github.com/tkuchiki/parsetime/pull/4

Usage

`parsetime.NewParseTime`

`parsetime.NewParseTime()`

package main

import (
	"fmt"
	"github.com/jftuga/parsetime"
	"log"
)

func main() {
	p, err := parsetime.NewParseTime()
	if err != nil {
		log.Fatal(err)
	}

	t, err2 := p.Parse("2016-01-02T03:04:05")

	if err2 != nil {
		log.Fatal(err)
	}


	// Local timezone: JST
	// 2016-01-02 03:04:05 +0900 JST
	fmt.Println(t)
}

`parsetime.NewParseTime("location name")`

func main() {
	p, err := parsetime.NewParseTime("US/Arizona")
	if err != nil {
		log.Fatal(err)
	}

	t, err2 := p.Parse("2016-01-02T03:04:05")

	if err2 != nil {
		log.Fatal(err)
	}


	// Local timezone: JST
	// 2016-01-02 03:04:05 -0700 MST
	fmt.Println(t)
}

`parsetime.NewParseTime("timezone name")`

func main() {
	p, err := parsetime.NewParseTime("MST")
	if err != nil {
		log.Fatal(err)
	}

	t, err2 := p.Parse("2016-01-02T03:04:05")

	if err2 != nil {
		log.Fatal(err)
	}


	// Local timezone: JST
	// 2016-01-02 03:04:05 -0700 MST
	fmt.Println(t)
}

`parsetime.NewParseTime("timezone name", offset)`

func main() {
	p, err := parsetime.NewParseTime("MST", -7*3600)
	if err != nil {
		log.Fatal(err)
	}

	t, err2 := p.Parse("2016-01-02T03:04:05")

	if err2 != nil {
		log.Fatal(err)
	}


	// Local timezone: JST
	// 2016-01-02 03:04:05 -0700 MST
	fmt.Println(t)
}

`ParseTime`

`ParseTime.GetLocation`

Returns *time.Location

var loc *time.Location
p, _ := parsetime.NewParseTime()

loc = p.GetLocation()

`ParseTime.SetLocation`

Sets *time.Location

var loc *time.Location
var err error
p, _ := parsetime.NewParseTime()

loc, err = time.LoadLocation("US/Arizona")
p.SetLocation(loc)

`ParseTime.ISO8601`

Parses ISO8601, RFC3339 date/time string

var t time.Time
var err error

p, _ := parsetime.NewParseTime()

t, err = p.ISO8601("2016-01-02T03:04:05")

`ParseTime.RFC8xx1123`

Parses RFC822, RFC850, RFC1123 date/time string

var t time.Time
var err error

p, _ := parsetime.NewParseTime()

t, err = p.RFC8xx1123("2016-01-02T03:04:05")

`ParseTime.ANSIC`

Parses ANSIC date/time string

var t time.Time
var err error

p, _ := parsetime.NewParseTime()

t, err = p.ANSIC("2016-01-02T03:04:05")

`ParseTime.US`

Parses MM/DD/YYYY format date/time string

var t time.Time
var err error

p, _ := parsetime.NewParseTime()

t, err = p.US("2016-01-02T03:04:05")

`ParseTime.Parse`

Parses date/time string

var t time.Time
var err error

p, _ := parsetime.NewParseTime()

t, err = p.Parse("2016-01-02T03:04:05")

Examples

ISO8601

Input String	_time.Time
2006-01-02 15:04	2006-01-02 15:04:00 +0900 JST
2006-01-02 15:04-07:00	2006-01-02 15:04:00 -0700 -0700
2006-01-02 15:04 -07:00	2006-01-02 15:04:00 -0700 -0700
2006-01-02 15:04:05	2006-01-02 15:04:05 +0900 JST
2006-01-02 15:04:05-07:00	2006-01-02 15:04:05 -0700 -0700
2006-01-02 15:04:05 -07:00	2006-01-02 15:04:05 -0700 -0700
2006-01-02 15:04:05-07:00 MST	2006-01-02 15:04:05 -0700 -0700
2006-01-02 15:04:05 -07:00 MST	2006-01-02 15:04:05 -0700 -0700
2006-01-02 15:04:05.999999999	2006-01-02 15:04:05.999999999 +0900 JST
2006-01-02 15:04:05.999999-07:00 MST	2006-01-02 15:04:05.000999999 -0700 -0700
2006-01-02 15:04:05.9-07:00 MST	2006-01-02 15:04:05.000000009 -0700 -0700
2006-01-02 15:04:05.9 -07:00 MST	2006-01-02 15:04:05.000000009 -0700 -0700
2006-01-02 15:04:05.999-07:00 MST	2006-01-02 15:04:05.000000999 -0700 -0700
2006-01-02 15:04:05.999 -07:00 MST	2006-01-02 15:04:05.000000999 -0700 -0700
2006-01-02 15:04:05.999999-07:00 MST	2006-01-02 15:04:05.000999999 -0700 -0700
2006-01-02 15:04:05.999999 -07:00 MST	2006-01-02 15:04:05.000999999 -0700 -0700
2006-01-02 15:04:05.999999999-07:00 MST	2006-01-02 15:04:05.999999999 -0700 -0700
2006-01-02 15:04:05.999999999 -07:00 MST	2006-01-02 15:04:05.999999999 -0700 -0700
2006-01-02T15:04	2006-01-02 15:04:00 +0900 JST
2006-01-02T15:04-07:00	2006-01-02 15:04:00 -0700 -0700
2006-01-02T15:04 -07:00	2006-01-02 15:04:00 -0700 -0700
2006-01-02T15:04:05	2006-01-02 15:04:05 +0900 JST
2006-01-02T15:04:05-07:00	2006-01-02 15:04:05 -0700 -0700
2006-01-02T15:04:05 -07:00	2006-01-02 15:04:05 -0700 -0700
2006-01-02T15:04:05-07:00 MST	2006-01-02 15:04:05 -0700 -0700
2006-01-02T15:04:05 -07:00 MST	2006-01-02 15:04:05 -0700 -0700
2006-01-02T15:04:05.999999999	2006-01-02 15:04:05.999999999 +0900 JST
2006-01-02T15:04:05.999999999-07:00 MST	2006-01-02 15:04:05.999999999 -0700 -0700
2006-01-02T15:04:05.999999999 -07:00 MST	2006-01-02 15:04:05.999999999 -0700 -0700
2006-01-02T15:04:05.999999-07:00 MST	2006-01-02 15:04:05.000999999 -0700 -0700
2006-01-02T15:04:05.999999 -07:00 MST	2006-01-02 15:04:05.000999999 -0700 -0700
2006-01-02T15:04:05.9-07:00 MST	2006-01-02 15:04:05.000000009 -0700 -0700
2006-01-02T15:04:05.9 -07:00 MST	2006-01-02 15:04:05.000000009 -0700 -0700
2006-01-02	2006-01-02 00:00:00 +0900 JST
20060102	2006-01-02 00:00:00 +0900 JST
20060102150405	2006-01-02 15:04:05 +0900 JST
20060102 150405	2006-01-02 15:04:05 +0900 JST
20060102T150405	2006-01-02 15:04:05 +0900 JST
15:04:05	2016-05-06 15:04:05 +0900 JST
15:04:05-07:00 MST	2016-05-06 15:04:05 -0700 -0700
15:04:05 -07:00 MST	2016-05-06 15:04:05 -0700 -0700
15:04:05.9-07:00 MST	2016-05-06 15:04:05.000000009 -0700 -0700
15:04:05.9 -07:00 MST	2016-05-06 15:04:05.000000009 -0700 -0700
15:04:05.999-07:00 MST	2016-05-06 15:04:05.000000999 -0700 -0700
15:04:05.999 -07:00 MST	2016-05-06 15:04:05.000000999 -0700 -0700
15:04:05.999999-07:00 MST	2016-05-06 15:04:05.000999999 -0700 -0700
15:04:05.999999 -07:00 MST	2016-05-06 15:04:05.000999999 -0700 -0700
15:04:05.999999999-07:00 MST	2016-05-06 15:04:05.999999999 -0700 -0700
15:04:05.999999999 -07:00 MST	2016-05-06 15:04:05.999999999 -0700 -0700
150405-07:00 MST	2016-05-06 15:04:05 -0700 -0700
150405 -07:00 MST	2016-05-06 15:04:05 -0700 -0700
150405.9-07:00 MST	2016-05-06 15:04:05.000000009 -0700 -0700
150405.9 -07:00 MST	2016-05-06 15:04:05.000000009 -0700 -0700
150405.999-07:00 MST	2016-05-06 15:04:05.000000999 -0700 -0700
150405.999 -07:00 MST	2016-05-06 15:04:05.000000999 -0700 -0700
150405.999999-07:00 MST	2016-05-06 15:04:05.000999999 -0700 -0700
150405.999999 -07:00 MST	2016-05-06 15:04:05.000999999 -0700 -0700
150405.999999999-07:00 MST	2016-05-06 15:04:05.999999999 -0700 -0700
150405.999999999 -07:00 MST	2016-05-06 15:04:05.999999999 -0700 -0700
2006-01-02 15:04:05Z	2006-01-02 15:04:05 +0000 UTC
2006-01-02T15:04:05Z	2006-01-02 15:04:05 +0000 UTC
2006-01-02 15:04:05.9Z	2006-01-02 15:04:05.000000009 +0000 UTC
2006-01-02T15:04:05.9Z	2006-01-02 15:04:05.000000009 +0000 UTC
2006-01-02 15:04:05.999Z	2006-01-02 15:04:05.000000999 +0000 UTC
2006-01-02T15:04:05.999Z	2006-01-02 15:04:05.000000999 +0000 UTC
2006-01-02 15:04:05.999999Z	2006-01-02 15:04:05.000999999 +0000 UTC
2006-01-02T15:04:05.999999Z	2006-01-02 15:04:05.000999999 +0000 UTC
2006-01-02 15:04:05.999999999Z	2006-01-02 15:04:05.999999999 +0000 UTC
2006-01-02T15:04:05.999999999Z	2006-01-02 15:04:05.999999999 +0000 UTC

RFC8xx1123

Input String	_time.Time
02-Jan-06 1504 MST	2006-01-02 15:04:00 -0700 MST
02-Jan-06 15:04 MST	2006-01-02 15:04:00 -0700 MST
02-Jan-06 150405 MST	2006-01-02 15:04:05 -0700 MST
02-Jan-06 15:04:05 MST	2006-01-02 15:04:05 -0700 MST
02-Jan-06 1504-0700	2006-01-02 15:04:00 -0700 -0700
02-Jan-06 15:04-0700	2006-01-02 15:04:00 -0700 -0700
02-Jan-06 150405-0700	2006-01-02 15:04:05 -0700 -0700
02-Jan-06 15:04:05-0700	2006-01-02 15:04:05 -0700 -0700
02-Jan-06 15:04 -0700	2006-01-02 15:04:00 -0700 -0700
02-Jan-06 15:04:05 -0700	2006-01-02 15:04:05 -0700 -0700
Monday, 02-Jan-06 15:04 MST	2006-01-02 15:04:00 -0700 MST
Monday, 02-Jan-06 15:04:05 MST	2006-01-02 15:04:05 -0700 MST
Mon, 02-Jan-06 15:04 MST	2006-01-02 15:04:00 -0700 MST
Mon, 02-Jan-06 15:04:05 MST	2006-01-02 15:04:05 -0700 MST
Mon, 02-Jan-06 15:04-07:00	2006-01-02 15:04:00 -0700 -0700
Mon, 02-Jan-06 15:04:05-07:00	2006-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-06 15:04 -07:00	2006-01-02 15:04:00 -0700 -0700
Mon, 02-Jan-06 15:04:05 -07:00	2006-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-2006 15:04-07:00	2006-01-02 15:04:00 -0700 -0700
Mon, 02-Jan-2006 15:04:05-07:00	2006-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-2006 15:04 -07:00	2006-01-02 15:04:00 -0700 -0700
Mon, 02-Jan-2006 15:04:05 -07:00	2006-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-70 15:04-07:00	1970-01-02 15:04:00 -0700 -0700
Mon, 02-Jan-70 15:04:05-07:00	1970-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-70 15:04 -07:00	1970-01-02 15:04:00 -0700 -0700
Mon, 02-Jan-70 15:04:05 -07:00	1970-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-99 15:04-07:00	1999-01-02 15:04:00 -0700 -0700
Mon, 02-Jan-99 15:04:05-07:00	1999-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-99 15:04:05 -07:00	1999-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-00 15:04-07:00	2000-01-02 15:04:00 -0700 -0700
Mon, 02-Jan-00 15:04:05-07:00	2000-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-00 15:04:05 -07:00	2000-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-00 15:04:05.9-07:00	2000-01-02 15:04:05.000000009 -0700 -0700
Mon, 02-Jan-00 15:04:05.9 -07:00	2000-01-02 15:04:05.000000009 -0700 -0700
Mon, 02-Jan-00 15:04:05.999-07:00	2000-01-02 15:04:05.000000999 -0700 -0700
Mon, 02-Jan-00 15:04:05.999 -07:00	2000-01-02 15:04:05.000000999 -0700 -0700
Mon, 02-Jan-00 15:04:05.999999-07:00	2000-01-02 15:04:05.000999999 -0700 -0700
Mon, 02-Jan-00 15:04:05.999999 -07:00	2000-01-02 15:04:05.000999999 -0700 -0700
Mon, 02-Jan-00 15:04:05.999999999-07:00	2000-01-02 15:04:05.999999999 -0700 -0700
Mon, 02-Jan-00 15:04:05.999999999 -07:00	2000-01-02 15:04:05.999999999 -0700 -0700

ANSIC

Input String	_time.Time
Mon Jan 02 150405 2006	2006-01-02 15:04:05 +0900 JST
Mon Jan 02 15:04:05 2006	2006-01-02 15:04:05 +0900 JST
Mon Jan 02 150405 MST 2006	2006-01-02 15:04:05 -0700 MST
Mon Jan 02 15:04:05 MST 2006	2006-01-02 15:04:05 -0700 MST
Mon Jan 02 1504-07:00 2006	2006-01-02 15:04:00 -0700 -0700
Mon Jan 02 15:04-07:00 2006	2006-01-02 15:04:00 -0700 -0700
Mon Jan 02 1504 -07:00 2006	2006-01-02 15:04:00 -0700 -0700
Mon Jan 02 15:04 -07:00 2006	2006-01-02 15:04:00 -0700 -0700
Mon Jan 02 150405-07:00 2006	2006-01-02 15:04:05 -0700 -0700
Mon Jan 02 15:04:05-07:00 2006	2006-01-02 15:04:05 -0700 -0700
Mon Jan 02 150405 -07:00 2006	2006-01-02 15:04:05 -0700 -0700
Mon Jan 02 15:04:05 -07:00 2006	2006-01-02 15:04:05 -0700 -0700
Jan 02 150405	2016-01-02 15:04:05 +0900 JST
Jan 02 15:04:05	2016-01-02 15:04:05 +0900 JST
Jan 02 150405.9	2016-01-02 15:04:05.000000009 +0900 JST
Jan 02 15:04:05.9	2016-01-02 15:04:05.000000009 +0900 JST
Jan 02 150405.999	2016-01-02 15:04:05.000000999 +0900 JST
Jan 02 15:04:05.999	2016-01-02 15:04:05.000000999 +0900 JST
Jan 02 150405.999999	2016-01-02 15:04:05.000999999 +0900 JST
Jan 02 15:04:05.999999	2016-01-02 15:04:05.000999999 +0900 JST
Jan 02 150405.999999999	2016-01-02 15:04:05.999999999 +0900 JST
Jan 02 15:04:05.999999999	2016-01-02 15:04:05.999999999 +0900 JST

US

Input String	_time.Time
11:04AM	2016-05-06 11:04:00 +0900 JST
11:04PM	2016-05-06 23:04:00 +0900 JST
11:04 AM	2016-05-06 11:04:00 +0900 JST
11:04 PM	2016-05-06 23:04:00 +0900 JST
11:04:05 AM	2016-05-06 11:04:05 +0900 JST
11:04:05 PM	2016-05-06 23:04:05 +0900 JST
11:04:05.9AM	2016-05-06 11:04:05.000000009 +0900 JST
11:04:05.9 AM	2016-05-06 11:04:05.000000009 +0900 JST
11:04:05.9PM	2016-05-06 23:04:05.000000009 +0900 JST
11:04:05.9 PM	2016-05-06 23:04:05.000000009 +0900 JST
11:04:05.999AM	2016-05-06 11:04:05.000000999 +0900 JST
11:04:05.999 AM	2016-05-06 11:04:05.000000999 +0900 JST
11:04:05.999PM	2016-05-06 23:04:05.000000999 +0900 JST
11:04:05.999 PM	2016-05-06 23:04:05.000000999 +0900 JST
11:04:05.999999AM	2016-05-06 11:04:05.000999999 +0900 JST
11:04:05.999999 AM	2016-05-06 11:04:05.000999999 +0900 JST
11:04:05.999999PM	2016-05-06 23:04:05.000999999 +0900 JST
11:04:05.999999 PM	2016-05-06 23:04:05.000999999 +0900 JST
11:04:05.999999999AM	2016-05-06 11:04:05.999999999 +0900 JST
11:04:05.999999999 AM	2016-05-06 11:04:05.999999999 +0900 JST
11:04:05.999999999PM	2016-05-06 23:04:05.999999999 +0900 JST
11:04:05.999999999 PM	2016-05-06 23:04:05.999999999 +0900 JST
01-02-06 3:04AM	2006-01-02 03:04:00 +0900 JST
01-02-06 3:04 AM	2006-01-02 03:04:00 +0900 JST
01-02-06 3:04PM	2006-01-02 15:04:00 +0900 JST
01-02-06 3:04 PM	2006-01-02 15:04:00 +0900 JST
01-02-06 03:04:05AM	2006-01-02 03:04:05 +0900 JST
01-02-06 03:04:05 AM	2006-01-02 03:04:05 +0900 JST
01-02-06 03:04:05PM	2006-01-02 15:04:05 +0900 JST
01-02-06 03:04:05 PM	2006-01-02 15:04:05 +0900 JST
01-02-06 03:04:05.9AM	2006-01-02 03:04:05.000000009 +0900 JST
01-02-06 03:04:05.9 AM	2006-01-02 03:04:05.000000009 +0900 JST
01-02-06 03:04:05.9PM	2006-01-02 15:04:05.000000009 +0900 JST
01-02-06 03:04:05.9 PM	2006-01-02 15:04:05.000000009 +0900 JST
01-02-06 03:04:05.999AM	2006-01-02 03:04:05.000000999 +0900 JST
01-02-06 03:04:05.999 AM	2006-01-02 03:04:05.000000999 +0900 JST
01-02-06 03:04:05.999PM	2006-01-02 15:04:05.000000999 +0900 JST
01-02-06 03:04:05.999 PM	2006-01-02 15:04:05.000000999 +0900 JST
01-02-06 03:04:05.999999AM	2006-01-02 03:04:05.000999999 +0900 JST
01-02-06 03:04:05.999999 AM	2006-01-02 03:04:05.000999999 +0900 JST
01-02-06 03:04:05.999999PM	2006-01-02 15:04:05.000999999 +0900 JST
01-02-06 03:04:05.999999 PM	2006-01-02 15:04:05.000999999 +0900 JST
01-02-06 03:04:05.999999999AM	2006-01-02 03:04:05.999999999 +0900 JST
01-02-06 03:04:05.999999999 AM	2006-01-02 03:04:05.999999999 +0900 JST
01-02-06 03:04:05.999999999PM	2006-01-02 15:04:05.999999999 +0900 JST
01-02-06 03:04:05.999999999 PM	2006-01-02 15:04:05.999999999 +0900 JST
Jan 2, 2006	2006-01-02 00:00:00 +0900 JST
Jan 2, 2006 at 3:04am (MST)	2006-01-02 03:04:00 -0700 MST
Jan 2, 2006 at 03:04am (MST)	2006-01-02 03:04:00 -0700 MST
Jan 2, 2006 at 3:04pm (MST)	2006-01-02 15:04:00 -0700 MST
Jan 2, 2006 at 03:04pm (MST)	2006-01-02 15:04:00 -0700 MST
Jan 2, 2006 at 3:04 am (MST)	2006-01-02 03:04:00 -0700 MST
Jan 2, 2006 at 03:04 am (MST)	2006-01-02 03:04:00 -0700 MST
Jan 2, 2006 at 3:04 pm (MST)	2006-01-02 15:04:00 -0700 MST
Jan 2, 2006 at 03:04 pm (MST)	2006-01-02 15:04:00 -0700 MST
Jan 2, 2006 at 3:04:05am (MST)	2006-01-02 03:04:05 -0700 MST
Jan 2, 2006 at 3:04:05pm (MST)	2006-01-02 15:04:05 -0700 MST
Jan 2, 2006 at 3:04:05 am (MST)	2006-01-02 03:04:05 -0700 MST
Jan 2, 2006 at 3:04:05 pm (MST)	2006-01-02 15:04:05 -0700 MST
Jan 2, 2006 at 3:04:05.9am (MST)	2006-01-02 03:04:05.000000009 -0700 MST
Jan 2, 2006 at 3:04:05.9pm (MST)	2006-01-02 15:04:05.000000009 -0700 MST
Jan 2, 2006 at 3:04:05.999am (MST)	2006-01-02 03:04:05.000000999 -0700 MST
Jan 2, 2006 at 3:04:05.999pm (MST)	2006-01-02 15:04:05.000000999 -0700 MST
Jan 2, 2006 at 3:04:05.999999am (MST)	2006-01-02 03:04:05.000999999 -0700 MST
Jan 2, 2006 at 3:04:05.999999pm (MST)	2006-01-02 15:04:05.000999999 -0700 MST
Jan 2, 2006 at 3:04:05.999999999am (MST)	2006-01-02 03:04:05.999999999 -0700 MST
Jan 2, 2006 at 3:04:05.999999999pm (MST)	2006-01-02 15:04:05.999999999 -0700 MST
Jan 2, 2006 at 3:04am MST	2006-01-02 03:04:00 -0700 MST
Jan 2, 2006 at 3:04pm MST	2006-01-02 15:04:00 -0700 MST
Jan 2, 2006 at 3:04am -07:00	2006-01-02 03:04:00 -0700 -0700
Jan 2, 2006 at 3:04pm -07:00	2006-01-02 15:04:00 -0700 -0700
Jan 2, 2006 at 3:04:05am MST	2006-01-02 03:04:05 -0700 MST
Jan 2, 2006 at 3:04:05pm MST	2006-01-02 15:04:05 -0700 MST
Jan 2, 2006 at 3:04:05am -07:00	2006-01-02 03:04:05 -0700 -0700
Jan 2, 2006 at 3:04:05pm -07:00	2006-01-02 15:04:05 -0700 -0700

Parse

Input String	_time.Time
2006-01-02 15:04	2006-01-02 15:04:00 +0900 JST
2006-01-02 15:04-07:00	2006-01-02 15:04:00 -0700 -0700
2006-01-02 15:04 -07:00	2006-01-02 15:04:00 -0700 -0700
2006-01-02 15:04:05	2006-01-02 15:04:05 +0900 JST
2006-01-02 15:04:05-07:00	2006-01-02 15:04:05 -0700 -0700
2006-01-02 15:04:05 -07:00	2006-01-02 15:04:05 -0700 -0700
2006-01-02 15:04:05-07:00 MST	2006-01-02 15:04:05 -0700 -0700
2006-01-02 15:04:05 -07:00 MST	2006-01-02 15:04:05 -0700 -0700
2006-01-02 15:04:05.999999999	2006-01-02 15:04:05.999999999 +0900 JST
2006-01-02 15:04:05.999999-07:00 MST	2006-01-02 15:04:05.000999999 -0700 -0700
2006-01-02 15:04:05.9-07:00 MST	2006-01-02 15:04:05.000000009 -0700 -0700
2006-01-02 15:04:05.9 -07:00 MST	2006-01-02 15:04:05.000000009 -0700 -0700
2006-01-02 15:04:05.999-07:00 MST	2006-01-02 15:04:05.000000999 -0700 -0700
2006-01-02 15:04:05.999 -07:00 MST	2006-01-02 15:04:05.000000999 -0700 -0700
2006-01-02 15:04:05.999999-07:00 MST	2006-01-02 15:04:05.000999999 -0700 -0700
2006-01-02 15:04:05.999999 -07:00 MST	2006-01-02 15:04:05.000999999 -0700 -0700
2006-01-02 15:04:05.999999999-07:00 MST	2006-01-02 15:04:05.999999999 -0700 -0700
2006-01-02 15:04:05.999999999 -07:00 MST	2006-01-02 15:04:05.999999999 -0700 -0700
2006-01-02T15:04	2006-01-02 15:04:00 +0900 JST
2006-01-02T15:04-07:00	2006-01-02 15:04:00 -0700 -0700
2006-01-02T15:04 -07:00	2006-01-02 15:04:00 -0700 -0700
2006-01-02T15:04:05	2006-01-02 15:04:05 +0900 JST
2006-01-02T15:04:05-07:00	2006-01-02 15:04:05 -0700 -0700
2006-01-02T15:04:05 -07:00	2006-01-02 15:04:05 -0700 -0700
2006-01-02T15:04:05-07:00 MST	2006-01-02 15:04:05 -0700 -0700
2006-01-02T15:04:05 -07:00 MST	2006-01-02 15:04:05 -0700 -0700
2006-01-02T15:04:05.999999999	2006-01-02 15:04:05.999999999 +0900 JST
2006-01-02T15:04:05.999999999-07:00 MST	2006-01-02 15:04:05.999999999 -0700 -0700
2006-01-02T15:04:05.999999999 -07:00 MST	2006-01-02 15:04:05.999999999 -0700 -0700
2006-01-02T15:04:05.999999-07:00 MST	2006-01-02 15:04:05.000999999 -0700 -0700
2006-01-02T15:04:05.999999 -07:00 MST	2006-01-02 15:04:05.000999999 -0700 -0700
2006-01-02T15:04:05.9-07:00 MST	2006-01-02 15:04:05.000000009 -0700 -0700
2006-01-02T15:04:05.9 -07:00 MST	2006-01-02 15:04:05.000000009 -0700 -0700
2006-01-02	2006-01-02 00:00:00 +0900 JST
20060102	2006-01-02 00:00:00 +0900 JST
20060102150405	2006-01-02 15:04:05 +0900 JST
20060102 150405	2006-01-02 15:04:05 +0900 JST
20060102T150405	2006-01-02 15:04:05 +0900 JST
15:04:05	2016-05-06 15:04:05 +0900 JST
15:04:05-07:00 MST	2016-05-06 15:04:05 -0700 -0700
15:04:05 -07:00 MST	2016-05-06 15:04:05 -0700 -0700
15:04:05.9-07:00 MST	2016-05-06 15:04:05.000000009 -0700 -0700
15:04:05.9 -07:00 MST	2016-05-06 15:04:05.000000009 -0700 -0700
15:04:05.999-07:00 MST	2016-05-06 15:04:05.000000999 -0700 -0700
15:04:05.999 -07:00 MST	2016-05-06 15:04:05.000000999 -0700 -0700
15:04:05.999999-07:00 MST	2016-05-06 15:04:05.000999999 -0700 -0700
15:04:05.999999 -07:00 MST	2016-05-06 15:04:05.000999999 -0700 -0700
15:04:05.999999999-07:00 MST	2016-05-06 15:04:05.999999999 -0700 -0700
15:04:05.999999999 -07:00 MST	2016-05-06 15:04:05.999999999 -0700 -0700
150405-07:00 MST	2016-05-06 15:04:05 -0700 -0700
150405 -07:00 MST	2016-05-06 15:04:05 -0700 -0700
150405.9-07:00 MST	2016-05-06 15:04:05.000000009 -0700 -0700
150405.9 -07:00 MST	2016-05-06 15:04:05.000000009 -0700 -0700
150405.999-07:00 MST	2016-05-06 15:04:05.000000999 -0700 -0700
150405.999 -07:00 MST	2016-05-06 15:04:05.000000999 -0700 -0700
150405.999999-07:00 MST	2016-05-06 15:04:05.000999999 -0700 -0700
150405.999999 -07:00 MST	2016-05-06 15:04:05.000999999 -0700 -0700
150405.999999999-07:00 MST	2016-05-06 15:04:05.999999999 -0700 -0700
150405.999999999 -07:00 MST	2016-05-06 15:04:05.999999999 -0700 -0700
2006-01-02 15:04:05Z	2006-01-02 15:04:05 +0000 UTC
2006-01-02T15:04:05Z	2006-01-02 15:04:05 +0000 UTC
2006-01-02 15:04:05.9Z	2006-01-02 15:04:05.000000009 +0000 UTC
2006-01-02T15:04:05.9Z	2006-01-02 15:04:05.000000009 +0000 UTC
2006-01-02 15:04:05.999Z	2006-01-02 15:04:05.000000999 +0000 UTC
2006-01-02T15:04:05.999Z	2006-01-02 15:04:05.000000999 +0000 UTC
2006-01-02 15:04:05.999999Z	2006-01-02 15:04:05.000999999 +0000 UTC
2006-01-02T15:04:05.999999Z	2006-01-02 15:04:05.000999999 +0000 UTC
2006-01-02 15:04:05.999999999Z	2006-01-02 15:04:05.999999999 +0000 UTC
2006-01-02T15:04:05.999999999Z	2006-01-02 15:04:05.999999999 +0000 UTC
02-Jan-06 1504 MST	2006-01-02 15:04:00 -0700 MST
02-Jan-06 15:04 MST	2006-01-02 15:04:00 -0700 MST
02-Jan-06 150405 MST	2006-01-02 15:04:05 -0700 MST
02-Jan-06 15:04:05 MST	2006-01-02 15:04:05 -0700 MST
02-Jan-06 1504-0700	2006-01-02 15:04:00 -0700 -0700
02-Jan-06 15:04-0700	2006-01-02 15:04:00 -0700 -0700
02-Jan-06 150405-0700	2006-01-02 15:04:05 -0700 -0700
02-Jan-06 15:04:05-0700	2006-01-02 15:04:05 -0700 -0700
02-Jan-06 15:04 -0700	2006-01-02 15:04:00 -0700 -0700
02-Jan-06 15:04:05 -0700	2006-01-02 15:04:05 -0700 -0700
Monday, 02-Jan-06 15:04 MST	2006-01-02 15:04:00 -0700 MST
Monday, 02-Jan-06 15:04:05 MST	2006-01-02 15:04:05 -0700 MST
Mon, 02-Jan-06 15:04 MST	2006-01-02 15:04:00 -0700 MST
Mon, 02-Jan-06 15:04:05 MST	2006-01-02 15:04:05 -0700 MST
Mon, 02-Jan-06 15:04-07:00	2006-01-02 15:04:00 -0700 -0700
Mon, 02-Jan-06 15:04:05-07:00	2006-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-06 15:04 -07:00	2006-01-02 15:04:00 -0700 -0700
Mon, 02-Jan-06 15:04:05 -07:00	2006-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-2006 15:04-07:00	2006-01-02 15:04:00 -0700 -0700
Mon, 02-Jan-2006 15:04:05-07:00	2006-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-2006 15:04 -07:00	2006-01-02 15:04:00 -0700 -0700
Mon, 02-Jan-2006 15:04:05 -07:00	2006-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-70 15:04-07:00	1970-01-02 15:04:00 -0700 -0700
Mon, 02-Jan-70 15:04:05-07:00	1970-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-70 15:04 -07:00	1970-01-02 15:04:00 -0700 -0700
Mon, 02-Jan-70 15:04:05 -07:00	1970-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-99 15:04-07:00	1999-01-02 15:04:00 -0700 -0700
Mon, 02-Jan-99 15:04:05-07:00	1999-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-99 15:04:05 -07:00	1999-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-00 15:04-07:00	2000-01-02 15:04:00 -0700 -0700
Mon, 02-Jan-00 15:04:05-07:00	2000-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-00 15:04:05 -07:00	2000-01-02 15:04:05 -0700 -0700
Mon, 02-Jan-00 15:04:05.9-07:00	2000-01-02 15:04:05.000000009 -0700 -0700
Mon, 02-Jan-00 15:04:05.9 -07:00	2000-01-02 15:04:05.000000009 -0700 -0700
Mon, 02-Jan-00 15:04:05.999-07:00	2000-01-02 15:04:05.000000999 -0700 -0700
Mon, 02-Jan-00 15:04:05.999 -07:00	2000-01-02 15:04:05.000000999 -0700 -0700
Mon, 02-Jan-00 15:04:05.999999-07:00	2000-01-02 15:04:05.000999999 -0700 -0700
Mon, 02-Jan-00 15:04:05.999999 -07:00	2000-01-02 15:04:05.000999999 -0700 -0700
Mon, 02-Jan-00 15:04:05.999999999-07:00	2000-01-02 15:04:05.999999999 -0700 -0700
Mon, 02-Jan-00 15:04:05.999999999 -07:00	2000-01-02 15:04:05.999999999 -0700 -0700
Mon Jan 02 150405 2006	2006-01-02 15:04:05 +0900 JST
Mon Jan 02 15:04:05 2006	2006-01-02 15:04:05 +0900 JST
Mon Jan 02 150405 MST 2006	2006-01-02 15:04:05 -0700 MST
Mon Jan 02 15:04:05 MST 2006	2006-01-02 15:04:05 -0700 MST
Mon Jan 02 1504-07:00 2006	2006-01-02 15:04:00 -0700 -0700
Mon Jan 02 15:04-07:00 2006	2006-01-02 15:04:00 -0700 -0700
Mon Jan 02 1504 -07:00 2006	2006-01-02 15:04:00 -0700 -0700
Mon Jan 02 15:04 -07:00 2006	2006-01-02 15:04:00 -0700 -0700
Mon Jan 02 150405-07:00 2006	2006-01-02 15:04:05 -0700 -0700
Mon Jan 02 15:04:05-07:00 2006	2006-01-02 15:04:05 -0700 -0700
Mon Jan 02 150405 -07:00 2006	2006-01-02 15:04:05 -0700 -0700
Mon Jan 02 15:04:05 -07:00 2006	2006-01-02 15:04:05 -0700 -0700
Jan 02 150405	2016-01-02 15:04:05 +0900 JST
Jan 02 15:04:05	2016-01-02 15:04:05 +0900 JST
Jan 02 150405.9	2016-01-02 15:04:05.000000009 +0900 JST
Jan 02 15:04:05.9	2016-01-02 15:04:05.000000009 +0900 JST
Jan 02 150405.999	2016-01-02 15:04:05.000000999 +0900 JST
Jan 02 15:04:05.999	2016-01-02 15:04:05.000000999 +0900 JST
Jan 02 150405.999999	2016-01-02 15:04:05.000999999 +0900 JST
Jan 02 15:04:05.999999	2016-01-02 15:04:05.000999999 +0900 JST
Jan 02 150405.999999999	2016-01-02 15:04:05.999999999 +0900 JST
Jan 02 15:04:05.999999999	2016-01-02 15:04:05.999999999 +0900 JST
11:04AM	2016-05-06 11:04:00 +0900 JST
11:04PM	2016-05-06 23:04:00 +0900 JST
11:04 AM	2016-05-06 11:04:00 +0900 JST
11:04 PM	2016-05-06 23:04:00 +0900 JST
11:04:05 AM	2016-05-06 11:04:05 +0900 JST
11:04:05 PM	2016-05-06 23:04:05 +0900 JST
11:04:05.9AM	2016-05-06 11:04:05.000000009 +0900 JST
11:04:05.9 AM	2016-05-06 11:04:05.000000009 +0900 JST
11:04:05.9PM	2016-05-06 23:04:05.000000009 +0900 JST
11:04:05.9 PM	2016-05-06 23:04:05.000000009 +0900 JST
11:04:05.999AM	2016-05-06 11:04:05.000000999 +0900 JST
11:04:05.999 AM	2016-05-06 11:04:05.000000999 +0900 JST
11:04:05.999PM	2016-05-06 23:04:05.000000999 +0900 JST
11:04:05.999 PM	2016-05-06 23:04:05.000000999 +0900 JST
11:04:05.999999AM	2016-05-06 11:04:05.000999999 +0900 JST
11:04:05.999999 AM	2016-05-06 11:04:05.000999999 +0900 JST
11:04:05.999999PM	2016-05-06 23:04:05.000999999 +0900 JST
11:04:05.999999 PM	2016-05-06 23:04:05.000999999 +0900 JST
11:04:05.999999999AM	2016-05-06 11:04:05.999999999 +0900 JST
11:04:05.999999999 AM	2016-05-06 11:04:05.999999999 +0900 JST
11:04:05.999999999PM	2016-05-06 23:04:05.999999999 +0900 JST
11:04:05.999999999 PM	2016-05-06 23:04:05.999999999 +0900 JST
01-02-06 3:04AM	2006-01-02 03:04:00 +0900 JST
01-02-06 3:04 AM	2006-01-02 03:04:00 +0900 JST
01-02-06 3:04PM	2006-01-02 15:04:00 +0900 JST
01-02-06 3:04 PM	2006-01-02 15:04:00 +0900 JST
01-02-06 03:04:05AM	2006-01-02 03:04:05 +0900 JST
01-02-06 03:04:05 AM	2006-01-02 03:04:05 +0900 JST
01-02-06 03:04:05PM	2006-01-02 15:04:05 +0900 JST
01-02-06 03:04:05 PM	2006-01-02 15:04:05 +0900 JST
01-02-06 03:04:05.9AM	2006-01-02 03:04:05.000000009 +0900 JST
01-02-06 03:04:05.9 AM	2006-01-02 03:04:05.000000009 +0900 JST
01-02-06 03:04:05.9PM	2006-01-02 15:04:05.000000009 +0900 JST
01-02-06 03:04:05.9 PM	2006-01-02 15:04:05.000000009 +0900 JST
01-02-06 03:04:05.999AM	2006-01-02 03:04:05.000000999 +0900 JST
01-02-06 03:04:05.999 AM	2006-01-02 03:04:05.000000999 +0900 JST
01-02-06 03:04:05.999PM	2006-01-02 15:04:05.000000999 +0900 JST
01-02-06 03:04:05.999 PM	2006-01-02 15:04:05.000000999 +0900 JST
01-02-06 03:04:05.999999AM	2006-01-02 03:04:05.000999999 +0900 JST
01-02-06 03:04:05.999999 AM	2006-01-02 03:04:05.000999999 +0900 JST
01-02-06 03:04:05.999999PM	2006-01-02 15:04:05.000999999 +0900 JST
01-02-06 03:04:05.999999 PM	2006-01-02 15:04:05.000999999 +0900 JST
01-02-06 03:04:05.999999999AM	2006-01-02 03:04:05.999999999 +0900 JST
01-02-06 03:04:05.999999999 AM	2006-01-02 03:04:05.999999999 +0900 JST
01-02-06 03:04:05.999999999PM	2006-01-02 15:04:05.999999999 +0900 JST
01-02-06 03:04:05.999999999 PM	2006-01-02 15:04:05.999999999 +0900 JST
Jan 2, 2006	2006-01-02 00:00:00 +0900 JST
Jan 2, 2006 at 3:04am (MST)	2006-01-02 03:04:00 -0700 MST
Jan 2, 2006 at 03:04am (MST)	2006-01-02 03:04:00 -0700 MST
Jan 2, 2006 at 3:04pm (MST)	2006-01-02 15:04:00 -0700 MST
Jan 2, 2006 at 03:04pm (MST)	2006-01-02 15:04:00 -0700 MST
Jan 2, 2006 at 3:04 am (MST)	2006-01-02 03:04:00 -0700 MST
Jan 2, 2006 at 03:04 am (MST)	2006-01-02 03:04:00 -0700 MST
Jan 2, 2006 at 3:04 pm (MST)	2006-01-02 15:04:00 -0700 MST
Jan 2, 2006 at 03:04 pm (MST)	2006-01-02 15:04:00 -0700 MST
Jan 2, 2006 at 3:04:05am (MST)	2006-01-02 03:04:05 -0700 MST
Jan 2, 2006 at 3:04:05pm (MST)	2006-01-02 15:04:05 -0700 MST
Jan 2, 2006 at 3:04:05 am (MST)	2006-01-02 03:04:05 -0700 MST
Jan 2, 2006 at 3:04:05 pm (MST)	2006-01-02 15:04:05 -0700 MST
Jan 2, 2006 at 3:04:05.9am (MST)	2006-01-02 03:04:05.000000009 -0700 MST
Jan 2, 2006 at 3:04:05.9pm (MST)	2006-01-02 15:04:05.000000009 -0700 MST
Jan 2, 2006 at 3:04:05.999am (MST)	2006-01-02 03:04:05.000000999 -0700 MST
Jan 2, 2006 at 3:04:05.999pm (MST)	2006-01-02 15:04:05.000000999 -0700 MST
Jan 2, 2006 at 3:04:05.999999am (MST)	2006-01-02 03:04:05.000999999 -0700 MST
Jan 2, 2006 at 3:04:05.999999pm (MST)	2006-01-02 15:04:05.000999999 -0700 MST
Jan 2, 2006 at 3:04:05.999999999am (MST)	2006-01-02 03:04:05.999999999 -0700 MST
Jan 2, 2006 at 3:04:05.999999999pm (MST)	2006-01-02 15:04:05.999999999 -0700 MST
Jan 2, 2006 at 3:04am MST	2006-01-02 03:04:00 -0700 MST
Jan 2, 2006 at 3:04pm MST	2006-01-02 15:04:00 -0700 MST
Jan 2, 2006 at 3:04am -07:00	2006-01-02 03:04:00 -0700 -0700
Jan 2, 2006 at 3:04pm -07:00	2006-01-02 15:04:00 -0700 -0700
Jan 2, 2006 at 3:04:05am MST	2006-01-02 03:04:05 -0700 MST
Jan 2, 2006 at 3:04:05pm MST	2006-01-02 15:04:05 -0700 MST
Jan 2, 2006 at 3:04:05am -07:00	2006-01-02 03:04:05 -0700 -0700
Jan 2, 2006 at 3:04:05pm -07:00	2006-01-02 15:04:05 -0700 -0700

Documentation ¶

Index ¶

Variables
type ParseTime
- func NewParseTime(location ...interface{}) (ParseTime, error)

Constants ¶

This section is empty.

Variables ¶

View Source

var (
	// ISO8601, RFC3339
	ISO8601 = strings.Join([]string{
		`(?:`, year, ymdSep, month, ymdSep, day, `)?`, t,
		`(?:`, hour, hmsSep, min, hmsSep, sec, `?`, nsec, `)?`,
		s, offset, s, zone,
	}, "")

	// RFC822, RFC850, RFC1123
	RFC8xx1123 = strings.Join([]string{
		`(?:`, weekday, `,?`, s, `)?`, day, ymdSep, monthAbbr, ymdSep, shortYear,
		hmsSep, `(?:`, hour, hmsSep, min, hmsSep, sec, `?`, nsec, `)?`,
		s, offsetZone,
	}, "")

	ANSIC = strings.Join([]string{
		`(?:`, weekday, s, `)?`, monthAbbr, ymdSep, day, ymdSep,
		`(?:`, hour, hmsSep, min, hmsSep, sec, `?`, nsec, `)?`,
		s, `(?:`, offsetZone, s, year, `)?`,
	}, "")

	US = strings.Join([]string{
		`(?:`, monthAbbr, ymdSep, day, `(?:,)?`, ymdSep, shortYear, `)?`, s, `(?:at)?`, s,
		`(?:`, hour, hmsSep, min, hmsSep, sec, `?`, nsec, `)?`,
		s, ampm, `?`, s, usOffsetZone,
	}, "")

	Months = map[string]int{
		"Jan":       1,
		"January":   1,
		"Feb":       2,
		"Februray":  2,
		"Mar":       3,
		"March":     3,
		"Apr":       4,
		"April":     4,
		"May":       5,
		"Jun":       6,
		"June":      6,
		"Jul":       7,
		"July":      7,
		"Aug":       8,
		"August":    8,
		"Sep":       9,
		"September": 9,
		"Oct":       10,
		"October":   10,
		"Nov":       11,
		"November":  11,
		"Dec":       12,
		"December":  12,
	}
)

Regular expressions

Functions ¶

This section is empty.

Types ¶

func NewParseTime ¶

func NewParseTime(location ...interface{}) (ParseTime, error)

NewParseTime creates a new ParseTime instance with a specified time location. The location can be provided in several ways based on the number and type of arguments passed.

Parameters (variadic):

With no arguments: Uses the current local timezone -
With one argument: Can be either:
1. time.Location: Uses the provided location directly
2. string: Can be:
- A. Empty string: Uses the current local timezone
- B. Timezone name: Loads the location using time.LoadLocation
- C. Timezone abbreviation: Attempts to parse using internal timezone database -
With two arguments:
1. string: Name for the timezone
2. int: Offset in seconds from UTC

Returns:

ParseTime: A new ParseTime instance configured with the specified location
error: An error if the location couldn't be determined or if invalid arguments were provided

Example usage:

// Using local timezone
pt1, _ := NewParseTime()

// Using a specific timezone name
pt2, _ := NewParseTime("America/New_York")

// Using a fixed timezone
pt3, _ := NewParseTime("EST", -18000)  // EST = UTC-5

// Using a time.Location
loc := time.UTC
pt4, _ := NewParseTime(loc)

Errors:

Returns error if more than 2 arguments are provided
Returns error if timezone name is invalid and not a recognized abbreviation
Returns error if arguments are of invalid types

func (*ParseTime) ANSIC ¶

func (pt *ParseTime) ANSIC(value string) (time.Time, error)

ANSIC parses a date/time string in ANSI C format using the ParseTime instance's location. This is a convenience wrapper around parseANSIC that omits the priority value from the return.

The ANSI C format is: "Mon Jan _2 15:04:05 2006" Format components:

Weekday name (optional)
Month name
Day of month (space-padded for single digits)
Hour:Minute:Second (24-hour format)
Optional nanoseconds
Optional timezone
Year (4 digits)

Parameters:

value: A string in ANSI C format

Returns:

time.Time: The parsed time value
error: An error if the string cannot be parsed in ANSI C format

Example usage:

pt, _ := NewParseTime("America/New_York")

// Basic format
t1, _ := pt.ANSIC("Jan  2 15:04:05 2006")

// With timezone
t2, _ := pt.ANSIC("Jan  2 15:04:05 EST 2006")

// With nanoseconds
t3, _ := pt.ANSIC("Jan  2 15:04:05.123456789 2006")

func (*ParseTime) GetLocation ¶

func (pt *ParseTime) GetLocation() *time.Location

GetLocation returns *time.Location

func (*ParseTime) ISO8601 ¶

func (pt *ParseTime) ISO8601(value string) (time.Time, error)

ISO8601 parses ISO8601, RFC3339 date/time string

func (*ParseTime) Parse ¶

func (pt *ParseTime) Parse(value string) (time.Time, error)

Parse attempts to parse a date/time string using multiple format parsers, returning the most appropriate match. It tries the following formats in order:

ISO8601 (e.g., "2006-01-02T15:04:05Z")
RFC822/RFC850/RFC1123 (e.g., "Mon, 02 Jan 2006 15:04:05 MST")
ANSI C (e.g., "Mon Jan _2 15:04:05 2006")
US format (e.g., "Jan 2, 2006 3:04:05 PM MST")

The function uses a priority system to determine the best match when multiple formats are valid for the input string. The priority is based on how closely the input matches each format pattern, with lower priority values indicating better matches.

Parameters:

value: A date/time string in any of the supported formats

Returns:

time.Time: The parsed time value from the best matching format
error: errInvalidDateTime if the string cannot be parsed in any supported format

Example usage:

pt, _ := NewParseTime("America/New_York")

// ISO8601 format
t1, _ := pt.Parse("2006-01-02T15:04:05Z")

// RFC1123 format
t2, _ := pt.Parse("Mon, 02 Jan 2006 15:04:05 MST")

// ANSI C format
t3, _ := pt.Parse("Jan  2 15:04:05 2006")

// US format
t4, _ := pt.Parse("Jan 2, 2006 3:04:05 PM")

Note: If a string is valid in multiple formats, the format with the closest match (lowest priority value) will be used to parse the final time value.

func (*ParseTime) RFC8xx1123 ¶

func (pt *ParseTime) RFC8xx1123(value string) (time.Time, error)

RFC8xx1123 parses a date/time string in RFC822, RFC850, or RFC1123 format using the ParseTime instance's location. This is a convenience wrapper around parseRFC8xx1123 that omits the priority value from the return.

Supported formats:

RFC822: "02 Jan 06 15:04 MST"
RFC850: "Monday, 02-Jan-06 15:04:05 MST"
RFC1123: "Mon, 02 Jan 2006 15:04:05 MST"

Parameters:

value: A string in RFC822, RFC850, or RFC1123 format

Returns:

time.Time: The parsed time value
error: An error if the string cannot be parsed in any of the supported formats

Example usage:

pt, _ := NewParseTime("America/New_York")

// Parse RFC822
t1, _ := pt.RFC8xx1123("02 Jan 06 15:04 EST")

// Parse RFC850
t2, _ := pt.RFC8xx1123("Monday, 02-Jan-06 15:04:05 EST")

// Parse RFC1123
t3, _ := pt.RFC8xx1123("Mon, 02 Jan 2006 15:04:05 EST")

func (*ParseTime) SetLocation ¶

func (pt *ParseTime) SetLocation(loc *time.Location)

SetLocation sets *time.Location

func (*ParseTime) US ¶

func (pt *ParseTime) US(value string) (time.Time, error)

US parses a date/time string in US format using the ParseTime instance's location. This is a convenience wrapper around parseUS that omits the priority value from the return.

Supported formats include:

Date only: "Jan 2, 2006" or "January 2, 2006" or "01/02/2006"
With time: "Jan 2, 2006 3:04:05 PM"
With timezone: "Jan 2, 2006 3:04:05 PM MST"
With nanoseconds: "Jan 2, 2006 3:04:05.999999999 PM MST"

The function handles both 12-hour (with AM/PM) and 24-hour time formats. When only date is provided, time is set to midnight (00:00:00).

Parameters:

value: A string in US date format

Returns:

time.Time: The parsed time value
error: An error if the string cannot be parsed in US format

Example usage:

pt, _ := NewParseTime("America/New_York")

// Parse date only
t1, _ := pt.US("Jan 2, 2006")

// Parse with time (12-hour format)
t2, _ := pt.US("January 2, 2006 3:04:05 PM")

// Parse with timezone
t3, _ := pt.US("Jan 2, 2006 15:04:05 EST")

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
example

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

README ¶

parsetime

Usage

parsetime.NewParseTime

parsetime.NewParseTime()

parsetime.NewParseTime("location name")

parsetime.NewParseTime("timezone name")

parsetime.NewParseTime("timezone name", offset)

ParseTime

ParseTime.GetLocation

ParseTime.SetLocation

ParseTime.ISO8601

ParseTime.RFC8xx1123

ParseTime.ANSIC

ParseTime.US

ParseTime.Parse

Examples

ISO8601

RFC8xx1123

ANSIC

US

Parse

Documentation ¶

Index ¶

Constants ¶

Variables ¶

Functions ¶

Types ¶

type ParseTime ¶

func NewParseTime ¶

func (*ParseTime) ANSIC ¶

func (*ParseTime) GetLocation ¶

func (*ParseTime) ISO8601 ¶

func (*ParseTime) Parse ¶

func (*ParseTime) RFC8xx1123 ¶

func (*ParseTime) SetLocation ¶

func (*ParseTime) US ¶

Source Files ¶

Directories ¶

`parsetime.NewParseTime`

`parsetime.NewParseTime()`

`parsetime.NewParseTime("location name")`

`parsetime.NewParseTime("timezone name")`

`parsetime.NewParseTime("timezone name", offset)`

`ParseTime`

`ParseTime.GetLocation`

`ParseTime.SetLocation`

`ParseTime.ISO8601`

`ParseTime.RFC8xx1123`

`ParseTime.ANSIC`

`ParseTime.US`

`ParseTime.Parse`