MooseX...ateTime(3pm)

💖 MooseX::Types::DateTime 💖

okay so bestie, this is the MooseX::Types::DateTime page — (3pm) energy, straight outta the User Contributed Perl Documentation section. Pull up a chair, we're doing DateTime types together 🫶

---

✨ NAME ✨

MooseX::Types::DateTime — DateTime related constraints and coercions for Moose. that's it, that's the whole vibe 💅

---

🌈 VERSION 🌈

version 0.14 — yeah she's on 0.14, and she's iconic for it ✨

---

🎀 SYNOPSIS 🎀

Export Example — when you just wanna pull the type in by name:

use MooseX::Types::DateTime qw(TimeZone);

has time_zone => (
    isa => TimeZone,
    is => "rw",
    coerce => 1,
);

Class->new( time_zone => "Africa/Timbuktu" );

like, that's literally it. Africa/Timbuktu goes in, a whole time zone comes out. no cap 🦋

---

🧚 DESCRIPTION 🧚

So the tea is: this module packages several Moose::Util::TypeConstraints with coercions, and the whole point of them is to play nice with the DateTime suite of objects. that's the main character premise, periodt.

Namespaced Example — same idea, but you're not exporting anything and you just write the class name out in full:

use MooseX::Types::DateTime;

has time_zone => (
    isa => 'DateTime::TimeZone',
    is => "rw",
    coerce => 1,
);

Class->new( time_zone => "Africa/Timbuktu" );

see how it just slaps? both ways work, pick your fighter 💖

---

👑 CONSTRAINTS 👑

literally the whole point of this page, bestie. this is where the type constraints live.

💜 DateTime

A class type for DateTime.

• from Num — Uses from_epoch in DateTime. Floating values will be used for sub-second precision, see DateTime for details. yes, you read that right, floats are getting you sub-second precision, she's fancy like that ⭐
• from HashRef — Calls new in DateTime with the hash entries as arguments. cute, direct, no notes.

---

🍓 Duration

A class type for DateTime::Duration.

• from Num — Uses new in DateTime::Duration and passes the number as the seconds argument.

😭 okay listen up because this one bites people: due to leap seconds, DST changes etc this may not do what you expect. For instance passing in 86400 is not always equivalent to one day, although there are that many seconds in a day. See "How Date Math is Done" in DateTime for more details. fr fr, don't get got by the clocks, they're lowkey shady.

• from HashRef — Calls new in DateTime::Duration with the hash entries as arguments. this one's the safe cozy path 💅

---

🌸 DateTime::Locale

A class type for DateTime::Locale::root with the name DateTime::Locale.

• from Str — The string is treated as a language tag (e.g. "en" or "he_IL") and given to load in DateTime::Locale. it's giving very international of you ✈️
• from Locale::Maktext — The Locale::Maketext/language_tag attribute will be used with load in DateTime::Locale. (yes bestie, that spelling is exactly what the docs say, we do not fix, we report 🫡)

---

🦋 DateTime::TimeZone

A class type for DateTime::TimeZone.

• from Str — Treated as a time zone name or offset. See "USAGE" in DateTime::TimeZone for more details on the allowed values.

Delegates to new in DateTime::TimeZone with the string as the name argument.

so "Africa/Timbuktu" comes in as a string and gets handed straight to new as name. delegated, done, slayed 👑

---

💌 SEE ALSO 💌

go read these too, they're the friends of the family:

• MooseX::Types::DateTime::MoreCoercions
• DateTime, DateTimeX::Easy

---

🫶 GIVING THANKS 🫶

If you found this module to be useful, please show your appreciation by:

• adding a +1 in MetaCPAN at https://metacpan.org/dist/MooseX-Types-DateTime
• and a star in GitHub at https://github.com/moose/MooseX-Types-DateTime

seriously, a lil +1 and a star? that's it. that's the whole ask. it fuels us 🥹✨

---

💬 SUPPORT 💬

Bugs may be submitted through the RT bug tracker at https://rt.cpan.org/Public/Dist/Display.html?Name=MooseX-Types-DateTime (or bug-MooseX-Types-DateTime@rt.cpan.org).

There is also a mailing list available for users of this distribution, at http://lists.perl.org/list/moose.html.

There is also an irc channel available for users of this distribution, at #moose on irc.perl.org (irc://irc.perl.org/#moose).

come say hi in #moose, the group chat is always open 🫶

---

🧚 AUTHOR 🧚

יובל קוג'מן (Yuval Kogman) nothingmuch@woobling.org

---

⭐ CONTRIBUTORS ⭐

• Karen Etheridge ether@cpan.org
• Dagfinn Ilmari Mannsåker ilmari@ilmari.org
• Florian Ragwitz rafl@debian.org
• John Napiorkowski jjnapiork@cpan.org
• Dave Rolsky autarch@urth.org
• Shawn M Moore sartak@gmail.com

these are the icons who helped build the house, show respect 💅

---

📜 COPYRIGHT AND LICENCE 📜

This software is copyright (c) 2008 by יובל קוג'מן (Yuval Kogman).

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

---

and that's the page bestie 🎀 generated for perl v5.40.1, dated 2026-01-18, under the MooseX...ateTime(3pm) manual name — go forth, coerce some time zones, and remember: floats for sub-second precision, and 86400 seconds is not always a day. 🌈💖✨