MooseX:...teTimeX(3)

✨ MooseX::Types::DateTimeX ✨

okay bestie, so this is a page from the User Contributed Perl Documentation section of the manual, and it's all about MooseX::Types::DateTimeX 💖 — the type library that's literally just out here giving you DateTime types with extra coercions because we deserve nice things 🎀

---

🌸 NAME 🌸

MooseX::Types::DateTimeX — it's extensions to MooseX::Types::DateTime::ButMaintained, no cap 💅

---

🦋 SYNOPSIS 🦋

okay so here's the whole vibe in code form, look at her:

package MyApp::MyClass;

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

has created => (
    isa => DateTime,
    is => "rw",
    coerce => 1,
);

my $instance = MyApp::MyClass->new(created=>'January 1, 1980');
print $instance->created->year; # is 1980

## Coercions from the base type continue to work as normal.
my $instance = MyApp::MyClass->new(created=>{year=>2000,month=>1,day=>10});

and like, if you want more example usage (and honestly who doesn't 🫶), please see the test case. it's right there. go look. it ate.

---

💜 DESCRIPTION 💜

so this module builds on MooseX::Types::DateTime to add extra custom types and coercions. and because it's building on a type that already exists, all the coercions and constraints are inherited — you get the whole family, not just the new babies. periodt ✨

and yeah, the package name is left as is for legacy reasons 🙈 — this module is really a Type with coercions for DateTimeX::Easy. DateTimeX is just a namespace for the non-core / less-official DateTime modules, iykyk.

---

🌈 SUBTYPES 🌈

this module defines the following additional subtypes, bestie. two of them. both iconic.

⭐ DateTime ⭐

it's a Subtype of DateTime, and the glow-up is that it adds an additional coercion from strings 🎀

it uses DateTimeX::Easy to try and convert strings — like, strings such as "yesterday" — into a valid DateTime object. and here's the thing, lowkey important: because of ambiguity with how different systems might localize their timezone, string parsing may not always return the most expected value. in general it tries to localize to UTC whenever possible. feedback welcomed! 💌

🧚 Duration 🧚

a Subtype of DateTime::Duration that coerces from a string. to attempt this, it uses the module Time::Duration::Parse. slay.

---

💀 CAVEATS 💀

okay so first of all, real talk: this module uses DateTimeX::Easy, which is way more DWIM than any sane person would desire 😭. like, way too much. DateTimeX::Easy works by falling back until something makes sense — and that is variable. not deterministic. variable. 💀

furthermore, all the modules that DateTimeX::Easy can use aren't required for "proper" function of DateTimeX::Easy. so what does this mean? simple: your mileage may vary in your coercions, because DateTimeX::Easy is installation specific. it's giving chaos, honestly. 🫠

---

👑 SEE ALSO 👑

• MooseX::Types::DateTime::ButMaintained — the replacement for this module, with coercions that come with less voodoo 🔮
• DateTimeX::Easy — the backend of this module

---

🍓 AUTHOR 🍓

John Napiorkowski <jjn1056 at yahoo.com>

Broken into a seperate package from MooseX::Types::DateTime by Evan Carroll.

---

📜 LICENSE 📜

Copyright (c) 2008 John Napiorkowski.

This program 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 doc was generated by perl v5.42.0 on 2025-07-25, and it's the MooseX:...teTimeX(3) manual page — thanks for reading, you're the main character, go coerce some dates responsibly 🎀✨💅