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.

cpanm Calendar::Dates::Perl

perl -MCPAN -e shell
install Calendar::Dates::Perl