NAME

Calendar::Dates::Perl - Dates/anniversaries related to Perl

VERSION

This document describes version 0.001 of Calendar::Dates::Perl (from Perl distribution Calendar-Dates-Perl), released on 2019-06-19.

SYNOPSIS

Using from Perl

 use Calendar::Dates::Perl;
 my $min_year = Calendar::Dates::Perl->get_min_year; # => 1954
 my $max_year = Calendar::Dates::Perl->get_max_year; # => 9999
 my $entries  = Calendar::Dates::Perl->get_entries(2019);

$entries result:

 [
   {
     date      => "2019-09-27",
     day       => 27,
     month     => 9,
     orig_year => 1954,
     summary   => "Larry Wall's birthday (65th anniversary)",
     tags      => ["anniversary"],
     year      => 2019,
   },
   {
     date      => "2019-12-18",
     day       => 18,
     month     => 12,
     orig_year => 1987,
     summary   => "Perl 1.0 released (32nd anniversary)",
     tags      => ["anniversary"],
     year      => 2019,
   },
   {
     date      => "2019-10-17",
     day       => 17,
     month     => 10,
     orig_year => 1994,
     summary   => "Perl 5.0 released (25th anniversary)",
     tags      => ["anniversary"],
     year      => 2019,
   },
 ]

Using from CLI (requires list-calendar-dates and calx)

 % list-calendar-dates -l -m Perl
 % calx -c Perl

DESCRIPTION

DATES STATISTICS

 +---------------+-------+
 | key           | value |
 +---------------+-------+
 | Earliest year | 1954  |
 | Latest year   | 9999  |
 +---------------+-------+

DATES SAMPLES

Entries for year 2018:

 +------------+-----+-------+-----------+------------------------------------------+-------------+------+
 | date       | day | month | orig_year | summary                                  | tags        | year |
 +------------+-----+-------+-----------+------------------------------------------+-------------+------+
 | 2018-09-27 | 27  | 9     | 1954      | Larry Wall's birthday (64th anniversary) | anniversary | 2018 |
 | 2018-12-18 | 18  | 12    | 1987      | Perl 1.0 released (31st anniversary)     | anniversary | 2018 |
 | 2018-10-17 | 17  | 10    | 1994      | Perl 5.0 released (24th anniversary)     | anniversary | 2018 |
 +------------+-----+-------+-----------+------------------------------------------+-------------+------+

Entries for year 2019:

 +------------+-----+-------+-----------+------------------------------------------+-------------+------+
 | date       | day | month | orig_year | summary                                  | tags        | year |
 +------------+-----+-------+-----------+------------------------------------------+-------------+------+
 | 2019-09-27 | 27  | 9     | 1954      | Larry Wall's birthday (65th anniversary) | anniversary | 2019 |
 | 2019-12-18 | 18  | 12    | 1987      | Perl 1.0 released (32nd anniversary)     | anniversary | 2019 |
 | 2019-10-17 | 17  | 10    | 1994      | Perl 5.0 released (25th anniversary)     | anniversary | 2019 |
 +------------+-----+-------+-----------+------------------------------------------+-------------+------+

Entries for year 2020:

 +------------+-----+-------+-----------+------------------------------------------+-------------+------+
 | date       | day | month | orig_year | summary                                  | tags        | year |
 +------------+-----+-------+-----------+------------------------------------------+-------------+------+
 | 2020-09-27 | 27  | 9     | 1954      | Larry Wall's birthday (66th anniversary) | anniversary | 2020 |
 | 2020-12-18 | 18  | 12    | 1987      | Perl 1.0 released (33rd anniversary)     | anniversary | 2020 |
 | 2020-10-17 | 17  | 10    | 1994      | Perl 5.0 released (26th anniversary)     | anniversary | 2020 |
 +------------+-----+-------+-----------+------------------------------------------+-------------+------+

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/Calendar-Dates-Perl.

SOURCE

Source repository is at https://github.com/perlancar/perl-Calendar-Dates-Perl.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Calendar-Dates-Perl

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

perlhist

Calendar::Dates

App::CalendarDatesUtils contains CLIs to list dates from this module, etc.

calx from App::calx can display calendar and highlight dates from Calendar::Dates::* modules

AUTHOR

perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2019 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.