A natural language date/time parser with pluggable rules
A natural language date/time parser with pluggable rules
whenis a natural language date/time parser with pluggable rules and merge strategies
Check EN rules and tests of them, for more examples.
Needed rule not found? Open an issue with the case and it will be added asap.
Usually, there are several rules added to the parser's instance for checking. Each rule has its own borders - length and offset in provided string. Meanwhile, each rule yields only the first match over the string. So, the library checks all the rules and extracts a cluster of matched rules which have distance between each other less or equal to options.Distance, which is 5 by default. For example:
on next wednesday at 2:25 p.m.
└──────┬─────┘ └───┬───┘
weekday hour + minuteSo, we have a cluster of matched rules - "next wednesday at 2:25 p.m." in the string representation.
After that, each rule is applied to the context. In order of definition or in match order, if options.MatchByOrder is set to true(which it is by default). Each rule could be applied with given merge strategy. By default, it's an Override strategy. The other strategies are not implemented yet in the rules. Pull requests are welcome.
The project follows the official release workflow. It is recommended to refer to this resource for detailed information on the process.
To install the latest version:
$ go get github.com/olebedev/when@latestw := when.New(nil)
w.Add(en.All...)
w.Add(common.All...)
text := "drop me a line in next wednesday at 2:25 p.m"
r, err := w.Parse(text, time.Now())
if err != nil {
// an error has occurred
}
if r == nil {
// no matches found
}
fmt.Println(
"the time",
r.Time.String(),
"mentioned in",
text[r.Index:r.Index+len(r.Text)],
)…The project is in a more-or-less complete state. It's used for one project already. Bugs will be fixed as soon as they will be found.
No open issues yet, or sync has not completed.