Sebuah library sederhana untuk membantu melakukan pengecekan hari libur di Indonesia.
Library ini merujuk kepada sumber data di https://publicholidays.co.id, akan tetapi tidak ada afiliasi terhadap situs tersebut. Library ini melakukan crawling dan dapat digunakan secara offline apabila data hari libur telah diunduh sebelumnya.
composer require ngekoding/php-hari-libur
<?php
require 'vendor/autoload.php';
use Ngekoding\PhpHariLibur\Holiday;
$holiday = new Holiday('2020');
$date = '2020-01-01';
$isHoliday = $holiday->check($date);
echo $date.': '.$isHoliday; // Output: 2020-01-01: true
new Holiday($year, $local = FALSE, $defaultSunday = TRUE)
Konstruktor Holiday memiliki tiga parameter, $year
digunakan untuk menentukan tahun, $local
digunakan untuk menentukan apakah akan menggunakan sumber data lokal atau tidak, dan terakhir adalah $defaultSunday
untuk menentukan apakah akan menggunakan hari Minggu sebagai default hari libur. Hanya $year
yang wajib untuk diisi.
check($date, $bool = TRUE)
Method yang digunakan untuk mengecekan tanggal yang diberikan apakah merupakan hari libur atau bukan. Kita bisa menentukan apakah akan mengembalikan nilai boolean (TRUE/FALSE) atau object yaitu dengan format seperti berikut:
{
"status": TRUE,
"result": {
"date": "2020-01-01",
"description": "Hari libur awal tahun"
}
}
addDefaultDay($day, $description)
Digunakan untuk menambahkan default hari libur berdasarkan nama hari (format Indonesia). Misalnya membuat default hari libur pada hari Selasa.
addDefaultDate($dateStart, $dateEnd = NULL, $description)
Digunakan untuk menambahkan default hari libur berdasarkan tanggal atau dalam rentang tanggal tertentu (format Y-m-d
). Misalnya membuat default hari libur pada tanggal 2020-01-10.
getHolidays()
Digunakan untuk mendapatkan semua hari libur (libur nasional + default date).
getDefaultDays()
Digunakan untuk mendapatkan semua data hari libur berdasarkan nama hari.
getDefaultDates()
Digunakan untuk mendapatkan semua data hari libur berdasarkan tanggal yang sudah ditentukan sebelumnya.
MIT