php uk bank holidays

php uk bank holidays

تتيح هذه المكتبة للمطورين إمكانية استرداد تفاصيل عطلة البنوك في المملكة المتحدة بسهولة. يمكن استرداد العطلات في إنجلترا وويلز واسكتلندا وأيرلندا الشمالية. يمكن اختياريًا تقييد المعلومات المتعلقة بهذه العطلات حسب الشهر أو التاريخ.

تثبيت

للتثبيت، فقط قم بتشغيل أمر الملحن التالي.

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.

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

تقبل كل هذه الطرق وسيطة اختيارية إضافية لتحديد موقع العطلات التي ترغب في استردادها. لمزيد من التفاصيل، راجع قسم تقييد الموقع أعلاه.