/php-hari-libur

Plugin PHP untuk mengecek hari libur nasional.

Primary LanguagePHPMIT LicenseMIT

📅 PHP Hari Libur

Maintainability Scrutinizer Code Quality Support me ko-fi

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

🛠️ Laravel Setup

Add to config/app.php

'providers' => [
    ....
    Irfa\HariLibur\HariLiburServiceProvider::class,
     ];

Add to config/app.php

'aliases' => [
         ....
        'HariLibur' => Irfa\HariLibur\Facades\HariLibur::class,

    ],

Publish Vendor

php artisan vendor:publish --tag=hari-libur

Konfigurasi untuk Laravel

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

use Irfa\HariLibur\Facades\HariLibur;
atau
use HariLibur;

Jika menggunakan PHP Native atau non-Laravel untuk contoh penggunaannya seperti ini 

use Irfa\HariLibur\Func\HariLibur;
....
$libur = new HariLibur();
var_dump($libur->date("17-08-2021")->isHoliday());

Mengecek hari libur nasional pada tanggal yang dipilih

HariLibur::date("17-08-2021")->isHoliday();
//return true

Contoh Penggunaan

if(HariLibur::date("17-08-2021")->isHoliday())
{
    echo "Waktunya liburan.";
} else {
    echo "Waktunya bekerja.";
}

Mengecek hari libur akhir pekan pada tanggal yang dipilih

HariLibur::date("17-03-2021")->isWeekend();
//return false

Contoh Penggunaan

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.

HariLibur::date("17-08-2021")->isDayOff();
//return true

Mengambil hari libur nasional sebelum dan setelahnya

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

$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."<br>";
  }
//mengambil data hari libur sesudah tangal 17-08-2021
foreach ($date->prevHoliday() as $hariLibur) {
    echo "Tanggal: ".$hariLibur->date." Deskripsi: ".$hariLibur->description."<br>";
  }

Mengambil data hari libur

Mengambil semua data hari libur nasional sesuai regional yang diatur di konfigurasi.

HariLibur::get();

Contoh Penggunaan

foreach (HariLibur::get() as $hariLibur) {
		echo "Tanggal: ".$hariLibur->date." Deskripsi: ".$hariLibur->description."<br>";
	}

Mengambil informasi libur pada tanggal yang dipilih

HariLibur::date("17-08-2021")->getInfo();
//return Hari Kemerdekaan Republik Indonesia

Mengatur Regional secara terprogram

HariLibur::regional("ID")->get();

Menghapus Plugin

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 (https://github.com/irfaardy/php-hari-libur/fork)
  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
GitHub license