{"id":13412449,"url":"https://github.com/araddon/dateparse","last_synced_at":"2025-05-13T19:03:02.831Z","repository":{"id":16232717,"uuid":"18980240","full_name":"araddon/dateparse","owner":"araddon","description":"GoLang Parse many date strings without knowing format in advance.","archived":false,"fork":false,"pushed_at":"2023-12-30T19:10:51.000Z","size":474,"stargazers_count":2077,"open_issues_count":64,"forks_count":172,"subscribers_count":22,"default_branch":"master","last_synced_at":"2025-04-27T08:37:33.033Z","etag":null,"topics":["date","dates","datetime","golang","time"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/araddon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2014-04-21T02:55:48.000Z","updated_at":"2025-04-25T15:13:55.000Z","dependencies_parsed_at":"2024-01-30T04:54:15.947Z","dependency_job_id":null,"html_url":"https://github.com/araddon/dateparse","commit_stats":{"total_commits":203,"total_committers":24,"mean_commits":8.458333333333334,"dds":0.6108374384236452,"last_synced_commit":"6b43995a97dee4b2c7fc0bdff8e124da9f31a57e"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/araddon%2Fdateparse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/araddon%2Fdateparse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/araddon%2Fdateparse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/araddon%2Fdateparse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/araddon","download_url":"https://codeload.github.com/araddon/dateparse/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254010792,"owners_count":21998993,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["date","dates","datetime","golang","time"],"created_at":"2024-07-30T20:01:24.788Z","updated_at":"2025-05-13T19:03:02.811Z","avatar_url":"https://github.com/araddon.png","language":"Go","readme":"Go Date Parser \n---------------------------\n\nParse many date strings 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.\n\n\n[![Code Coverage](https://codecov.io/gh/araddon/dateparse/branch/master/graph/badge.svg)](https://codecov.io/gh/araddon/dateparse)\n[![GoDoc](https://godoc.org/github.com/araddon/dateparse?status.svg)](http://godoc.org/github.com/araddon/dateparse)\n[![Build Status](https://travis-ci.org/araddon/dateparse.svg?branch=master)](https://travis-ci.org/araddon/dateparse)\n[![Go ReportCard](https://goreportcard.com/badge/araddon/dateparse)](https://goreportcard.com/report/araddon/dateparse)\n\n**MM/DD/YYYY VS DD/MM/YYYY** Right now this uses mm/dd/yyyy WHEN ambiguous if this is not desired behavior, use `ParseStrict` which will fail on ambiguous date strings.\n\n**Timezones** The location your server is configured affects the results! See example or https://play.golang.org/p/IDHRalIyXh and last paragraph here https://golang.org/pkg/time/#Parse.\n\n\n```go\n\n// Normal parse. Equivalent Timezone rules as time.Parse()\nt, err := dateparse.ParseAny(\"3/1/2014\")\n\n// Parse Strict, error on ambigous mm/dd vs dd/mm dates\nt, err := dateparse.ParseStrict(\"3/1/2014\")\n\u003e returns error \n\n// Return a string that represents the layout to parse the given date-time.\nlayout, err := dateparse.ParseFormat(\"May 8, 2009 5:57:51 PM\")\n\u003e \"Jan 2, 2006 3:04:05 PM\"\n\n```\n\ncli tool for testing dateformats\n----------------------------------\n\n[Date Parse CLI](https://github.com/araddon/dateparse/blob/master/dateparse)\n\n\nExtended example\n-------------------\n\nhttps://github.com/araddon/dateparse/blob/master/example/main.go\n\n```go\npackage main\n\nimport (\n\t\"flag\"\n\t\"fmt\"\n\t\"time\"\n\n\t\"github.com/scylladb/termtables\"\n\t\"github.com/araddon/dateparse\"\n)\n\nvar examples = []string{\n\t\"May 8, 2009 5:57:51 PM\",\n\t\"oct 7, 1970\",\n\t\"oct 7, '70\",\n\t\"oct. 7, 1970\",\n\t\"oct. 7, 70\",\n\t\"Mon Jan 2 15:04:05 2006\",\n\t\"Mon Jan 2 15:04:05 MST 2006\",\n\t\"Mon Jan 02 15:04:05 -0700 2006\",\n\t\"Monday, 02-Jan-06 15:04:05 MST\",\n\t\"Mon, 02 Jan 2006 15:04:05 MST\",\n\t\"Tue, 11 Jul 2017 16:28:13 +0200 (CEST)\",\n\t\"Mon, 02 Jan 2006 15:04:05 -0700\",\n\t\"Mon 30 Sep 2018 09:09:09 PM UTC\",\n\t\"Mon Aug 10 15:44:11 UTC+0100 2015\",\n\t\"Thu, 4 Jan 2018 17:53:36 +0000\",\n\t\"Fri Jul 03 2015 18:04:07 GMT+0100 (GMT Daylight Time)\",\n\t\"Sun, 3 Jan 2021 00:12:23 +0800 (GMT+08:00)\",\n\t\"September 17, 2012 10:09am\",\n\t\"September 17, 2012 at 10:09am PST-08\",\n\t\"September 17, 2012, 10:10:09\",\n\t\"October 7, 1970\",\n\t\"October 7th, 1970\",\n\t\"12 Feb 2006, 19:17\",\n\t\"12 Feb 2006 19:17\",\n\t\"14 May 2019 19:11:40.164\",\n\t\"7 oct 70\",\n\t\"7 oct 1970\",\n\t\"03 February 2013\",\n\t\"1 July 2013\",\n\t\"2013-Feb-03\",\n\t// dd/Mon/yyy alpha Months\n\t\"06/Jan/2008:15:04:05 -0700\",\n\t\"06/Jan/2008 15:04:05 -0700\",\n\t// mm/dd/yy\n\t\"3/31/2014\",\n\t\"03/31/2014\",\n\t\"08/21/71\",\n\t\"8/1/71\",\n\t\"4/8/2014 22:05\",\n\t\"04/08/2014 22:05\",\n\t\"4/8/14 22:05\",\n\t\"04/2/2014 03:00:51\",\n\t\"8/8/1965 12:00:00 AM\",\n\t\"8/8/1965 01:00:01 PM\",\n\t\"8/8/1965 01:00 PM\",\n\t\"8/8/1965 1:00 PM\",\n\t\"8/8/1965 12:00 AM\",\n\t\"4/02/2014 03:00:51\",\n\t\"03/19/2012 10:11:59\",\n\t\"03/19/2012 10:11:59.3186369\",\n\t// yyyy/mm/dd\n\t\"2014/3/31\",\n\t\"2014/03/31\",\n\t\"2014/4/8 22:05\",\n\t\"2014/04/08 22:05\",\n\t\"2014/04/2 03:00:51\",\n\t\"2014/4/02 03:00:51\",\n\t\"2012/03/19 10:11:59\",\n\t\"2012/03/19 10:11:59.3186369\",\n\t// yyyy:mm:dd\n\t\"2014:3:31\",\n\t\"2014:03:31\",\n\t\"2014:4:8 22:05\",\n\t\"2014:04:08 22:05\",\n\t\"2014:04:2 03:00:51\",\n\t\"2014:4:02 03:00:51\",\n\t\"2012:03:19 10:11:59\",\n\t\"2012:03:19 10:11:59.3186369\",\n\t// Chinese\n\t\"2014年04月08日\",\n\t// yyyy-mm-ddThh\n\t\"2006-01-02T15:04:05+0000\",\n\t\"2009-08-12T22:15:09-07:00\",\n\t\"2009-08-12T22:15:09\",\n\t\"2009-08-12T22:15:09.988\",\n\t\"2009-08-12T22:15:09Z\",\n\t\"2017-07-19T03:21:51:897+0100\",\n\t\"2019-05-29T08:41-04\", // no seconds, 2 digit TZ offset\n\t// yyyy-mm-dd hh:mm:ss\n\t\"2014-04-26 17:24:37.3186369\",\n\t\"2012-08-03 18:31:59.257000000\",\n\t\"2014-04-26 17:24:37.123\",\n\t\"2013-04-01 22:43\",\n\t\"2013-04-01 22:43:22\",\n\t\"2014-12-16 06:20:00 UTC\",\n\t\"2014-12-16 06:20:00 GMT\",\n\t\"2014-04-26 05:24:37 PM\",\n\t\"2014-04-26 13:13:43 +0800\",\n\t\"2014-04-26 13:13:43 +0800 +08\",\n\t\"2014-04-26 13:13:44 +09:00\",\n\t\"2012-08-03 18:31:59.257000000 +0000 UTC\",\n\t\"2015-09-30 18:48:56.35272715 +0000 UTC\",\n\t\"2015-02-18 00:12:00 +0000 GMT\",\n\t\"2015-02-18 00:12:00 +0000 UTC\",\n\t\"2015-02-08 03:02:00 +0300 MSK m=+0.000000001\",\n\t\"2015-02-08 03:02:00.001 +0300 MSK m=+0.000000001\",\n\t\"2017-07-19 03:21:51+00:00\",\n\t\"2014-04-26\",\n\t\"2014-04\",\n\t\"2014\",\n\t\"2014-05-11 08:20:13,787\",\n\t// yyyy-mm-dd-07:00\n\t\"2020-07-20+08:00\",\n\t// mm.dd.yy\n\t\"3.31.2014\",\n\t\"03.31.2014\",\n\t\"08.21.71\",\n\t\"2014.03\",\n\t\"2014.03.30\",\n\t// yyyymmdd and similar\n\t\"20140601\",\n\t\"20140722105203\",\n\t// yymmdd hh:mm:yy mysql log\n\t// 080313 05:21:55 mysqld started\n\t\"171113 14:14:20\",\n\t// unix seconds, ms, micro, nano\n\t\"1332151919\",\n\t\"1384216367189\",\n\t\"1384216367111222\",\n\t\"1384216367111222333\",\n}\n\nvar (\n\ttimezone = \"\"\n)\n\nfunc main() {\n\tflag.StringVar(\u0026timezone, \"timezone\", \"UTC\", \"Timezone aka `America/Los_Angeles` formatted time-zone\")\n\tflag.Parse()\n\n\tif timezone != \"\" {\n\t\t// NOTE: This is very, very important to understand\n\t\t// time-parsing in go\n\t\tloc, err := time.LoadLocation(timezone)\n\t\tif err != nil {\n\t\t\tpanic(err.Error())\n\t\t}\n\t\ttime.Local = loc\n\t}\n\n\ttable := termtables.CreateTable()\n\n\ttable.AddHeaders(\"Input\", \"Parsed, and Output as %v\")\n\tfor _, dateExample := range examples {\n\t\tt, err := dateparse.ParseLocal(dateExample)\n\t\tif err != nil {\n\t\t\tpanic(err.Error())\n\t\t}\n\t\ttable.AddRow(dateExample, fmt.Sprintf(\"%v\", t))\n\t}\n\tfmt.Println(table.Render())\n}\n\n/*\n+-------------------------------------------------------+-----------------------------------------+\n| Input | Parsed, and Output as %v |\n+-------------------------------------------------------+-----------------------------------------+\n| May 8, 2009 5:57:51 PM | 2009-05-08 17:57:51 +0000 UTC |\n| oct 7, 1970 | 1970-10-07 00:00:00 +0000 UTC |\n| oct 7, '70 | 1970-10-07 00:00:00 +0000 UTC |\n| oct. 7, 1970 | 1970-10-07 00:00:00 +0000 UTC |\n| oct. 7, 70 | 1970-10-07 00:00:00 +0000 UTC |\n| Mon Jan 2 15:04:05 2006 | 2006-01-02 15:04:05 +0000 UTC |\n| Mon Jan 2 15:04:05 MST 2006 | 2006-01-02 15:04:05 +0000 MST |\n| Mon Jan 02 15:04:05 -0700 2006 | 2006-01-02 15:04:05 -0700 -0700 |\n| Monday, 02-Jan-06 15:04:05 MST | 2006-01-02 15:04:05 +0000 MST |\n| Mon, 02 Jan 2006 15:04:05 MST | 2006-01-02 15:04:05 +0000 MST |\n| Tue, 11 Jul 2017 16:28:13 +0200 (CEST) | 2017-07-11 16:28:13 +0200 +0200 |\n| Mon, 02 Jan 2006 15:04:05 -0700 | 2006-01-02 15:04:05 -0700 -0700 |\n| Mon 30 Sep 2018 09:09:09 PM UTC | 2018-09-30 21:09:09 +0000 UTC |\n| Mon Aug 10 15:44:11 UTC+0100 2015 | 2015-08-10 15:44:11 +0000 UTC |\n| Thu, 4 Jan 2018 17:53:36 +0000 | 2018-01-04 17:53:36 +0000 UTC |\n| Fri Jul 03 2015 18:04:07 GMT+0100 (GMT Daylight Time) | 2015-07-03 18:04:07 +0100 GMT |\n| Sun, 3 Jan 2021 00:12:23 +0800 (GMT+08:00) | 2021-01-03 00:12:23 +0800 +0800 |\n| September 17, 2012 10:09am | 2012-09-17 10:09:00 +0000 UTC |\n| September 17, 2012 at 10:09am PST-08 | 2012-09-17 10:09:00 -0800 PST |\n| September 17, 2012, 10:10:09 | 2012-09-17 10:10:09 +0000 UTC |\n| October 7, 1970 | 1970-10-07 00:00:00 +0000 UTC |\n| October 7th, 1970 | 1970-10-07 00:00:00 +0000 UTC |\n| 12 Feb 2006, 19:17 | 2006-02-12 19:17:00 +0000 UTC |\n| 12 Feb 2006 19:17 | 2006-02-12 19:17:00 +0000 UTC |\n| 14 May 2019 19:11:40.164 | 2019-05-14 19:11:40.164 +0000 UTC |\n| 7 oct 70 | 1970-10-07 00:00:00 +0000 UTC |\n| 7 oct 1970 | 1970-10-07 00:00:00 +0000 UTC |\n| 03 February 2013 | 2013-02-03 00:00:00 +0000 UTC |\n| 1 July 2013 | 2013-07-01 00:00:00 +0000 UTC |\n| 2013-Feb-03 | 2013-02-03 00:00:00 +0000 UTC |\n| 06/Jan/2008:15:04:05 -0700 | 2008-01-06 15:04:05 -0700 -0700 |\n| 06/Jan/2008 15:04:05 -0700 | 2008-01-06 15:04:05 -0700 -0700 |\n| 3/31/2014 | 2014-03-31 00:00:00 +0000 UTC |\n| 03/31/2014 | 2014-03-31 00:00:00 +0000 UTC |\n| 08/21/71 | 1971-08-21 00:00:00 +0000 UTC |\n| 8/1/71 | 1971-08-01 00:00:00 +0000 UTC |\n| 4/8/2014 22:05 | 2014-04-08 22:05:00 +0000 UTC |\n| 04/08/2014 22:05 | 2014-04-08 22:05:00 +0000 UTC |\n| 4/8/14 22:05 | 2014-04-08 22:05:00 +0000 UTC |\n| 04/2/2014 03:00:51 | 2014-04-02 03:00:51 +0000 UTC |\n| 8/8/1965 12:00:00 AM | 1965-08-08 00:00:00 +0000 UTC |\n| 8/8/1965 01:00:01 PM | 1965-08-08 13:00:01 +0000 UTC |\n| 8/8/1965 01:00 PM | 1965-08-08 13:00:00 +0000 UTC |\n| 8/8/1965 1:00 PM | 1965-08-08 13:00:00 +0000 UTC |\n| 8/8/1965 12:00 AM | 1965-08-08 00:00:00 +0000 UTC |\n| 4/02/2014 03:00:51 | 2014-04-02 03:00:51 +0000 UTC |\n| 03/19/2012 10:11:59 | 2012-03-19 10:11:59 +0000 UTC |\n| 03/19/2012 10:11:59.3186369 | 2012-03-19 10:11:59.3186369 +0000 UTC |\n| 2014/3/31 | 2014-03-31 00:00:00 +0000 UTC |\n| 2014/03/31 | 2014-03-31 00:00:00 +0000 UTC |\n| 2014/4/8 22:05 | 2014-04-08 22:05:00 +0000 UTC |\n| 2014/04/08 22:05 | 2014-04-08 22:05:00 +0000 UTC |\n| 2014/04/2 03:00:51 | 2014-04-02 03:00:51 +0000 UTC |\n| 2014/4/02 03:00:51 | 2014-04-02 03:00:51 +0000 UTC |\n| 2012/03/19 10:11:59 | 2012-03-19 10:11:59 +0000 UTC |\n| 2012/03/19 10:11:59.3186369 | 2012-03-19 10:11:59.3186369 +0000 UTC |\n| 2014:3:31 | 2014-03-31 00:00:00 +0000 UTC |\n| 2014:03:31 | 2014-03-31 00:00:00 +0000 UTC |\n| 2014:4:8 22:05 | 2014-04-08 22:05:00 +0000 UTC |\n| 2014:04:08 22:05 | 2014-04-08 22:05:00 +0000 UTC |\n| 2014:04:2 03:00:51 | 2014-04-02 03:00:51 +0000 UTC |\n| 2014:4:02 03:00:51 | 2014-04-02 03:00:51 +0000 UTC |\n| 2012:03:19 10:11:59 | 2012-03-19 10:11:59 +0000 UTC |\n| 2012:03:19 10:11:59.3186369 | 2012-03-19 10:11:59.3186369 +0000 UTC |\n| 2014年04月08日 | 2014-04-08 00:00:00 +0000 UTC |\n| 2006-01-02T15:04:05+0000 | 2006-01-02 15:04:05 +0000 UTC |\n| 2009-08-12T22:15:09-07:00 | 2009-08-12 22:15:09 -0700 -0700 |\n| 2009-08-12T22:15:09 | 2009-08-12 22:15:09 +0000 UTC |\n| 2009-08-12T22:15:09.988 | 2009-08-12 22:15:09.988 +0000 UTC |\n| 2009-08-12T22:15:09Z | 2009-08-12 22:15:09 +0000 UTC |\n| 2017-07-19T03:21:51:897+0100 | 2017-07-19 03:21:51.897 +0100 +0100 |\n| 2019-05-29T08:41-04 | 2019-05-29 08:41:00 -0400 -0400 |\n| 2014-04-26 17:24:37.3186369 | 2014-04-26 17:24:37.3186369 +0000 UTC |\n| 2012-08-03 18:31:59.257000000 | 2012-08-03 18:31:59.257 +0000 UTC |\n| 2014-04-26 17:24:37.123 | 2014-04-26 17:24:37.123 +0000 UTC |\n| 2013-04-01 22:43 | 2013-04-01 22:43:00 +0000 UTC |\n| 2013-04-01 22:43:22 | 2013-04-01 22:43:22 +0000 UTC |\n| 2014-12-16 06:20:00 UTC | 2014-12-16 06:20:00 +0000 UTC |\n| 2014-12-16 06:20:00 GMT | 2014-12-16 06:20:00 +0000 UTC |\n| 2014-04-26 05:24:37 PM | 2014-04-26 17:24:37 +0000 UTC |\n| 2014-04-26 13:13:43 +0800 | 2014-04-26 13:13:43 +0800 +0800 |\n| 2014-04-26 13:13:43 +0800 +08 | 2014-04-26 13:13:43 +0800 +0800 |\n| 2014-04-26 13:13:44 +09:00 | 2014-04-26 13:13:44 +0900 +0900 |\n| 2012-08-03 18:31:59.257000000 +0000 UTC | 2012-08-03 18:31:59.257 +0000 UTC |\n| 2015-09-30 18:48:56.35272715 +0000 UTC | 2015-09-30 18:48:56.35272715 +0000 UTC |\n| 2015-02-18 00:12:00 +0000 GMT | 2015-02-18 00:12:00 +0000 UTC |\n| 2015-02-18 00:12:00 +0000 UTC | 2015-02-18 00:12:00 +0000 UTC |\n| 2015-02-08 03:02:00 +0300 MSK m=+0.000000001 | 2015-02-08 03:02:00 +0300 +0300 |\n| 2015-02-08 03:02:00.001 +0300 MSK m=+0.000000001 | 2015-02-08 03:02:00.001 +0300 +0300 |\n| 2017-07-19 03:21:51+00:00 | 2017-07-19 03:21:51 +0000 UTC |\n| 2014-04-26 | 2014-04-26 00:00:00 +0000 UTC |\n| 2014-04 | 2014-04-01 00:00:00 +0000 UTC |\n| 2014 | 2014-01-01 00:00:00 +0000 UTC |\n| 2014-05-11 08:20:13,787 | 2014-05-11 08:20:13.787 +0000 UTC |\n| 2020-07-20+08:00 | 2020-07-20 00:00:00 +0800 +0800 |\n| 3.31.2014 | 2014-03-31 00:00:00 +0000 UTC |\n| 03.31.2014 | 2014-03-31 00:00:00 +0000 UTC |\n| 08.21.71 | 1971-08-21 00:00:00 +0000 UTC |\n| 2014.03 | 2014-03-01 00:00:00 +0000 UTC |\n| 2014.03.30 | 2014-03-30 00:00:00 +0000 UTC |\n| 20140601 | 2014-06-01 00:00:00 +0000 UTC |\n| 20140722105203 | 2014-07-22 10:52:03 +0000 UTC |\n| 171113 14:14:20 | 2017-11-13 14:14:20 +0000 UTC |\n| 1332151919 | 2012-03-19 10:11:59 +0000 UTC |\n| 1384216367189 | 2013-11-12 00:32:47.189 +0000 UTC |\n| 1384216367111222 | 2013-11-12 00:32:47.111222 +0000 UTC |\n| 1384216367111222333 | 2013-11-12 00:32:47.111222333 +0000 UTC |\n+-------------------------------------------------------+-----------------------------------------+\n*/\n\n```\n","funding_links":[],"categories":["开源类库","Misc","Date and Time","Go","Miscellaneous","Open source library","日期和时间`用于处理日期和时间的库`","\u003cspan id=\"日期和时间-date-and-time\"\u003e日期和时间 Date and Time\u003c/span\u003e","日期和时间","Relational Databases"],"sub_categories":["日期时间","Search and Analytic Databases","Advanced Console UIs","Appointment Time","SQL 查询语句构建库","\u003cspan id=\"高级控制台用户界面-advanced-console-uis\"\u003e高级控制台用户界面 Advanced Console UIs\u003c/span\u003e","检索及分析资料库"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faraddon%2Fdateparse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faraddon%2Fdateparse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faraddon%2Fdateparse/lists"}