NAME
    Calendar::Dates::ID::Holiday - Indonesian holiday calendar

VERSION
    This document describes version 0.006 of Calendar::Dates::ID::Holiday
    (from Perl distribution Calendar-Dates-ID-Holiday), released on
    2019-02-14.

SYNOPSIS
  Using from Perl
     use Calendar::Dates::ID::Holiday;
     my $min_year = Calendar::Dates::ID::Holiday->get_min_year; # => 2002
     my $max_year = Calendar::Dates::ID::Holiday->get_max_year; # => 2019
     my $entries  = Calendar::Dates::ID::Holiday->get_entries(2019);

    $entries result:

     [
       {
         "date" => "2019-01-01",
         "day" => 1,
         "dow" => 2,
         "is_holiday" => 1,
         "is_joint_leave" => 0,
         "month" => 1,
         "summary" => "New Year",
         "summary.alt.lang.id" => "Tahun Baru",
         "tags" => ["international", "fixed-date"],
         "year" => 2019,
       },
       {
         "date"                => "2019-02-05",
         "day"                 => 5,
         "dow"                 => 2,
         "eng_aliases"         => [],
         "ind_aliases"         => [],
         "is_holiday"          => 1,
         "is_joint_leave"      => 0,
         "month"               => 2,
         "summary"             => "Chinese New Year 2570",
         "summary.alt.lang.id" => "Tahun Baru Imlek 2570",
         "tags"                => ["international", "calendar=lunar"],
         "year"                => 2019,
       },
       {
         "date" => "2019-03-07",
         "day" => 7,
         "description" => "Also known as Bali New Year, Bali Day Of Silence",
         "description.alt.lang.id" => "Juga dikenal dengan Tahun Baru Saka",
         "dow" => 4,
         "is_holiday" => 1,
         "is_joint_leave" => 0,
         "month" => 3,
         "summary" => "Nyepi 1941",
         "summary.alt.lang.id" => "Nyepi 1941",
         "tags" => ["religious", "religion=hinduism", "calendar=saka"],
         "year" => 2019,
       },
       {
         "date"                => "2019-04-03",
         "day"                 => 3,
         "dow"                 => 3,
         "eng_aliases"         => [],
         "ind_aliases"         => [],
         "is_holiday"          => 1,
         "is_joint_leave"      => 0,
         "month"               => 4,
         "summary"             => "Isra And Miraj",
         "summary.alt.lang.id" => "Isra Miraj",
         "tags"                => ["religious", "religion=islam", "calendar=lunar"],
         "year"                => 2019,
       },
       {
         "date" => "2019-04-19",
         "day" => 19,
         "description.alt.lang.id" => "Juga dikenal dengan Wafat Isa Al-Masih",
         "dow" => 5,
         "eng_aliases" => [],
         "is_holiday" => 1,
         "is_joint_leave" => 0,
         "month" => 4,
         "summary" => "Good Friday",
         "summary.alt.lang.id" => "Jum'at Agung",
         "tags" => ["religious", "religion=christianity"],
         "year" => 2019,
       },
       {
         "date"                => "2019-05-01",
         "day"                 => 1,
         "decree_date"         => "2013-04-29",
         "decree_note"         => "Labor day becomes national holiday since 2014, decreed by president",
         "dow"                 => 3,
         "is_holiday"          => 1,
         "is_joint_leave"      => 0,
         "month"               => 5,
         "summary"             => "Labor Day",
         "summary.alt.lang.id" => "Hari Buruh",
         "tags"                => ["international", "fixed-date"],
         "year"                => 2019,
         "year_start"          => 2014,
       },
       {
         "date"                => "2019-05-19",
         "day"                 => 19,
         "description"         => "Also known as Vesak",
         "dow"                 => 7,
         "ind_aliases"         => [],
         "is_holiday"          => 1,
         "is_joint_leave"      => 0,
         "month"               => 5,
         "summary"             => "Vesakha 2563",
         "summary.alt.lang.id" => "Waisyak 2563",
         "tags"                => ["religious", "religion=buddhism"],
         "year"                => 2019,
       },
       {
         "date"                => "2019-05-30",
         "day"                 => 30,
         "dow"                 => 4,
         "eng_aliases"         => [],
         "ind_aliases"         => [],
         "is_holiday"          => 1,
         "is_joint_leave"      => 0,
         "month"               => 5,
         "summary"             => "Ascension Day",
         "summary.alt.lang.id" => "Kenaikan Isa Al-Masih",
         "tags"                => ["religious", "religion=christianity"],
         "year"                => 2019,
       },
       {
         "date"                => "2019-06-01",
         "day"                 => 1,
         "decree_date"         => "2016-06-01",
         "decree_note"         => "Pancasila day becomes national holiday since 2017, decreed by president (Keppres 24/2016)",
         "dow"                 => 6,
         "is_holiday"          => 1,
         "is_joint_leave"      => 0,
         "month"               => 6,
         "summary"             => "Pancasila Day",
         "summary.alt.lang.id" => "Hari Lahir Pancasila",
         "tags"                => ["national", "fixed-date"],
         "year"                => 2019,
         "year_start"          => 2017,
       },
       {
         "date"                => "2019-06-03",
         "day"                 => 3,
         "dow"                 => 1,
         "eng_aliases"         => [],
         "ind_aliases"         => [],
         "is_holiday"          => 0,
         "is_joint_leave"      => 1,
         "month"               => 6,
         "summary"             => "Joint Leave (Eid Ul-Fitr 1440H, Day 1)",
         "summary.alt.lang.id" => "Cuti Bersama (Idul Fitri 1440H, Hari 1)",
         "tags"                => [],
         "year"                => 2019,
       },
       {
         "date"                => "2019-06-04",
         "day"                 => 4,
         "dow"                 => 2,
         "eng_aliases"         => [],
         "ind_aliases"         => [],
         "is_holiday"          => 0,
         "is_joint_leave"      => 1,
         "month"               => 6,
         "summary"             => "Joint Leave (Eid Ul-Fitr 1440H, Day 1)",
         "summary.alt.lang.id" => "Cuti Bersama (Idul Fitri 1440H, Hari 1)",
         "tags"                => [],
         "year"                => 2019,
       },
       {
         "date" => "2019-06-05",
         "day" => 5,
         "description.alt.lang.id" => "Juga dikenal dengan Lebaran",
         "dow" => 3,
         "eng_aliases" => [],
         "is_holiday" => 1,
         "is_joint_leave" => 0,
         "month" => 6,
         "summary" => "Eid Ul-Fitr 1440H, Day 1",
         "summary.alt.lang.id" => "Idul Fitri 1440H, Hari 1",
         "tags" => ["religious", "religion=islam", "calendar=lunar"],
         "year" => 2019,
       },
       {
         "date" => "2019-06-06",
         "day" => 6,
         "description.alt.lang.id" => "Juga dikenal dengan Lebaran",
         "dow" => 4,
         "eng_aliases" => [],
         "is_holiday" => 1,
         "is_joint_leave" => 0,
         "month" => 6,
         "summary" => "Eid Ul-Fitr 1439H, Day 2",
         "summary.alt.lang.id" => "Idul Fitri 1439H, Hari 2",
         "tags" => ["religious", "religion=islam", "calendar=lunar"],
         "year" => 2019,
       },
       {
         "date"                => "2019-06-07",
         "day"                 => 7,
         "dow"                 => 5,
         "eng_aliases"         => [],
         "ind_aliases"         => [],
         "is_holiday"          => 0,
         "is_joint_leave"      => 1,
         "month"               => 6,
         "summary"             => "Joint Leave (Eid Ul-Fitr 1440H, Day 1)",
         "summary.alt.lang.id" => "Cuti Bersama (Idul Fitri 1440H, Hari 1)",
         "tags"                => [],
         "year"                => 2019,
       },
       {
         "date" => "2019-08-11",
         "day" => 11,
         "description.alt.lang.id" => "Juga dikenal dengan Idul Kurban",
         "dow" => 7,
         "eng_aliases" => [],
         "is_holiday" => 1,
         "is_joint_leave" => 0,
         "month" => 8,
         "summary" => "Eid Al-Adha",
         "summary.alt.lang.id" => "Idul Adha",
         "tags" => ["religious", "religion=islam", "calendar=lunar"],
         "year" => 2019,
       },
       {
         "date" => "2019-08-17",
         "day" => 17,
         "dow" => 6,
         "is_holiday" => 1,
         "is_joint_leave" => 0,
         "month" => 8,
         "summary" => "Declaration Of Independence",
         "summary.alt.lang.id" => "Proklamasi",
         "tags" => ["national", "fixed-date"],
         "year" => 2019,
       },
       {
         "date" => "2019-09-01",
         "day" => 1,
         "description.alt.lang.id" => "Juga dikenal dengan 1 Muharam",
         "dow" => 7,
         "eng_aliases" => [],
         "is_holiday" => 1,
         "is_joint_leave" => 0,
         "month" => 9,
         "summary" => "Hijra 1441H",
         "summary.alt.lang.id" => "Tahun Baru Hijriyah 1441H",
         "tags" => ["calendar=lunar"],
         "year" => 2019,
       },
       {
         "date" => "2019-11-09",
         "day" => 9,
         "description" => "Also known as Mawlid An-Nabi",
         "description.alt.lang.id" => "Juga dikenal dengan Maulud",
         "dow" => 6,
         "is_holiday" => 1,
         "is_joint_leave" => 0,
         "month" => 11,
         "summary" => "Mawlid",
         "summary.alt.lang.id" => "Maulid Nabi Muhammad",
         "tags" => ["religious", "religion=islam", "calendar=lunar"],
         "year" => 2019,
       },
       {
         "date"                => "2019-12-24",
         "day"                 => 24,
         "dow"                 => 2,
         "eng_aliases"         => [],
         "ind_aliases"         => [],
         "is_holiday"          => 0,
         "is_joint_leave"      => 1,
         "month"               => 12,
         "summary"             => "Joint Leave (Christmas)",
         "summary.alt.lang.id" => "Cuti Bersama (Natal)",
         "tags"                => [],
         "year"                => 2019,
       },
       {
         "date" => "2019-12-25",
         "day" => 25,
         "dow" => 3,
         "is_holiday" => 1,
         "is_joint_leave" => 0,
         "month" => 12,
         "summary" => "Christmas",
         "summary.alt.lang.id" => "Natal",
         "tags" => [
           "international",
           "religious",
           "religion=christianity",
           "fixed-date",
         ],
         "year" => 2019,
       },
     ]

  Using from CLI (requires list-calendar-dates and calx)
     % list-calendar-dates -l -m ID::Holiday
     % calx -c ID::Holiday

