DateTi...teParse(3pm)

💅 NAME 💅

DateTime::Format::DateParse — the module that parses Date::Parse-compatible formats, no cap. Fr fr it's a compatibility wrapper, and it lives over in the User Contributed Perl Documentation corner of the man pages 🎀

---

✨ SYNOPSIS ✨

use DateTime::Format::DateParse;

my $dt = DateTime::Format::DateParse->parse_datetime( $date );
my $dt = DateTime::Format::DateParse->parse_datetime( $date, $zone );

That's literally it. Two lines of code and you're slaying 🦋

---

🌸 DESCRIPTION 🌸

So basically: this module is a compatibility wrapper around Date::Parse. That's the whole vibe. It doesn't reinvent anything, it just makes Date::Parse play nicely with DateTime, and honestly? Iconic behaviour 🫶

---

🎀 USAGE 🎀

💖 Import Parameters 💖

This module accepts no arguments at all to its import method, and it exports zero symbols. Nothing. Nada. So don't come at it with a big import list, she's not that kind of girl 🙈

💜 Methods 💜

👑 Class Methods 👑

• parse_datetime($date [, $zone]) — takes a Date::Parse-compatible $date string, and optionally a Time::Zone-compatible $zone string. It hands you back a DateTime object. That's the whole deal, and it eats every time 💅

---

💀 GOTCHAS 💀

Bestie, read these. They will absolutely catch you out if you skip them 😭

• If parse_datetime gets called on a $date that doesn't specify a timezone and $zone is not set, then the timezone of the returned DateTime object gets set to the local timezone. This is consistent with the behaviour of Date::Parse — so it's not a bug, it's a vibe match 🧚
• If parse_datetime is called without a $zone but the $date string does specify a timezone/offset — or if parse_datetime is called with a $zone that DateTime::TimeZone does not understand — then the returned DateTime object will have its timezone set to a fixed offset from UTC. Which means: no DST information is available, and date math will not reflect DST transitions. Lowkey a big deal for date math, ngl. This may be resolved for true timezones by using the DateTime::TimeZone::Alias module to "alias" the Time::Zone timezone to an Olson DB name. And this may be done automatically in a future release ✨

---

🌈 CREDITS 🌈

• Graham Barr (GBARR) <gbarr@pobox.com> — author of Date::Parse 👑
• Everyone at the DateTime "Asylum" 🫶

---

📬 SUPPORT 📬

Support for this module is provided via the <datetime@perl.org> email list. See <http://lists.perl.org/> for more details 💌

---

🦋 AUTHOR 🦋

Joshua Hoblitt (JHOBLITT) <jhoblitt@cpan.org>

---

⭐ COPYRIGHT ⭐

Copyright (c) 2005-6 Joshua Hoblitt. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the licenses can be found in the LICENSE file included with this module, or in perlartistic and perlgpl as supplied with Perl 5.8.1 and later 💜

---

🌸 SEE ALSO 🌸

Date::Parse, Time::Zone, DateTime, DateTime::TimeZone, DateTime::TimeZone::Alias, <http://datetime.perl.org/>

---

And that's the whole page, bestie! This one's brought to you by perl v5.42.0, dated 2011-12-14 — a lil vintage, but she still slays ✨💖 Go parse something cute 🎀