php uk bank holidays

php uk bank holidays

Mit dieser Bibliothek können Entwickler ganz einfach Details zu britischen Feiertagen abrufen. Feiertage können für England und Wales, Schottland und Nordirland abgerufen werden. Informationen zu diesen Feiertagen können optional nach Monat oder Datum eingeschränkt werden.

Installation

Führen Sie zur Installation einfach den folgenden Composer-Befehl aus.

composer require rapidwebltd/php-uk-bank-holidays

Denken Sie daran, die Datei vendor/autoload.php einzuschließen, wenn Ihr Framework dies nicht für Sie erledigt.

Verwendung

Das Abrufen von Feiertagen für ein bestimmtes Datum kann wie folgt erfolgen. Standardmäßig werden dadurch Feiertage aus England und Wales zurückgebracht.

 use RapidWeb  UkBankHolidays  Factories  UkBankHolidayFactory ;

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

var_dump ( $ holidays );

UKBankHoliday-Objekt

Alle UkBankHolidayFactory -Methoden geben ein Array von UkBankHoliday Objekten zurück. Der folgende Ausschnitt zeigt ein Beispielobjekt für den Neujahrsfeiertag 2017, der am 2. Januar 2017 stattfindet.

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

Dieses Objekt enthält einen Titel für den Feiertag, das Datum, an dem er stattfindet, und ggf. von der Regierung bereitgestellte Hinweise zum Feiertag. Alle diese sind öffentlich zugänglich.

Standortbeschränkung

Wenn Sie Feiertage aus Schottland oder Nordirland abrufen möchten, verwenden Sie das vierte optionale Argument wie folgt.

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

Datumsbasierte Einschränkungen

Mit dieser Bibliothek können Sie alle Feiertage oder alternativ nach Monat oder Datum eingeschränkte Feiertage abrufen. Dies lässt sich ganz einfach mit den Methoden getAll , getByMonth bzw. getByDate bewerkstelligen.

Sehen Sie sich die folgenden Beispiele an.

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

Alle diese Methoden akzeptieren ein zusätzliches optionales Argument, um den Ort der Feiertage anzugeben, die Sie abrufen möchten. Weitere Einzelheiten finden Sie oben im Abschnitt zur Standortbeschränkung.