DESCRIPTION
    This module provides Indonesian holiday calendar using the
    Calendar::Dates interface.

DATES STATISTICS
     +---------------+-------+
     | key           | value |
     +---------------+-------+
     | Earliest year | 2002  |
     | Latest year   | 2019  |
     +---------------+-------+

DATES SAMPLES
    Entries for year 2018:

     +------------+----------------------------------------+-------------------------------------------------------------+
     | date       | summary                                | tags                                                        |
     +------------+----------------------------------------+-------------------------------------------------------------+
     | 2018-01-01 | New Year                               | international, fixed-date                                   |
     | 2018-02-16 | Chinese New Year 2569                  | international, calendar=lunar                               |
     | 2018-03-17 | Nyepi 1940                             | religious, religion=hinduism, calendar=saka                 |
     | 2018-03-30 | Good Friday                            | religious, religion=christianity                            |
     | 2018-04-14 | Isra And Miraj                         | religious, religion=islam, calendar=lunar                   |
     | 2018-05-01 | Labor Day                              | international, fixed-date                                   |
     | 2018-05-10 | Ascension Day                          | religious, religion=christianity                            |
     | 2018-05-29 | Vesakha 2562                           | religious, religion=buddhism                                |
     | 2018-06-01 | Pancasila Day                          | national, fixed-date                                        |
     | 2018-06-11 | Joint Leave (Eid Ul-Fitr 1439H, Day 1) |                                                             |
     | 2018-06-12 | Joint Leave (Eid Ul-Fitr 1439H, Day 1) |                                                             |
     | 2018-06-13 | Joint Leave (Eid Ul-Fitr 1439H, Day 1) |                                                             |
     | 2018-06-14 | Joint Leave (Eid Ul-Fitr 1439H, Day 1) |                                                             |
     | 2018-06-15 | Eid Ul-Fitr 1439H, Day 1               | religious, religion=islam, calendar=lunar                   |
     | 2018-06-16 | Eid Ul-Fitr 1439H, Day 2               | religious, religion=islam, calendar=lunar                   |
     | 2018-06-18 | Joint Leave (Eid Ul-Fitr 1439H, Day 1) |                                                             |
     | 2018-06-19 | Joint Leave (Eid Ul-Fitr 1439H, Day 1) |                                                             |
     | 2018-06-20 | Joint Leave (Eid Ul-Fitr 1439H, Day 1) |                                                             |
     | 2018-06-27 | Joint Regional Election                | political                                                   |
     | 2018-08-17 | Declaration Of Independence            | national, fixed-date                                        |
     | 2018-08-22 | Eid Al-Adha                            | religious, religion=islam, calendar=lunar                   |
     | 2018-09-11 | Hijra 1440H                            | calendar=lunar                                              |
     | 2018-11-20 | Mawlid                                 | religious, religion=islam, calendar=lunar                   |
     | 2018-12-24 | Joint Leave (Christmas)                |                                                             |
     | 2018-12-25 | Christmas                              | international, religious, religion=christianity, fixed-date |
     +------------+----------------------------------------+-------------------------------------------------------------+

    Entries for year 2019:

     +------------+----------------------------------------+-------------------------------------------------------------+
     | date       | summary                                | tags                                                        |
     +------------+----------------------------------------+-------------------------------------------------------------+
     | 2019-01-01 | New Year                               | international, fixed-date                                   |
     | 2019-02-05 | Chinese New Year 2570                  | international, calendar=lunar                               |
     | 2019-03-07 | Nyepi 1941                             | religious, religion=hinduism, calendar=saka                 |
     | 2019-04-03 | Isra And Miraj                         | religious, religion=islam, calendar=lunar                   |
     | 2019-04-19 | Good Friday                            | religious, religion=christianity                            |
     | 2019-05-01 | Labor Day                              | international, fixed-date                                   |
     | 2019-05-19 | Vesakha 2563                           | religious, religion=buddhism                                |
     | 2019-05-30 | Ascension Day                          | religious, religion=christianity                            |
     | 2019-06-01 | Pancasila Day                          | national, fixed-date                                        |
     | 2019-06-03 | Joint Leave (Eid Ul-Fitr 1440H, Day 1) |                                                             |
     | 2019-06-04 | Joint Leave (Eid Ul-Fitr 1440H, Day 1) |                                                             |
     | 2019-06-05 | Eid Ul-Fitr 1440H, Day 1               | religious, religion=islam, calendar=lunar                   |
     | 2019-06-06 | Eid Ul-Fitr 1439H, Day 2               | religious, religion=islam, calendar=lunar                   |
     | 2019-06-07 | Joint Leave (Eid Ul-Fitr 1440H, Day 1) |                                                             |
     | 2019-08-11 | Eid Al-Adha                            | religious, religion=islam, calendar=lunar                   |
     | 2019-08-17 | Declaration Of Independence            | national, fixed-date                                        |
     | 2019-09-01 | Hijra 1441H                            | calendar=lunar                                              |
     | 2019-11-09 | Mawlid                                 | religious, religion=islam, calendar=lunar                   |
     | 2019-12-24 | Joint Leave (Christmas)                |                                                             |
     | 2019-12-25 | Christmas                              | international, religious, religion=christianity, fixed-date |
     +------------+----------------------------------------+-------------------------------------------------------------+

HOMEPAGE
    Please visit the project's homepage at
    <https://metacpan.org/release/Calendar-Dates-ID-Holiday>.

SOURCE
    Source repository is at
    <https://github.com/perlancar/perl-Calendar-Dates-ID-Holiday>.

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

    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::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.

