php uk bank holidays

php uk bank holidays

該庫可讓開發人員輕鬆檢索英國銀行假期詳細資訊。可以檢索英格蘭和威爾斯、蘇格蘭和北愛爾蘭的假期。有關這些假期的資訊可以選擇按月份或日期進行限制。

安裝

要安裝，只需執行以下 Composer 命令。

composer require rapidwebltd/php-uk-bank-holidays

如果您的框架沒有為您執行此操作，請記住包含vendor/autoload.php檔案。

用法

可以如下檢索特定日期的銀行假日。預設情況下，這將帶回英格蘭和威爾斯的假期。

 use RapidWeb  UkBankHolidays  Factories  UkBankHolidayFactory ;

$ holidays = UkBankHolidayFactory:: getByDate ( 2017 , 01 , 2 );

var_dump ( $ holidays );

UKBankHoliday 對象

所有UkBankHolidayFactory方法都將傳回UkBankHoliday物件的陣列。以下程式碼片段顯示了 2017 年元旦銀行假期（發生在 2017 年 1 月 2 日）的範例物件。

 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 "
  }
}

該物件包含假期的標題、假期發生的日期以及政府提供的有關假期的註釋（如果有）。所有這些都可以公開存取。

地點限制

如果您希望檢索蘇格蘭或北愛爾蘭的銀行假日，請使用第四個可選參數，如下所示。

 $ 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 );

基於日期的限制

您可以使用此庫檢索所有假期或受月份或日期限制的假期。分別使用getAll 、 getByMonth和getByDate方法可以輕鬆完成此操作。

請參閱以下範例。

 $ allHolidays = UkBankHolidayFactory:: getAll ();
$ januaryHolidays = UkBankHolidayFactory:: getByMonth ( 2017 , 01 );
$ newYearsHolidays = UkBankHolidayFactory:: getByDate ( 2017 , 01 , 2 );

所有這些方法都接受一個附加的可選參數來指定您想要檢索的假期的位置。有關更多詳細信息，請參閱上面的位置限制部分。