All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Reorder structs to save memory using betteralign
0.9.0 - 2026-04-28
Initial public pre-release. The library API is considered stable; documentation and internal review are still in progress ahead of v1.0.0.
Parsertype withParseandParseIntervalmethods for converting natural-language date/time strings intotime.Timevalues and[start, end)calendar intervals.- Zero-dependency implementation using only the Go standard library (no regular expressions, no parser generators).
- Configurable
Parserfields:Lang,Location,Now, andDateOrder. The zero value is valid and defaults to English,time.Local, andtime.Now. Parseris safe for concurrent use.- Language support for English, Spanish, French, German, Italian,
Portuguese, Russian, Japanese, and Chinese, exposed as
LangEn,LangEs,LangFr,LangDe,LangIt,LangPt,LangRu,LangJa, andLangZh. - Package-level language lookup helpers in
lookup.go. - Absolute date formats: ISO 8601, alternative separators
(
/,.), month-name forms, and locale-sensitiveMM/DD/YYYY/DD/MM/YYYYparsing viaDateOrder. - Relative expressions such as
next Monday,in 3 days,3 days ago,this week, andlast month. cmd/nldateCLI for ad-hoc parsing and debugging (go run ./cmd/nldate "next Monday").- Benchmarks (
bench_test.go) and a fuzz/test suite with >95% coverage. - Package documentation in
doc.goand contributor docs underdocs/.