https://github.com/ngekoding/php-hari-libur
Sebuah pustaka untuk mengecek hari libur di Indonesia
https://github.com/ngekoding/php-hari-libur
Last synced: 8 months ago
JSON representation
Sebuah pustaka untuk mengecek hari libur di Indonesia
- Host: GitHub
- URL: https://github.com/ngekoding/php-hari-libur
- Owner: ngekoding
- Created: 2021-01-13T06:54:41.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-04-04T03:05:31.000Z (almost 3 years ago)
- Last Synced: 2025-02-01T00:51:08.133Z (about 1 year ago)
- Language: PHP
- Size: 12.7 KB
- Stars: 5
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# php-hari-libur
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.
## Instalasi
```bash
composer require ngekoding/php-hari-libur
```
## Contoh Penggunaan
```php
check($date);
echo $date.': '.$isHoliday; // Output: 2020-01-01: true
```
## Pengaturan dan Method
`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:
```php
{
"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.
### Lisensi
MIT