DATEPARSE(1)

🎀 NAME 🎀

okay bestie, meet dateparse — it's literally a frontend to DateTime::Format::Natural 💖 like, it's the glow-up little wrapper that takes your messy lil human date strings and makes them make sense.

---

✨ SYNOPSIS ✨

the whole vibe, exactly as it comes:

Usage: dateparse [switches]
  -d, --datetime=<string>     datetime string *
  -e, --extract               extract expressions
  -f, --format=<format>       format of numeric dates
  -h, --help                  this help screen
  -l, --lang=<code>           language code
  -p, --prefer_future         prefer future dates
  -P, --demand_future         demand future dates
  -s, --supported             list of supported languages
  -t, --time_zone=<string>    time zone string
  -T, --trace                 print trace after processing
  -V, --version               print version

and now the switches one by one, no skips, no cap 👑

• -d, --datetime=<string> — the actual datetime string you're feeding in. this is the one with the little asterisk next to it, so yes, it matters 🌟
• -e, --extract — pulls out the expressions. extraction mode, slay 🧚
• -f, --format=<format> — tells it what format your numeric dates are in 🔢
• -h, --help — the help screen, aka your bestie when you're lost 🫶
• -l, --lang=<code> — sets the language code, so it can read your dates in your language 🌈
• -p, --prefer_future — when it's ambiguous, it'll prefer future dates. gentle suggestion energy 💅
• -P, --demand_future — and this one demands future dates. uppercase P for uppercase personality, it's giving firm 👑
• -s, --supported — prints the list of supported languages 📋
• -t, --time_zone=<string> — the time zone string, for when you're not in the default timeline 🕰️
• -T, --trace — prints a trace after processing, so you can see the whole journey 🔍
• -V, --version — prints the version, iconic ⭐

⚠️ okay so the asterisk footnote, listen up bestie: the date must conform to YYYY-MM-DD and the time to hh:mm:ss(.ms). no freestyling. and valid datetime strings consist of either date, date/time or time. that's the whole menu, periodt 💀

---

🌸 AUTHOR 🌸

Steven Schubiger <schubiger@cpan.org> — the icon who made this happen 💜

---

🦋 LICENSE 🦋

this program is free software; you may redistribute it and/or modify it under the same terms as Perl itself. fr fr, go wild 🎀

See <http://dev.perl.org/licenses/>

---

and that's the whole page, bestie 💖 this was perl v5.42.0, dated 2026-02-16, and it lives in the User Contributed Perl Documentation section as DATEPARSE(1). go forth and parse those dates, main character 🌟