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 <[email protected]>

COPYRIGHT AND LICENSE
   This software is copyright (c) 2019 by [email protected].

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