Pustaka ini memungkinkan pengembang dengan mudah mengambil detail hari libur bank Inggris. Hari libur dapat diambil untuk Inggris & Wales, Skotlandia, dan Irlandia Utara. Informasi tentang hari libur ini secara opsional dapat dibatasi berdasarkan bulan atau tanggal.
Untuk menginstal, jalankan saja perintah composer berikut.
composer require rapidwebltd/php-uk-bank-holidays
Ingatlah untuk menyertakan file vendor/autoload.php
jika kerangka kerja Anda tidak melakukan hal ini untuk Anda.
Pengambilan hari libur bank untuk tanggal tertentu dapat dilakukan sebagai berikut. Secara default, ini akan mengembalikan hari libur dari Inggris & Wales.
use RapidWeb UkBankHolidays Factories UkBankHolidayFactory ;
$ holidays = UkBankHolidayFactory:: getByDate ( 2017 , 01 , 2 );
var_dump ( $ holidays );
Semua metode UkBankHolidayFactory
akan mengembalikan array objek UkBankHoliday
. Cuplikan berikut menunjukkan contoh objek hari libur bank Tahun Baru 2017 yang jatuh pada tanggal 2 Januari 2017.
array ( 1 ) {
[ 0 ]=>
object(RapidWebUkBankHolidaysObjectsUkBankHoliday) #46 (4) {
[ " title " ]=>
string( 16 ) " New Year’s Day "
[ " date " ]=>
string( 10 ) " 2017-01-02 "
[ " notes " ]=>
string( 14 ) " Substitute day "
}
}
Objek ini memuat judul hari raya, tanggal terjadinya, dan catatan yang diberikan pemerintah mengenai hari raya tersebut, jika tersedia. Semua ini dapat diakses oleh publik.
Jika Anda ingin mengambil hari libur bank dari Skotlandia atau Irlandia Utara, gunakan argumen opsional ke-4, sebagai berikut.
$ englandWalesHolidays = UkBankHolidayFactory:: getByDate ( 2017 , 01 , 2 , ' england-and-wales ' );
$ scotlandHolidays = UkBankHolidayFactory:: getByDate ( 2017 , 01 , 2 , ' scotland ' );
$ northernIrelandHolidays = UkBankHolidayFactory:: getByDate ( 2017 , 01 , 2 , ' northern-ireland ' );
$ allHolidays = array_merge ( $ englandWalesHolidays , $ scotlandHolidays , $ northernIrelandHolidays );
Anda dapat menggunakan perpustakaan ini untuk mengambil semua hari libur atau hari libur alternatif yang dibatasi berdasarkan bulan atau tanggal. Hal ini mudah dilakukan dengan menggunakan metode getAll
, getByMonth
dan getByDate
.
Lihat contoh berikut.
$ allHolidays = UkBankHolidayFactory:: getAll ();
$ januaryHolidays = UkBankHolidayFactory:: getByMonth ( 2017 , 01 );
$ newYearsHolidays = UkBankHolidayFactory:: getByDate ( 2017 , 01 , 2 );
Semua metode ini menerima argumen opsional tambahan untuk menentukan lokasi hari libur yang ingin Anda ambil. Untuk lebih jelasnya, lihat bagian batasan lokasi di atas.