From Code to Community: Sponsoring The Perl and Raku Conference 2025 Learn more

=pod
=encoding utf-8
=head1 PURPOSE
This example expands upon the Example::Types library defined in
L<Type::Tiny::Manual::Libraries>. It defines class types for L<DateTime>
and L<DateTime::Duration> and some structured types for hashes that
can be used to instantiate DateTime objects. It defines some coercions
for the C<Datetime> class type.
A simple L<Moose> class is provided using some of these types and
coercions. The class also defines a couple of extra coercions inline.
See the source code of this file for the actual example code.
=head1 DEPENDENCIES
L<Moose>, L<DateTime>.
=head1 AUTHOR
Toby Inkster E<lt>tobyink@cpan.orgE<gt>.
=head1 COPYRIGHT AND LICENCE
This software is copyright (c) 2013-2024 by Toby Inkster.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut
use strict;
use lib "lib", "../lib";
BEGIN {
package Example::Types;
-base,
-declare => qw( Datetime DatetimeHash Duration EpochHash );
use Types::Standard -types;
require DateTime;
class_type Datetime, { class => "DateTime" };
class_type Duration, { class => "DateTime::Duration" };
declare DatetimeHash,
as Dict[
year => Int,
month => Optional[ Int ],
day => Optional[ Int ],
hour => Optional[ Int ],
minute => Optional[ Int ],
second => Optional[ Int ],
nanosecond => Optional[ Int ],
time_zone => Optional[ Str ],
];
declare EpochHash,
as Dict[
epoch => Int,
time_zone => Optional[ Str ],
];
coerce Datetime,
from Int, via { "DateTime"->from_epoch(epoch => $_) },
from Undef, via { "DateTime"->now },
from DatetimeHash, via { "DateTime"->new(%$_) },
from EpochHash, via { "DateTime"->from_epoch(%$_) };
$INC{"Example/Types.pm"} = __FILE__;
};
BEGIN {
package Person;
use Moose;
use Types::Standard qw( Str Int Num );
use Example::Types qw( Datetime Duration );
has name => (
is => "ro",
isa => Str,
required => 1,
);
has age => (
is => "ro",
isa => Int->plus_coercions(Num, 'int($_)', Duration, '$_->years'),
coerce => 1,
init_arg => undef,
lazy => 1,
builder => "_build_age",
);
has date_of_birth => (
is => "ro",
isa => Datetime,
coerce => 1,
required => 1,
);
sub _build_age
{
my $self = shift;
return Datetime->class->now - $self->date_of_birth;
}
};
my $me = Person->new(
name => "Toby Inkster",
date_of_birth => { epoch => 328646500, time_zone => "Asia/Tokyo" },
);
printf("%s is %d years old.\n", $me->name, $me->age);