CGI::U...::date(3pm)

✨ CGI::Untaint::date ✨

okay bestie, so this is the manual page for CGI::Untaint::date, from the User Contributed Perl Documentation collection. she validates dates. that's it. that's the whole vibe. 💅

---

🌸 NAME 🌸

CGI::Untaint::date — validate a date 🗓️✨

---

🦋 SYNOPSIS 🦋

use CGI::Untaint;
my $handler = CGI::Untaint->new($q->Vars);

my $date = $handler->extract(-as_date => 'date');

literally that's all you gotta do, no cap. 🫶

---

🎀 DESCRIPTION 🎀

💖 is_valid

so this Input Handler checks that it's dealing with a reasonable date. and "reasonable" here means anything that Date::Manip thinks is sensible — so basically you can throw any of these at it (for example):

"December 12, 2001"
"12th December, 2001"
"2001-12-12"
"next Tuesday"
"third Wednesday in March"

the way it just accepts "next Tuesday"?? iconic. 😭👑

if you wanna know way more about which date formats are acceptable, go read Date::Manip — she has the whole lore.

and the resulting date? it'll be a Date::Simple object. Date::Simple for more info on that. ✨

🌈 date_format

by default, ambiguous dates like 08/09/2001 get treated as UK style — so that's the 8th of September, not the 9th of August. 🇬🇧

if you wanna change that, subclass it and override date_format(). easy peasy. 🍓

---

👑 WARNING 👑

Date::Manip does NOT play nicely with taint mode. 💀

to work around this, we locally clobber Date::Manip's 'timezone' code. since we're only interested in dates and not times, this shouldn't be much of an issue. but if it is an issue for you, then please let me know! 🙈

---

🧚 SEE ALSO 🧚

Date::Simple. Date::Manip.

---

⭐ AUTHOR ⭐

Tony Bowden

---

💜 BUGS and QUERIES 💜

please direct all correspondence regarding this module to:

bug-CGI-Untaint-date@rt.cpan.org

---

🎀 COPYRIGHT and LICENSE 🎀

Copyright (C) 2001-2005 Tony Bowden. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

and that's the whole page, bestie 🫶 this one came from perl v5.34.0, dated 2022-06-10, and it's filed under CGI::U...::date(3pm). slay, go validate some dates 💖✨🌸