feat: Update Bangladesh holiday calculations

lang/bangladesh/bn/holidays.json

@@ -1,10 +1,25 @@
 {
- "International Mother Language Day": "Antorjatik Matribhasha Dibos",
- "Birthday of Sheikh Mujibur Rahman": "Shekh Mujibur Rahmaner Jonmodin",
- "Independence Day": "Swadhinota Dibos",
- "Bengali New Year": "Bangla Noboborsho",
- "May Day": "Antorjatik Shrom Dibos",
- "National Mourning Day": "Jatiyo Shok Dibos",
- "Victory Day": "Bijoy Dibos",
- "Christmas Day": "Borodin"
-}
+ "International Mother Language Day": "শহীদ দিবস",
+ "Independence Day": "স্বাধীনতা দিবস",
+ "May Day": "মে দিবস",
+ "National Mourning Day": "জাতীয় শোক দিবস",
+ "Victory Day": "বিজয় দিবস",
+ "Christmas Day": "বড়দিন",
+ "Shab-e-Barat": "শবে বরাত",
+ "Shab-e-Qadr": "শবে কদর",
+ "Shab-e-Meraj": "শবে মেরাজ",
+ "Eid ul-Fitr": "ঈদ-উল-ফিতর",
+ "Eid ul-Fitr Eve": "ঈদ-উল-ফিতরের আগের দিন",
+ "Eid ul-Fitr Holiday": "ঈদ-উল-ফিতরের ছুটি",
+ "Eid ul-Adha": "ঈদ-উল-আযহা",
+ "Eid ul-Adha Eve": "ঈদ-উল-আযহার আগের দিন",
+ "Eid ul-Adha Holiday": "ঈদ-উল-আযহার ছুটি",
+ "Ashura": "আশুরা",
+ "Eid-e-Miladunnabi": "ঈদে মিলাদুন্নবী",
+ "Pohela Boishakh": "পহেলা বৈশাখ",
+ "Buddha Purnima": "বুদ্ধ পূর্ণিমা",
+ "Jonmashtomi": "জন্মাষ্টমী",
+ "Durga Puja": "দুর্গা পূজা",
+ "Birthday of Sheikh Mujibur Rahman": "শেখ মুজিবুর রহমানের জন্মদিন",
+ "Bengali New Year": "বাংলা নববর্ষ"
+}

src/Calendars/BangladeshiCalander.php

