go-pkg/dateparse
2
0
Fork 0
mirror of https://github.com/araddon/dateparse.git synced 2024-09-20 02:55:43 +08:00
Code Issues Projects Releases Wiki Activity
828a4abb0c
dateparse/README.md

249 lines
12 KiB
Markdown
Raw Normal View History

doc readme
2014-05-12 01:22:53 +08:00
Go Date Parser
---------------------------
Doc cleanup
2017-07-18 12:08:35 +08:00
Parse any date string without knowing format in advance. Uses a scanner to read bytes and use a state machine to find format. Much faster than shotgun based parse methods. See [bench_test.go](https://github.com/araddon/dateparse/blob/master/bench_test.go) for performance comparison.
Benchmark tests for DateParse
2014-12-06 07:20:57 +08:00
Badges add reportcard
2017-08-13 01:17:40 +08:00
[![Code Coverage](https://codecov.io/gh/araddon/dateparse/branch/master/graph/badge.svg)](https://codecov.io/gh/araddon/dateparse)
[![GoDoc](https://godoc.org/github.com/araddon/dateparse?status.svg)](http://godoc.org/github.com/araddon/dateparse)
[![Build Status](https://travis-ci.org/araddon/dateparse.svg?branch=master)](https://travis-ci.org/araddon/dateparse)
[![Go ReportCard](https://goreportcard.com/badge/araddon/dateparse)](https://goreportcard.com/report/araddon/dateparse)
100% test coverage and simplification
2017-07-14 10:57:15 +08:00
Doc cleanup
2017-07-18 12:08:35 +08:00
**Timezones** The location your server is configured effects the results! See example or https://play.golang.org/p/IDHRalIyXh and last paragraph here https://golang.org/pkg/time/#Parse.
Doc cleanup
2017-07-18 12:06:57 +08:00
Parse In Location api
2017-07-27 07:42:12 +08:00
```go
Doc improvements
2017-07-27 13:37:37 +08:00
// Normal parse. Equivalent Timezone rules as time.Parse()
Parse In Location api
2017-07-27 07:42:12 +08:00
t, err := dateparse.ParseAny("3/1/2014")
Doc improvements
2017-07-27 13:37:37 +08:00
// Parse with Location, equivalent to time.ParseInLocation() timezone/offset
// rules. Using location arg, if timezone/offset info exists in the
// datestring, it uses the given location rules for any zone interpretation.
// That is, MST means one thing when using America/Denver and something else
// in other locations.
Parse In Location api
2017-07-27 07:42:12 +08:00
denverLoc, _ := time.LoadLocation("America/Denver")
t, err := dateparse.ParseIn("3/1/2014", denverLoc)
Doc improvements
2017-07-27 13:37:37 +08:00
// Set Location to time.Local. Same as ParseIn Location but lazily uses
// the global time.Local variable for Location argument.
Improve doc on time.Location usage
2017-07-27 08:08:58 +08:00
denverLoc, _ := time.LoadLocation("America/Denver")
// use time.Local global variable to store location
time.Local = denverLoc
t, err := dateparse.ParseLocal("3/1/2014")
Doc improvements
2017-07-27 13:37:37 +08:00
// Equivalent to
t, err := dateparse.ParseIn("3/1/2014", time.Local)
Improve doc on time.Location usage
2017-07-27 08:08:58 +08:00
Parse In Location api
2017-07-27 07:42:12 +08:00
```
Improve CLI tool for example usage
2017-07-27 09:15:47 +08:00
cli tool for testing dateformats
----------------------------------
[Date Parse CLI](https://github.com/araddon/dateparse/blob/master/dateparse)
Improve CLI tool for example usage
2017-07-27 09:16:34 +08:00
Extended example
-------------------
https://github.com/araddon/dateparse/blob/master/example/main.go
doc readme
2014-05-12 01:22:53 +08:00
```go
create example and update readme
2017-01-05 14:23:42 +08:00
package main
import (
new date format for 2013-Feb-03
2017-07-27 07:55:21 +08:00
"flag"
create example and update readme
2017-01-05 14:23:42 +08:00
"fmt"
Doc cleanup
2017-07-18 12:06:57 +08:00
"time"
create example and update readme
2017-01-05 14:23:42 +08:00
"github.com/apcera/termtables"
"github.com/araddon/dateparse"
)
var examples = []string{
"May 8, 2009 5:57:51 PM",
"Mon Jan 2 15:04:05 2006",
"Mon Jan 2 15:04:05 MST 2006",
"Mon Jan 02 15:04:05 -0700 2006",
"Monday, 02-Jan-06 15:04:05 MST",
"Mon, 02 Jan 2006 15:04:05 MST",
doc update
2017-07-22 00:40:43 +08:00
"Tue, 11 Jul 2017 16:28:13 +0200 (CEST)",
"Mon, 02 Jan 2006 15:04:05 -0700",
new date format closes #32
2018-01-05 15:08:24 +08:00
"Thu, 4 Jan 2018 17:53:36 +0000",
create example and update readme
2017-01-05 14:23:42 +08:00
"Mon Aug 10 15:44:11 UTC+0100 2015",
"Fri Jul 03 2015 18:04:07 GMT+0100 (GMT Daylight Time)",
Update docs from latest changes
2017-02-15 00:27:25 +08:00
"12 Feb 2006, 19:17",
new date format for 2013-Feb-03
2017-07-27 07:55:21 +08:00
"2013-Feb-03",
new format "2 January 2006" closes #36
2018-01-25 09:59:25 +08:00
"03 February 2013",
doc update
2017-07-22 00:40:43 +08:00
// mm/dd/yy
create example and update readme
2017-01-05 14:23:42 +08:00
"3/31/2014",
"03/31/2014",
"08/21/71",
"8/1/71",
"4/8/2014 22:05",
"04/08/2014 22:05",
update example with new format
2017-11-19 02:25:55 +08:00
"4/8/14 22:05",
create example and update readme
2017-01-05 14:23:42 +08:00
"04/2/2014 03:00:51",
"8/8/1965 12:00:00 AM",
Update docs from latest changes
2017-02-15 00:27:25 +08:00
"8/8/1965 01:00:01 PM",
"8/8/1965 01:00 PM",
"8/8/1965 1:00 PM",
"8/8/1965 12:00 AM",
create example and update readme
2017-01-05 14:23:42 +08:00
"4/02/2014 03:00:51",
"03/19/2012 10:11:59",
"03/19/2012 10:11:59.3186369",
doc update
2017-07-22 00:40:43 +08:00
// yyyy/mm/dd
create example and update readme
2017-01-05 14:23:42 +08:00
"2014/3/31",
"2014/03/31",
"2014/4/8 22:05",
"2014/04/08 22:05",
"2014/04/2 03:00:51",
"2014/4/02 03:00:51",
"2012/03/19 10:11:59",
"2012/03/19 10:11:59.3186369",
Support Chinese Date Format
2017-11-19 03:07:33 +08:00
// Chinese
"2014年04月08日",
doc update
2017-07-22 00:40:43 +08:00
// yyyy-mm-ddThh
"2006-01-02T15:04:05+0000",
create example and update readme
2017-01-05 14:23:42 +08:00
"2009-08-12T22:15:09-07:00",
"2009-08-12T22:15:09",
doc update
2017-07-22 00:40:43 +08:00
"2009-08-12T22:15:09Z",
// yyyy-mm-dd hh:mm:ss
create example and update readme
2017-01-05 14:23:42 +08:00
"2014-04-26 17:24:37.3186369",
"2012-08-03 18:31:59.257000000",
"2014-04-26 17:24:37.123",
doc update for #31
2017-12-12 02:59:18 +08:00
"2013-04-01 22:43",
doc update
2017-07-22 00:40:43 +08:00
"2013-04-01 22:43:22",
create example and update readme
2017-01-05 14:23:42 +08:00
"2014-12-16 06:20:00 UTC",
"2014-12-16 06:20:00 GMT",
"2014-04-26 05:24:37 PM",
README update
2017-06-15 05:05:02 +08:00
"2014-04-26 13:13:43 +0800",
"2014-04-26 13:13:44 +09:00",
doc update
2017-07-22 00:40:43 +08:00
"2012-08-03 18:31:59.257000000 +0000 UTC",
"2015-09-30 18:48:56.35272715 +0000 UTC",
"2015-02-18 00:12:00 +0000 GMT",
"2015-02-18 00:12:00 +0000 UTC",
"2017-07-19 03:21:51+00:00",
create example and update readme
2017-01-05 14:23:42 +08:00
"2014-04-26",
"2014-04",
"2014",
"2014-05-11 08:20:13,787",
mm.dd.yyyy format closes #34 (pr #35)
2018-01-12 05:21:04 +08:00
// mm.dd.yy
"3.31.2014",
"03.31.2014",
"08.21.71",
create example and update readme
2017-01-05 14:23:42 +08:00
// yyyymmdd and similar
"20140601",
// unix seconds, ms
"1332151919",
"1384216367189",
}
doc readme
2014-05-12 01:22:53 +08:00
new date format for 2013-Feb-03
2017-07-27 07:55:21 +08:00
var (
timezone = ""
)
doc update
2017-07-22 00:40:43 +08:00
create example and update readme
2017-01-05 14:23:42 +08:00
func main() {
new date format for 2013-Feb-03
2017-07-27 07:55:21 +08:00
flag.StringVar(&timezone, "timezone", "UTC", "Timezone aka `America/Los_Angeles` formatted time-zone")
flag.Parse()
if timezone != "" {
// NOTE: This is very, very important to understand
// time-parsing in go
loc, err := time.LoadLocation(timezone)
if err != nil {
panic(err.Error())
}
time.Local = loc
}
Doc cleanup
2017-07-18 12:06:57 +08:00
create example and update readme
2017-01-05 14:23:42 +08:00
table := termtables.CreateTable()
table.AddHeaders("Input", "Parsed, and Output as %v")
for _, dateExample := range examples {
new date format for 2013-Feb-03
2017-07-27 07:55:21 +08:00
t, err := dateparse.ParseLocal(dateExample)
Doc cleanup
2017-07-18 12:06:57 +08:00
if err != nil {
panic(err.Error())
}
new date format for 2013-Feb-03
2017-07-27 07:55:21 +08:00
table.AddRow(dateExample, fmt.Sprintf("%v", t))
create example and update readme
2017-01-05 14:23:42 +08:00
}
fmt.Println(table.Render())
doc readme
2014-05-12 01:22:53 +08:00
}
Doc cleanup
2017-07-18 12:11:16 +08:00
new date format for 2013-Feb-03
2017-07-27 07:55:21 +08:00
/*
Doc cleanup
2017-07-18 12:06:57 +08:00
+-------------------------------------------------------+----------------------------------------+
| Input | Parsed, and Output as %v |
+-------------------------------------------------------+----------------------------------------+
| May 8, 2009 5:57:51 PM | 2009-05-08 17:57:51 +0000 UTC |
| Mon Jan 2 15:04:05 2006 | 2006-01-02 15:04:05 +0000 UTC |
| Mon Jan 2 15:04:05 MST 2006 | 2006-01-02 15:04:05 +0000 MST |
| Mon Jan 02 15:04:05 -0700 2006 | 2006-01-02 15:04:05 -0700 -0700 |
| Monday, 02-Jan-06 15:04:05 MST | 2006-01-02 15:04:05 +0000 MST |
| Mon, 02 Jan 2006 15:04:05 MST | 2006-01-02 15:04:05 +0000 MST |
| Tue, 11 Jul 2017 16:28:13 +0200 (CEST) | 2017-07-11 16:28:13 +0200 +0200 |
| Mon, 02 Jan 2006 15:04:05 -0700 | 2006-01-02 15:04:05 -0700 -0700 |
new date format closes #32
2018-01-05 15:08:24 +08:00
| Thu, 4 Jan 2018 17:53:36 +0000 | 2018-01-04 17:53:36 +0000 UTC |
Doc cleanup
2017-07-18 12:06:57 +08:00
| Mon Aug 10 15:44:11 UTC+0100 2015 | 2015-08-10 15:44:11 +0000 UTC |
| Fri Jul 03 2015 18:04:07 GMT+0100 (GMT Daylight Time) | 2015-07-03 18:04:07 +0100 GMT |
| 12 Feb 2006, 19:17 | 2006-02-12 19:17:00 +0000 UTC |
new date format for 2013-Feb-03
2017-07-27 07:55:21 +08:00
| 2013-Feb-03 | 2013-02-03 00:00:00 +0000 UTC |
new format "2 January 2006" closes #36
2018-01-25 09:59:25 +08:00
| 03 February 2013 | 2013-02-03 00:00:00 +0000 UTC |
Doc cleanup
2017-07-18 12:06:57 +08:00
| 3/31/2014 | 2014-03-31 00:00:00 +0000 UTC |
| 03/31/2014 | 2014-03-31 00:00:00 +0000 UTC |
| 08/21/71 | 1971-08-21 00:00:00 +0000 UTC |
| 8/1/71 | 1971-08-01 00:00:00 +0000 UTC |
| 4/8/2014 22:05 | 2014-04-08 22:05:00 +0000 UTC |
| 04/08/2014 22:05 | 2014-04-08 22:05:00 +0000 UTC |
update example with new format
2017-11-19 02:25:55 +08:00
| 4/8/14 22:05 | 2014-04-08 22:05:00 +0000 UTC |
Doc cleanup
2017-07-18 12:06:57 +08:00
| 04/2/2014 03:00:51 | 2014-04-02 03:00:51 +0000 UTC |
| 8/8/1965 12:00:00 AM | 1965-08-08 00:00:00 +0000 UTC |
| 8/8/1965 01:00:01 PM | 1965-08-08 13:00:01 +0000 UTC |
| 8/8/1965 01:00 PM | 1965-08-08 13:00:00 +0000 UTC |
| 8/8/1965 1:00 PM | 1965-08-08 13:00:00 +0000 UTC |
| 8/8/1965 12:00 AM | 1965-08-08 00:00:00 +0000 UTC |
| 4/02/2014 03:00:51 | 2014-04-02 03:00:51 +0000 UTC |
| 03/19/2012 10:11:59 | 2012-03-19 10:11:59 +0000 UTC |
| 03/19/2012 10:11:59.3186369 | 2012-03-19 10:11:59.3186369 +0000 UTC |
| 2014/3/31 | 2014-03-31 00:00:00 +0000 UTC |
| 2014/03/31 | 2014-03-31 00:00:00 +0000 UTC |
| 2014/4/8 22:05 | 2014-04-08 22:05:00 +0000 UTC |
| 2014/04/08 22:05 | 2014-04-08 22:05:00 +0000 UTC |
| 2014/04/2 03:00:51 | 2014-04-02 03:00:51 +0000 UTC |
| 2014/4/02 03:00:51 | 2014-04-02 03:00:51 +0000 UTC |
| 2012/03/19 10:11:59 | 2012-03-19 10:11:59 +0000 UTC |
| 2012/03/19 10:11:59.3186369 | 2012-03-19 10:11:59.3186369 +0000 UTC |
new format "2 January 2006" closes #36
2018-01-25 09:59:25 +08:00
| 2014年04月08日 | 2014-04-08 00:00:00 +0000 UTC |
new date format for 2013-Feb-03
2017-07-27 07:55:21 +08:00
| 2006-01-02T15:04:05+0000 | 2006-01-02 15:04:05 +0000 UTC |
Doc cleanup
2017-07-18 12:06:57 +08:00
| 2009-08-12T22:15:09-07:00 | 2009-08-12 22:15:09 -0700 -0700 |
| 2009-08-12T22:15:09 | 2009-08-12 22:15:09 +0000 UTC |
new date format for 2013-Feb-03
2017-07-27 07:55:21 +08:00
| 2009-08-12T22:15:09Z | 2009-08-12 22:15:09 +0000 UTC |
Doc cleanup
2017-07-18 12:06:57 +08:00
| 2014-04-26 17:24:37.3186369 | 2014-04-26 17:24:37.3186369 +0000 UTC |
| 2012-08-03 18:31:59.257000000 | 2012-08-03 18:31:59.257 +0000 UTC |
| 2014-04-26 17:24:37.123 | 2014-04-26 17:24:37.123 +0000 UTC |
doc update for #31
2017-12-12 02:59:18 +08:00
| 2013-04-01 22:43 | 2013-04-01 22:43:00 +0000 UTC |
new date format for 2013-Feb-03
2017-07-27 07:55:21 +08:00
| 2013-04-01 22:43:22 | 2013-04-01 22:43:22 +0000 UTC |
Doc cleanup
2017-07-18 12:06:57 +08:00
| 2014-12-16 06:20:00 UTC | 2014-12-16 06:20:00 +0000 UTC |
| 2014-12-16 06:20:00 GMT | 2014-12-16 06:20:00 +0000 UTC |
| 2014-04-26 05:24:37 PM | 2014-04-26 17:24:37 +0000 UTC |
| 2014-04-26 13:13:43 +0800 | 2014-04-26 13:13:43 +0800 +0800 |
| 2014-04-26 13:13:44 +09:00 | 2014-04-26 13:13:44 +0900 +0900 |
new date format for 2013-Feb-03
2017-07-27 07:55:21 +08:00
| 2012-08-03 18:31:59.257000000 +0000 UTC | 2012-08-03 18:31:59.257 +0000 UTC |
| 2015-09-30 18:48:56.35272715 +0000 UTC | 2015-09-30 18:48:56.35272715 +0000 UTC |
| 2015-02-18 00:12:00 +0000 GMT | 2015-02-18 00:12:00 +0000 UTC |
| 2015-02-18 00:12:00 +0000 UTC | 2015-02-18 00:12:00 +0000 UTC |
| 2017-07-19 03:21:51+00:00 | 2017-07-19 03:21:51 +0000 UTC |
Doc cleanup
2017-07-18 12:06:57 +08:00
| 2014-04-26 | 2014-04-26 00:00:00 +0000 UTC |
| 2014-04 | 2014-04-01 00:00:00 +0000 UTC |
| 2014 | 2014-01-01 00:00:00 +0000 UTC |
| 2014-05-11 08:20:13,787 | 2014-05-11 08:20:13.787 +0000 UTC |
mm.dd.yyyy format closes #34 (pr #35)
2018-01-12 05:21:04 +08:00
| 3.31.2014 | 2014-03-31 00:00:00 +0000 UTC |
| 03.31.2014 | 2014-03-31 00:00:00 +0000 UTC |
| 08.21.71 | 1971-08-21 00:00:00 +0000 UTC |
Doc cleanup
2017-07-18 12:06:57 +08:00
| 20140601 | 2014-06-01 00:00:00 +0000 UTC |
| 1332151919 | 2012-03-19 10:11:59 +0000 UTC |
| 1384216367189 | 2013-11-12 00:32:47.189 +0000 UTC |
+-------------------------------------------------------+----------------------------------------+
new date format for 2013-Feb-03
2017-07-27 07:55:21 +08:00
*/
```
Reference in New Issue Copy Permalink