. */ declare(strict_types=1); namespace FireflyIII\Support; use Carbon\Carbon; use FireflyIII\Exceptions\FireflyException; use FireflyIII\Helpers\Fiscal\FiscalHelperInterface; use Log; /** * Class Navigation. */ class Navigation { /** * @param \Carbon\Carbon $theDate * @param $repeatFreq * @param $skip * * @return \Carbon\Carbon */ public function addPeriod(Carbon $theDate, string $repeatFreq, int $skip): Carbon { $date = clone $theDate; $add = ($skip + 1); $functionMap = [ '1D' => 'addDays', 'daily' => 'addDays', '1W' => 'addWeeks', 'weekly' => 'addWeeks', 'week' => 'addWeeks', '1M' => 'addMonths', 'month' => 'addMonths', 'monthly' => 'addMonths', '3M' => 'addMonths', 'quarter' => 'addMonths', 'quarterly' => 'addMonths', '6M' => 'addMonths', 'half-year' => 'addMonths', 'year' => 'addYears', 'yearly' => 'addYears', '1Y' => 'addYears', 'custom' => 'addMonths', // custom? just add one month. ]; $modifierMap = [ 'quarter' => 3, '3M' => 3, 'quarterly' => 3, '6M' => 6, 'half-year' => 6, ]; if (!isset($functionMap[$repeatFreq])) { Log::error(sprintf('Cannot do addPeriod for $repeat_freq "%s"', $repeatFreq)); return $theDate; } if (isset($modifierMap[$repeatFreq])) { $add *= $modifierMap[$repeatFreq]; } $function = $functionMap[$repeatFreq]; $date->$function($add); // if period is 1M and diff in month is 2 and new DOM > 1, sub a number of days: // AND skip is 1 // result is: // '2019-01-29', '2019-02-28' // '2019-01-30', '2019-02-28' // '2019-01-31', '2019-02-28' $months = ['1M', 'month', 'monthly']; $difference = $date->month - $theDate->month; if (1 === $add && 2 === $difference && $date->day > 0 && in_array($repeatFreq, $months, true)) { $date->subDays($date->day); } return $date; } /** * @param \Carbon\Carbon $start * @param \Carbon\Carbon $end * @param string $range * * @return array * @throws \FireflyIII\Exceptions\FireflyException * */ public function blockPeriods(\Carbon\Carbon $start, \Carbon\Carbon $end, string $range): array { if ($end < $start) { [$start, $end] = [$end, $start]; } $periods = []; /* * Start looping per month for 1 year + the rest of the year: */ $perMonthEnd = clone $end; $perMonthStart = clone $start; $perMonthStart->startOfYear()->subYear(); $perMonthStart = $start->lt($perMonthStart) ? $perMonthStart : $start; // loop first set: while ($perMonthEnd >= $perMonthStart) { $perMonthEnd = $this->startOfPeriod($perMonthStart, $range); $currentEnd = $this->endOfPeriod($perMonthEnd, $range); if ($currentEnd->gt($start)) { $periods[] = [ 'start' => $perMonthEnd, 'end' => $currentEnd, 'period' => $range, ]; } $perMonthEnd = $this->subtractPeriod($perMonthEnd, $range, 1); } // do not continue if date is already less if ($perMonthEnd->lt($start)) { return $periods; } // per year variables: $perYearEnd = clone $perMonthStart; $perYearStart = clone $perMonthStart; unset($perMonthEnd, $currentEnd, $perMonthStart); $perYearEnd->subYear(); $perYearStart->subYears(50); $perYearStart = $start->lt($perYearStart) ? $perYearStart : $start; $perYearStart->startOfYear(); // per year while ($perYearEnd >= $perYearStart) { $perYearEnd = $this->startOfPeriod($perYearEnd, '1Y'); $currentEnd = $this->endOfPeriod($perYearEnd, '1Y')->endOfDay(); if ($currentEnd->gt($start)) { $periods[] = [ 'start' => $perYearEnd, 'end' => $currentEnd, 'period' => '1Y', ]; } $perYearEnd = $this->subtractPeriod($perYearEnd, '1Y', 1); } return $periods; } /** * @param \Carbon\Carbon $end * @param $repeatFreq * * @return \Carbon\Carbon */ public function endOfPeriod(\Carbon\Carbon $end, string $repeatFreq): Carbon { $currentEnd = clone $end; $functionMap = [ '1D' => 'endOfDay', 'daily' => 'endOfDay', '1W' => 'addWeek', 'week' => 'addWeek', 'weekly' => 'addWeek', '1M' => 'addMonth', 'month' => 'addMonth', 'monthly' => 'addMonth', '3M' => 'addMonths', 'quarter' => 'addMonths', 'quarterly' => 'addMonths', '6M' => 'addMonths', 'half-year' => 'addMonths', 'year' => 'addYear', 'yearly' => 'addYear', '1Y' => 'addYear', ]; $modifierMap = [ 'quarter' => 3, '3M' => 3, 'quarterly' => 3, 'half-year' => 6, '6M' => 6, ]; $subDay = ['week', 'weekly', '1W', 'month', 'monthly', '1M', '3M', 'quarter', 'quarterly', '6M', 'half-year', '1Y', 'year', 'yearly']; // if the range is custom, the end of the period // is another X days (x is the difference between start) // and end added to $theCurrentEnd if ('custom' === $repeatFreq) { /** @var Carbon $tStart */ $tStart = session('start', Carbon::now()->startOfMonth()); /** @var Carbon $tEnd */ $tEnd = session('end', Carbon::now()->endOfMonth()); $diffInDays = $tStart->diffInDays($tEnd); $currentEnd->addDays($diffInDays); return $currentEnd; } if (!isset($functionMap[$repeatFreq])) { Log::error(sprintf('Cannot do endOfPeriod for $repeat_freq "%s"', $repeatFreq)); return $end; } $function = $functionMap[$repeatFreq]; if (isset($modifierMap[$repeatFreq])) { $currentEnd->$function($modifierMap[$repeatFreq]); if (in_array($repeatFreq, $subDay, true)) { $currentEnd->subDay(); } $currentEnd->endOfDay(); return $currentEnd; } $currentEnd->$function(); $currentEnd->endOfDay(); if (in_array($repeatFreq, $subDay, true)) { $currentEnd->subDay(); } return $currentEnd; } /** * @param \Carbon\Carbon $theCurrentEnd * @param string $repeatFreq * @param \Carbon\Carbon|null $maxDate * * @return \Carbon\Carbon */ public function endOfX(Carbon $theCurrentEnd, string $repeatFreq, ?Carbon $maxDate): Carbon { $functionMap = [ '1D' => 'endOfDay', 'daily' => 'endOfDay', '1W' => 'endOfWeek', 'week' => 'endOfWeek', 'weekly' => 'endOfWeek', 'month' => 'endOfMonth', '1M' => 'endOfMonth', 'monthly' => 'endOfMonth', '3M' => 'lastOfQuarter', 'quarter' => 'lastOfQuarter', 'quarterly' => 'lastOfQuarter', '1Y' => 'endOfYear', 'year' => 'endOfYear', 'yearly' => 'endOfYear', ]; $currentEnd = clone $theCurrentEnd; if (isset($functionMap[$repeatFreq])) { $function = $functionMap[$repeatFreq]; $currentEnd->$function(); } if (null !== $maxDate && $currentEnd > $maxDate) { return clone $maxDate; } return $currentEnd; } /** * @param \Carbon\Carbon $start * @param \Carbon\Carbon $end * * @return array */ public function listOfPeriods(Carbon $start, Carbon $end): array { // define period to increment $increment = 'addDay'; $format = $this->preferredCarbonFormat($start, $end); $displayFormat = (string)trans('config.month_and_day'); // increment by month (for year) if ($start->diffInMonths($end) > 1) { $increment = 'addMonth'; $displayFormat = (string)trans('config.month'); } // increment by year (for multi year) if ($start->diffInMonths($end) > 12) { $increment = 'addYear'; $displayFormat = (string)trans('config.year'); } $begin = clone $start; $entries = []; while ($begin < $end) { $formatted = $begin->format($format); $displayed = $begin->formatLocalized($displayFormat); $entries[$formatted] = $displayed; $begin->$increment(); } return $entries; } /** * @param \Carbon\Carbon $theDate * @param string $repeatFrequency * * @return string */ public function periodShow(\Carbon\Carbon $theDate, string $repeatFrequency): string { $date = clone $theDate; $formatMap = [ '1D' => (string)trans('config.specific_day'), 'daily' => (string)trans('config.specific_day'), 'custom' => (string)trans('config.specific_day'), '1W' => (string)trans('config.week_in_year'), 'week' => (string)trans('config.week_in_year'), 'weekly' => (string)trans('config.week_in_year'), '1M' => (string)trans('config.month'), 'month' => (string)trans('config.month'), 'monthly' => (string)trans('config.month'), '1Y' => (string)trans('config.year'), 'year' => (string)trans('config.year'), 'yearly' => (string)trans('config.year'), '6M' => (string)trans('config.half_year'), ]; if (isset($formatMap[$repeatFrequency])) { return $date->formatLocalized((string)$formatMap[$repeatFrequency]); } if ('3M' === $repeatFrequency || 'quarter' === $repeatFrequency) { $quarter = ceil($theDate->month / 3); return sprintf('Q%d %d', $quarter, $theDate->year); } // special formatter for quarter of year Log::error(sprintf('No date formats for frequency "%s"!', $repeatFrequency)); return $date->format('Y-m-d'); } /** * If the date difference between start and end is less than a month, method returns "Y-m-d". If the difference is less than a year, * method returns "Y-m". If the date difference is larger, method returns "Y". * * @param \Carbon\Carbon $start * @param \Carbon\Carbon $end * * @return string */ public function preferredCarbonFormat(Carbon $start, Carbon $end): string { $format = 'Y-m-d'; if ($start->diffInMonths($end) > 1) { $format = 'Y-m'; } if ($start->diffInMonths($end) > 12) { $format = 'Y'; } return $format; } /** * If the date difference between start and end is less than a month, method returns trans(config.month_and_day). If the difference is less than a year, * method returns "config.month". If the date difference is larger, method returns "config.year". * * @param \Carbon\Carbon $start * @param \Carbon\Carbon $end * * @return string */ public function preferredCarbonLocalizedFormat(Carbon $start, Carbon $end): string { $format = (string)trans('config.month_and_day'); if ($start->diffInMonths($end) > 1) { $format = (string)trans('config.month'); } if ($start->diffInMonths($end) > 12) { $format = (string)trans('config.year'); } return $format; } /** * If the date difference between start and end is less than a month, method returns "endOfDay". If the difference is less than a year, * method returns "endOfMonth". If the date difference is larger, method returns "endOfYear". * * @param \Carbon\Carbon $start * @param \Carbon\Carbon $end * * @return string */ public function preferredEndOfPeriod(Carbon $start, Carbon $end): string { $format = 'endOfDay'; if ($start->diffInMonths($end) > 1) { $format = 'endOfMonth'; } if ($start->diffInMonths($end) > 12) { $format = 'endOfYear'; } return $format; } /** * If the date difference between start and end is less than a month, method returns "1D". If the difference is less than a year, * method returns "1M". If the date difference is larger, method returns "1Y". * * @param \Carbon\Carbon $start * @param \Carbon\Carbon $end * * @return string */ public function preferredRangeFormat(Carbon $start, Carbon $end): string { $format = '1D'; if ($start->diffInMonths($end) > 1) { $format = '1M'; } if ($start->diffInMonths($end) > 12) { $format = '1Y'; } return $format; } /** * If the date difference between start and end is less than a month, method returns "%Y-%m-%d". If the difference is less than a year, * method returns "%Y-%m". If the date difference is larger, method returns "%Y". * * @param \Carbon\Carbon $start * @param \Carbon\Carbon $end * * @return string */ public function preferredSqlFormat(Carbon $start, Carbon $end): string { $format = '%Y-%m-%d'; if ($start->diffInMonths($end) > 1) { $format = '%Y-%m'; } if ($start->diffInMonths($end) > 12) { $format = '%Y'; } return $format; } /** * @param \Carbon\Carbon $theDate * @param $repeatFreq * * @return \Carbon\Carbon */ public function startOfPeriod(Carbon $theDate, string $repeatFreq): Carbon { $date = clone $theDate; $functionMap = [ '1D' => 'startOfDay', 'daily' => 'startOfDay', '1W' => 'startOfWeek', 'week' => 'startOfWeek', 'weekly' => 'startOfWeek', 'month' => 'startOfMonth', '1M' => 'startOfMonth', 'monthly' => 'startOfMonth', '3M' => 'firstOfQuarter', 'quarter' => 'firstOfQuarter', 'quarterly' => 'firstOfQuarter', 'year' => 'startOfYear', 'yearly' => 'startOfYear', '1Y' => 'startOfYear', ]; if (isset($functionMap[$repeatFreq])) { $function = $functionMap[$repeatFreq]; $date->$function(); return $date; } if ('half-year' === $repeatFreq || '6M' === $repeatFreq) { $month = $date->month; $date->startOfYear(); if ($month >= 7) { $date->addMonths(6); } return $date; } if ('custom' === $repeatFreq) { return $date; // the date is already at the start. } Log::error(sprintf('Cannot do startOfPeriod for $repeat_freq "%s"', $repeatFreq)); return $theDate; } /** * @param \Carbon\Carbon $theDate * @param $repeatFreq * @param int $subtract * * @return \Carbon\Carbon * * @throws \FireflyIII\Exceptions\FireflyException */ public function subtractPeriod(Carbon $theDate, string $repeatFreq, int $subtract = null): Carbon { $subtract = $subtract ?? 1; $date = clone $theDate; // 1D 1W 1M 3M 6M 1Y //Log::debug(sprintf('subtractPeriod: date is %s, repeat frequency is %s and subtract is %d', $date->format('Y-m-d'), $repeatFreq, $subtract)); $functionMap = [ '1D' => 'subDays', 'daily' => 'subDays', 'week' => 'subWeeks', '1W' => 'subWeeks', 'weekly' => 'subWeeks', 'month' => 'subMonths', '1M' => 'subMonths', 'monthly' => 'subMonths', 'year' => 'subYears', '1Y' => 'subYears', 'yearly' => 'subYears', ]; $modifierMap = [ 'quarter' => 3, '3M' => 3, 'quarterly' => 3, 'half-year' => 6, '6M' => 6, ]; if (isset($functionMap[$repeatFreq])) { $function = $functionMap[$repeatFreq]; $date->$function($subtract); //Log::debug(sprintf('%s is in function map, execute %s with argument %d', $repeatFreq, $function, $subtract)); //Log::debug(sprintf('subtractPeriod: resulting date is %s', $date->format('Y-m-d'))); return $date; } if (isset($modifierMap[$repeatFreq])) { $subtract *= $modifierMap[$repeatFreq]; $date->subMonths($subtract); //Log::debug(sprintf('%s is in modifier map with value %d, execute subMonths with argument %d', $repeatFreq, $modifierMap[$repeatFreq], $subtract)); //Log::debug(sprintf('subtractPeriod: resulting date is %s', $date->format('Y-m-d'))); return $date; } // a custom range requires the session start // and session end to calculate the difference in days. // this is then subtracted from $theDate (* $subtract). if ('custom' === $repeatFreq) { /** @var Carbon $tStart */ $tStart = session('start', Carbon::now()->startOfMonth()); /** @var Carbon $tEnd */ $tEnd = session('end', Carbon::now()->endOfMonth()); $diffInDays = $tStart->diffInDays($tEnd); //Log::debug(sprintf('repeatFreq is %s, start is %s and end is %s (session data).', $repeatFreq, $tStart->format('Y-m-d'), $tEnd->format('Y-m-d'))); //Log::debug(sprintf('Diff in days is %d', $diffInDays)); $date->subDays($diffInDays * $subtract); //Log::debug(sprintf('subtractPeriod: resulting date is %s', $date->format('Y-m-d'))); return $date; } throw new FireflyException(sprintf('Cannot do subtractPeriod for $repeat_freq "%s"', $repeatFreq)); } /** * @param $range * @param \Carbon\Carbon $start * * @return \Carbon\Carbon * * @throws \FireflyIII\Exceptions\FireflyException */ public function updateEndDate(string $range, Carbon $start): Carbon { $functionMap = [ '1D' => 'endOfDay', '1W' => 'endOfWeek', '1M' => 'endOfMonth', '3M' => 'lastOfQuarter', 'custom' => 'startOfMonth', // this only happens in test situations. ]; $end = clone $start; if (isset($functionMap[$range])) { $function = $functionMap[$range]; $end->$function(); return $end; } if ('6M' === $range) { if ($start->month >= 7) { $end->endOfYear(); return $end; } $end->startOfYear()->addMonths(6); return $end; } // make sure 1Y takes the fiscal year into account. if ('1Y' === $range) { /** @var FiscalHelperInterface $fiscalHelper */ $fiscalHelper = app(FiscalHelperInterface::class); return $fiscalHelper->endOfFiscalYear($end); } throw new FireflyException(sprintf('updateEndDate cannot handle range "%s"', $range)); } /** * @param $range * @param \Carbon\Carbon $start * * @return \Carbon\Carbon * * @throws \FireflyIII\Exceptions\FireflyException */ public function updateStartDate(string $range, Carbon $start): Carbon { $functionMap = [ '1D' => 'startOfDay', '1W' => 'startOfWeek', '1M' => 'startOfMonth', '3M' => 'firstOfQuarter', 'custom' => 'startOfMonth', // this only happens in test situations. ]; if (isset($functionMap[$range])) { $function = $functionMap[$range]; $start->$function(); return $start; } if ('6M' === $range) { if ($start->month >= 7) { $start->startOfYear()->addMonths(6); return $start; } $start->startOfYear(); return $start; } // make sure 1Y takes the fiscal year into account. if ('1Y' === $range) { /** @var FiscalHelperInterface $fiscalHelper */ $fiscalHelper = app(FiscalHelperInterface::class); return $fiscalHelper->startOfFiscalYear($start); } throw new FireflyException(sprintf('updateStartDate cannot handle range "%s"', $range)); } }