@@ -0,0 +1,261 @@
+<?php
+
+namespace Spatie\Holidays\Calendars;
+
+use Carbon\CarbonImmutable;
+use Carbon\CarbonPeriod;
+use Spatie\Holidays\Countries\Country;
+
+/**
+ * Handles holiday calculations for Bangladesh including:
+ * - Islamic holidays (using Hijri calendar)
+ * - Hindu festivals (using lunar calendar)
+ * - Buddhist festivals (using lunar calendar)
+ * - National holidays (using Gregorian calendar)
+ * 
+ * @mixin Country 
+ * @property string $islamicCalendarTimezone
+ */
+trait BangladeshiCalander
+{
+ use IslamicCalendar {
+ IslamicCalendar::setIslamicCalendarTimezone as private parentSetIslamicCalendarTimezone;
+ }
+
+ /*
+ |--------------------------------------------------------------------------
+ | Islamic Holiday Calculations
+ |--------------------------------------------------------------------------
+ */
+
+ /** @return array<CarbonPeriod> */
+ protected function shabEBarat(int $year): array
+ {
+ return $this->getIslamicHoliday(
+ month: self::ISLAMIC_MONTHS['SHABAN'],
+ day: '15',
+ year: $year
+ );
+ }
+
+ /** @return array<CarbonPeriod> */
+ protected function shabEQadr(int $year): array
+ {
+ return $this->getIslamicHoliday(
+ month: self::ISLAMIC_MONTHS['RAMADAN'],
+ day: '27',
+ year: $year
+ );
+ }
+
+ /** @return array<CarbonPeriod> */
+ protected function eidUlFitr(int $year): array
+ {
+ return $this->getIslamicHoliday(
+ month: self::ISLAMIC_MONTHS['SHAWWAL'],
+ day: '01',
+ year: $year,
+ daysBeforeAfter: [2, 2] // 2 days before and 2 days after
+ );
+ }
+
+ /** @return array<CarbonPeriod> */
+ protected function eidUlAdha(int $year): array
+ {
+ return $this->getIslamicHoliday(
+ month: self::ISLAMIC_MONTHS['DHU_AL_HIJJAH'],
+ day: '10',
+ year: $year,
+ daysBeforeAfter: [2, 3] // 2 days before and 3 days after
+ );
+ }
+
+ /** @return array<CarbonPeriod> */
+ protected function eideMiladunnabi(int $year): array
+ {
+ return $this->getIslamicHoliday(
+ month: self::ISLAMIC_MONTHS['RABI_AL_AWWAL'],
+ day: '12',
+ year: $year
+ );
+ }
+
+ /** @return array<CarbonPeriod> */
+ protected function ashura(int $year): array
+ {
+ return $this->getIslamicHoliday(
+ month: self::ISLAMIC_MONTHS['MUHARRAM'],
+ day: '10',
+ year: $year
+ );
+ }
+
+ /** @return array<CarbonPeriod> */
+ protected function shabEMeraj(int $year): array
+ {
+ return $this->getIslamicHoliday(
+ month: self::ISLAMIC_MONTHS['RAJAB'],
+ day: '27',
+ year: $year
+ );
+ }
+
+ /*
+ |--------------------------------------------------------------------------
+ | Bengali Calendar Holiday Calculations
+ |--------------------------------------------------------------------------
+ */
+
+ /** @return array<CarbonPeriod> */
+ protected function pohela_boishakh(int $year): array
+ {
+ // Bengali New Year is typically April 14
+ // Handles leap year adjustments
+ $date = CarbonImmutable::create($year, 4, 14);
+ if ($date->isLeapYear() && $date->month > 2) {
+ $date = $date->addDay();
+ }
+
+ return [$this->createPeriod($date->format('m-d'), $year, 1)];
+ }
+
+ /*
+ |--------------------------------------------------------------------------
+ | Hindu and Buddhist Holiday Calculations
+ |--------------------------------------------------------------------------
+ */
+
+ /** @return array<CarbonPeriod> */
+ protected function buddhaPurnima(int $year): array
+ {
+ // Calculate first full moon day of May
+ $baseDate = CarbonImmutable::create($year, 5, 1);
+ $fullMoonDate = $this->findNearestFullMoon($baseDate);
+
+ return [$this->createPeriod($fullMoonDate->format('m-d'), $year, 1)];
+ }
+
+ /** @return array<CarbonPeriod> */
+ protected function jonmashtomi(int $year): array
+ {
+ // Krishna Janmashtami falls on the eighth day of the dark fortnight
+ $baseDate = CarbonImmutable::create($year, 8, 15);
+ $ashtamiDate = $this->calculateAshtamiDate($baseDate);
+
+ return [$this->createPeriod($ashtamiDate->format('m-d'), $year, 1)];
+ }
+
+ /** @return array<CarbonPeriod> */
+ protected function durgaPuja(int $year): array
+ {
+ // Durga Puja's main days (Ashtami and Navami)
+ $baseDate = CarbonImmutable::create($year, 10, 15);
+ $ashtamiDate = $this->calculateAshtamiDate($baseDate);
+
+ return [$this->createPeriod($ashtamiDate->format('m-d'), $year, 2)];
+ }
+
+ /*
+ |--------------------------------------------------------------------------
+ | Helper Methods
+ |--------------------------------------------------------------------------
+ */
+
+ /**
+ * Helper method to calculate Islamic holiday dates
+ * 
+ * @param string $month Islamic month number
+ * @param string $day Day of the month
+ * @param int $year Gregorian year
+ * @param array<int> $daysBeforeAfter [daysBefore, daysAfter]
+ * @return array<CarbonPeriod>
+ */
+ private function getIslamicHoliday(
+ string $month,
+ string $day,
+ int $year,
+ array $daysBeforeAfter = [0, 0]
+ ): array {
+ $date = $this->islamicToGregorianDate("$month-$day", $year);
+
+ if (!empty($daysBeforeAfter)) {
+ $date = $date->subDays($daysBeforeAfter[0]);
+ $totalDays = 1 + $daysBeforeAfter[0] + $daysBeforeAfter[1];
+ } else {
+ $totalDays = 1;
+ }
+
+ return [$this->createPeriod($date->format('m-d'), $year, $totalDays)];
+ }
+
+ /**
+ * Calculate lunar phase (0 = new moon, 0.5 = full moon)
+ */
+ private function getLunarPhase(CarbonImmutable $date): float
+ {
+ $year = $date->year;
+ $month = $date->month;
+ $day = $date->day;
+
+ $c = $date->getPreciseTimestamp() / 86400;
+ $e = $c - 2451550.1;
+ $phase = $e / 29.530588853;
+
+ return $phase - floor($phase);
+ }
+
+ /**
+ * Find the nearest full moon to a given date
+ */
+ private function findNearestFullMoon(CarbonImmutable $targetDate): CarbonImmutable
+ {
+ $date = $targetDate->copy();
+ $closestDate = $date;
+ $closestDiff = 1;
+
+ // Check 15 days before and after
+ for ($i = -15; $i <= 15; $i++) {
+ $checkDate = $date->addDays($i);
+ $phase = $this->getLunarPhase($checkDate);
+ $diff = abs($phase - 0.5);
+
+ if ($diff < $closestDiff) {
+ $closestDiff = $diff;
+ $closestDate = $checkDate;
+ }
+ }
+
+ return $closestDate;
+ }
+
+ /**
+ * Calculate Ashtami (eighth day) date for Hindu festivals
+ */
+ private function calculateAshtamiDate(CarbonImmutable $baseDate): CarbonImmutable
+ {
+ $newMoon = $this->findNearestNewMoon($baseDate);
+ return $newMoon->addDays(8);
+ }
+
+ /**
+ * Find the nearest new moon to a given date
+ */
+ private function findNearestNewMoon(CarbonImmutable $date): CarbonImmutable
+ {
+ $closestDate = $date;
+ $closestDiff = 1;
+
+ for ($i = -15; $i <= 15; $i++) {
+ $checkDate = $date->addDays($i);
+ $phase = $this->getLunarPhase($checkDate);
+ $diff = min($phase, 1 - $phase);
+
+ if ($diff < $closestDiff) {
+ $closestDiff = $diff;
+ $closestDate = $checkDate;
+ }
+ }
+
+ return $closestDate;
+ }
+}