php uk bank holidays

php uk bank holidays

Cette bibliothèque permet aux développeurs de récupérer facilement les détails des jours fériés au Royaume-Uni. Les jours fériés peuvent être récupérés pour l’Angleterre et le Pays de Galles, l’Écosse et l’Irlande du Nord. Les informations sur ces jours fériés peuvent éventuellement être restreintes par mois ou par date.

Installation

Pour installer, exécutez simplement la commande composer suivante.

composer require rapidwebltd/php-uk-bank-holidays

N'oubliez pas d'inclure le fichier vendor/autoload.php si votre framework ne le fait pas pour vous.

Usage

La récupération des jours fériés pour une date spécifique peut être effectuée comme suit. Par défaut, cela ramènera les vacances d'Angleterre et du Pays de Galles.

 use RapidWeb  UkBankHolidays  Factories  UkBankHolidayFactory ;

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

var_dump ( $ holidays );

Objet UKBankHoliday

Toutes les méthodes UkBankHolidayFactory renverront un tableau d'objets UkBankHoliday . L'extrait suivant montre un exemple d'objet pour le jour férié du Nouvel An 2017, qui a lieu le 2 janvier 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 "
  }
}

Cet objet contient un titre pour le jour férié, la date à laquelle il survient et des notes fournies par le gouvernement concernant le jour férié, si disponibles. Tous ces éléments sont accessibles au public.

Restriction de localisation

Si vous souhaitez récupérer les jours fériés en Écosse ou en Irlande du Nord, utilisez le 4ème argument facultatif, comme suit.

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

Restrictions basées sur la date

Vous pouvez utiliser cette bibliothèque pour récupérer tous les jours fériés ou encore les jours fériés restreints par mois ou par date. Cela se fait facilement en utilisant respectivement les méthodes getAll , getByMonth et getByDate .

Voir les exemples suivants.

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

Toutes ces méthodes acceptent un argument facultatif supplémentaire pour spécifier le lieu des jours fériés que vous souhaitez récupérer. Pour plus de détails, consultez la section sur les restrictions de localisation ci-dessus.