https://github.com/irfaardy/php-hari-libur
Plugin PHP untuk mengecek hari libur nasional.
https://github.com/irfaardy/php-hari-libur
cek-hari-libur libur-nasional
Last synced: about 1 year ago
JSON representation
Plugin PHP untuk mengecek hari libur nasional.
- Host: GitHub
- URL: https://github.com/irfaardy/php-hari-libur
- Owner: irfaardy
- License: mit
- Created: 2021-03-04T08:14:28.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-05-28T02:59:32.000Z (about 5 years ago)
- Last Synced: 2024-10-12T11:46:43.839Z (over 1 year ago)
- Topics: cek-hari-libur, libur-nasional
- Language: PHP
- Homepage:
- Size: 28.3 KB
- Stars: 1
- Watchers: 1
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# 📅 PHP Hari Libur
[](https://codeclimate.com/github/irfaardy/php-hari-libur/maintainability) [](https://scrutinizer-ci.com/g/irfaardy/php-hari-libur/?branch=master) [](https://buymeacoff.ee/irfaardy) [](https://ko-fi.com/S6S52P7SN)
Plugin ini berfungsi untuk mengecek hari libur nasional, untuk sekarang baru libur nasional di Indonesia.
Hari libur pada plugin ini akan selalu di update tiap tahun.
🛠️ Installation with Composer
composer require irfa/php-hari-libur
>You can get Composer [ here]( https://getcomposer.org/download/)
>
Update this Package
```
composer update irfa/php-hari-libur
```
🛠️ Laravel Setup
Add to config/app.php
```php
'providers' => [
....
Irfa\HariLibur\HariLiburServiceProvider::class,
];
```
Add to config/app.php
```php
'aliases' => [
....
'HariLibur' => Irfa\HariLibur\Facades\HariLibur::class,
],
```
Publish Vendor
php artisan vendor:publish --tag=hari-libur
Konfigurasi untuk Laravel
```php
config/irfa/hari_libur.php
```
Konfigurasi non-Laravel
```
/vendor/irfa/php-hari-libur/config/hari_libur.php
```
Jika anda menggunakan framework Laravel anda bisa mengubah atau menambah tanggal libur di `resources/data-libur-nasional/XX.json` sedangkan jika anda menggunakan PHP Native atau non-Laravel anda bisa mengubahnya di `vendor/irfa/php-hari-libur/src/Data/XX.json`
Usage
Memanggil class HariLibur
PHP Native / Non-Laravel
```
use Irfa\HariLibur\Func\HariLibur;
```
Jika di Laravel bisa juga menggunakan ini
```php
use Irfa\HariLibur\Facades\HariLibur;
atau
use HariLibur;
```
Jika menggunakan PHP Native atau non-Laravel untuk contoh penggunaannya seperti ini
```php
use Irfa\HariLibur\Func\HariLibur;
....
$libur = new HariLibur();
var_dump($libur->date("17-08-2021")->isHoliday());
```
Mengecek hari libur nasional pada tanggal yang dipilih
```php
HariLibur::date("17-08-2021")->isHoliday();
//return true
```
Contoh Penggunaan
```php
if(HariLibur::date("17-08-2021")->isHoliday())
{
echo "Waktunya liburan.";
} else {
echo "Waktunya bekerja.";
}
```
Mengecek hari libur akhir pekan pada tanggal yang dipilih
```php
HariLibur::date("17-03-2021")->isWeekend();
//return false
```
Contoh Penggunaan
```php
if(HariLibur::date("17-08-2021")->isWeekend())
{
echo "Selamat berakhir pekan.";
} else {
echo "Waktunya bekerja.";
}
```
Mengecek hari libur pada tanggal yang dipilih
Fungsi ini merupakan gabungan dari fungsi diatas.
Digunakan untuk mengecek tanggal merah dan akhir pekan.
```php
HariLibur::date("17-08-2021")->isDayOff();
//return true
```
Mengambil hari libur nasional sebelum dan setelahnya
```php
HariLibur::date("17-08-2021")->nextHoliday();
// mengambil data hari libur setelah tanggal 17-03-2021
HariLibur::date("17-08-2021")->prevHoliday();
// mengambil data hari libur setelah tanggal 17-03-2021
```
Contoh Penggunaan
```php
$date = HariLibur::date("17-08-2021");
//mengambil data hari libur sebelum tangal 17-08-2021
foreach ($date->nextHoliday() as $hariLibur) {
echo "Tanggal: ".$hariLibur->date." Deskripsi: ".$hariLibur->description."
";
}
//mengambil data hari libur sesudah tangal 17-08-2021
foreach ($date->prevHoliday() as $hariLibur) {
echo "Tanggal: ".$hariLibur->date." Deskripsi: ".$hariLibur->description."
";
}
```
Mengambil data hari libur
Mengambil semua data hari libur nasional sesuai regional yang diatur di konfigurasi.
```php
HariLibur::get();
```
Contoh Penggunaan
```php
foreach (HariLibur::get() as $hariLibur) {
echo "Tanggal: ".$hariLibur->date." Deskripsi: ".$hariLibur->description."
";
}
```
Mengambil informasi libur pada tanggal yang dipilih
```php
HariLibur::date("17-08-2021")->getInfo();
//return Hari Kemerdekaan Republik Indonesia
```
Mengatur Regional secara terprogram
```php
HariLibur::regional("ID")->get();
```
Menghapus Plugin
```php
composer remove irfa/php-hari-libur
```
setelah remove berhasil ada langkah tambahan jika menggunakan framework Laravel:
1. buka `config/app.php`
2. cari `providers` lalu hapus `Irfa\HariLibur\HariLiburServiceProvider::class`
3. cari `aliases` lalu hapus `'HariLibur' => Irfa\HariLibur\Facades\HariLibur::class,`
4. Simpan.
How to Contributing?
1. Fork it ()
2. Commit your changes (`git commit -m 'New Feature'`)
3. Push to the branch (`git push origin your-branch`)
4. Create a new Pull Request ` your-branch -> master`
if you found bug or error, please post here https://github.com/irfaardy/php-hari-libur/issues so that they can be maintained together.
***
## Bagaimana cara berkontribusi?
1. Lakukan fork di (https://github.com/irfaardy/php-hari-libur/fork)
2. Commit perubahan yang anda lakukan (`git commit -m 'Fitur Baru'`)
3. Push ke branch master (`git push origin branch-kamu`)
4. Buat Pull Request baru `branch-kamu -> master`
---
## Issue
If you found issues or bug please create new issues here https://github.com/irfaardyphp-hari-libur/issues/new
Jika anda menemukan bug atau error silahkan posting disini https://github.com/irfaardy/php-hari-libur/issues agar dapat diperbaiki bersama-sama.
***
Sumber libur nasional Indonesia : https://kalenderindonesia.com/libur/masehi/2021#
License
[](https://github.com/irfaardy/encrypt-file-laravel/blob/master/LICENSE)