. */ declare(strict_types=1); namespace FireflyIII\Support\Repositories\Recurring; use Carbon\Carbon; use Log; /** * Class CalculateXOccurrencesSince */ trait CalculateXOccurrencesSince { /** * Calculates the number of daily occurrences for a recurring transaction, starting at the date, until $count is reached. It will skip * over $skipMod -1 recurrences. * * @param Carbon $date * @param Carbon $afterDate * @param int $count * @param int $skipMod * * @return array */ protected function getXDailyOccurrencesSince(Carbon $date, Carbon $afterDate, int $count, int $skipMod): array { Log::debug(sprintf('Now in %s', __METHOD__)); $return = []; $mutator = clone $date; $total = 0; $attempts = 0; while ($total < $count) { if (0 === $attempts % $skipMod && $mutator->gt($afterDate)) { $return[] = clone $mutator; $total++; } $mutator->addDay(); $attempts++; } return $return; } /** * Calculates the number of monthly occurrences for a recurring transaction, starting at the date, until $count is reached. It will skip * over $skipMod -1 recurrences. * * @param Carbon $date * @param Carbon $afterDate * @param int $count * @param int $skipMod * @param string $moment * * @return array */ protected function getXMonthlyOccurrencesSince(Carbon $date, Carbon $afterDate, int $count, int $skipMod, string $moment): array { Log::debug(sprintf('Now in %s', __METHOD__)); $return = []; $mutator = clone $date; $total = 0; $attempts = 0; $dayOfMonth = (int)$moment; if ($mutator->day > $dayOfMonth) { // day has passed already, add a month. $mutator->addMonth(); } while ($total < $count) { $domCorrected = min($dayOfMonth, $mutator->daysInMonth); $mutator->day = $domCorrected; if (0 === $attempts % $skipMod && $mutator->gte($afterDate)) { $return[] = clone $mutator; $total++; } $attempts++; $mutator->endOfMonth()->addDay(); } return $return; } /** * Calculates the number of NDOM occurrences for a recurring transaction, starting at the date, until $count is reached. It will skip * over $skipMod -1 recurrences. * * @param Carbon $date * @param Carbon $afterDate * @param int $count * @param int $skipMod * @param string $moment * * @return array */ protected function getXNDomOccurrencesSince(Carbon $date, Carbon $afterDate, int $count, int $skipMod, string $moment): array { Log::debug(sprintf('Now in %s', __METHOD__)); $return = []; $total = 0; $attempts = 0; $mutator = clone $date; $mutator->addDay(); // always assume today has passed. $mutator->startOfMonth(); // this feels a bit like a cop out but why reinvent the wheel? $counters = [1 => 'first', 2 => 'second', 3 => 'third', 4 => 'fourth', 5 => 'fifth',]; $daysOfWeek = [1 => 'Monday', 2 => 'Tuesday', 3 => 'Wednesday', 4 => 'Thursday', 5 => 'Friday', 6 => 'Saturday', 7 => 'Sunday',]; $parts = explode(',', $moment); while ($total < $count) { $string = sprintf('%s %s of %s %s', $counters[$parts[0]], $daysOfWeek[$parts[1]], $mutator->format('F'), $mutator->format('Y')); $newCarbon = new Carbon($string); if (0 === $attempts % $skipMod && $mutator->gte($afterDate)) { $return[] = clone $newCarbon; $total++; } $attempts++; $mutator->endOfMonth()->addDay(); } return $return; } /** * Calculates the number of weekly occurrences for a recurring transaction, starting at the date, until $count is reached. It will skip * over $skipMod -1 recurrences. * * @param Carbon $date * @param Carbon $afterDate * @param int $count * @param int $skipMod * @param string $moment * * @return array */ protected function getXWeeklyOccurrencesSince(Carbon $date, Carbon $afterDate, int $count, int $skipMod, string $moment): array { Log::debug(sprintf('Now in %s', __METHOD__)); $return = []; $total = 0; $attempts = 0; $mutator = clone $date; // monday = 1 // sunday = 7 $mutator->addDay(); // always assume today has passed. $dayOfWeek = (int)$moment; if ($mutator->dayOfWeekIso > $dayOfWeek) { // day has already passed this week, add one week: $mutator->addWeek(); } // today is wednesday (3), expected is friday (5): add two days. // today is friday (5), expected is monday (1), subtract four days. $dayDifference = $dayOfWeek - $mutator->dayOfWeekIso; $mutator->addDays($dayDifference); while ($total < $count) { if (0 === $attempts % $skipMod && $mutator->gte($afterDate)) { $return[] = clone $mutator; $total++; } $attempts++; $mutator->addWeek(); } return $return; } /** * Calculates the number of yearly occurrences for a recurring transaction, starting at the date, until $count is reached. It will skip * over $skipMod -1 recurrences. * * @param Carbon $date * @param Carbon $afterDate * @param int $count * @param int $skipMod * @param string $moment * * @return array */ protected function getXYearlyOccurrencesSince(Carbon $date, Carbon $afterDate, int $count, int $skipMod, string $moment): array { Log::debug(sprintf('Now in %s(%s, %d, %d, %s)', __METHOD__, $date->format('Y-m-d'), $date->format('Y-m-d'), $count, $skipMod)); $return = []; $mutator = clone $date; $total = 0; $attempts = 0; $date = new Carbon($moment); $date->year = $mutator->year; if ($mutator > $date) { Log::debug(sprintf('mutator (%s) > date (%s), so add a year to date (%s)', $mutator->format('Y-m-d'), $date->format('Y-m-d'), $date->format('Y-m-d'),)); $date->addYear(); Log::debug(sprintf('Date is now %s', $date->format('Y-m-d'))); } $obj = clone $date; while ($total < $count) { Log::debug(sprintf('total (%d) < count (%d) so go.', $total, $count)); Log::debug(sprintf('attempts (%d) %% skipmod (%d) === %d', $attempts, $skipMod, $attempts % $skipMod)); Log::debug(sprintf('Obj (%s) gte afterdate (%s)? %s', $obj->format('Y-m-d'), $afterDate->format('Y-m-d'), var_export($obj->gte($afterDate), true))); if (0 === $attempts % $skipMod && $obj->gte($afterDate)) { Log::debug('All conditions true, add obj.'); $return[] = clone $obj; $total++; } $obj->addYears(1); $attempts++; } return $return; } }