NAME
Calendar::DatesRoles::ReturnDateTimeObjects - Return DateTime objects in get_entries()
VERSION
This document describes version 0.002 of Calendar::DatesRoles::ReturnDateTimeObjects (from Perl distribution Calendar-DatesRoles-ReturnDateTimeObjects), released on 2020-02-17.
SYNOPSIS
# apply the role to a Calendar::Dates::* class
use Calendar::Dates::ID::Holiday;
use Role::Tiny;
Role::Tiny->apply_roles_to_package(
'Calendar::Dates::ID::Holiday',
'Calendar::DatesRoles::ReturnDateTimeObjects');
# use the Calendar::Dates::* module as usual
my $entries = Calendar::Dates::ID::Holiday->get_entries(2020);
# now the 'date' field in each entry in $entries are DateTime objects instead
# of 'YYYY-MM-DD' strings.DESCRIPTION
This is a convenience role to make get_entries() return DateTime objects instead of 'YYYY-MM-DD' or 'YYYY-MM-DDTHH:MM' or 'YYYY-MM-DDTHH:MM/HH:MM' or strings.
If string is in the form of 'YYYY-MM-DDTHH:MM/HH:MM' (same-day interval) then get_entries() will return 'date' field (the interval start) and 'date_end' field (the interval end).
HOMEPAGE
Please visit the project's homepage at https://metacpan.org/release/Calendar-DatesRoles-ReturnDateTimeObjects.
SOURCE
Source repository is at https://github.com/perlancar/perl-Calendar-DatesRoles-ReturnDateTimeObjects.
BUGS
Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Calendar-DatesRoles-ReturnDateTimeObjects
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
SEE ALSO
Calendar::DatesRoles::ReturnTimeMomentObjects
AUTHOR
perlancar <perlancar@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2020 by perlancar@cpan.org.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.