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-Holiday

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.