# tablepress/3.4/libraries/vendor/PhpSpreadsheet/Calculation/Financial/CashFlow/Single.php

TablePress – Tables in WordPress made easy, version 3.4. 109 lines.

- Page: https://pluginprobe.com/plugins/tablepress/3.4/code/libraries/vendor/PhpSpreadsheet/Calculation/Financial/CashFlow/Single.php
- Raw: https://pluginprobe.com/plugins/tablepress/3.4/raw/libraries/vendor/PhpSpreadsheet/Calculation/Financial/CashFlow/Single.php
- Modified: 2026-09-30T03:50:46+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/tablepress/3.4/code/libraries/vendor/PhpSpreadsheet/Calculation/Financial/CashFlow/Single.php#L10-L20`.

```php
<?php

namespace TablePress\PhpOffice\PhpSpreadsheet\Calculation\Financial\CashFlow;

use TablePress\PhpOffice\PhpSpreadsheet\Calculation\Exception;
use TablePress\PhpOffice\PhpSpreadsheet\Calculation\Functions;
use TablePress\PhpOffice\PhpSpreadsheet\Calculation\Information\ExcelError;

class Single
{
	/**
				 * FVSCHEDULE.
				 *
				 * Returns the future value of an initial principal after applying a series of compound interest rates.
				 * Use FVSCHEDULE to calculate the future value of an investment with a variable or adjustable rate.
				 *
				 * Excel Function:
				 *        FVSCHEDULE(principal,schedule)
				 *
				 * @param mixed $principal the present value
				 * @param float[] $schedule an array of interest rates to apply
				 * @return string|float
				 */
				public static function futureValue($principal, array $schedule)
	{
		$principal = Functions::flattenSingleValue($principal);
		$schedule = Functions::flattenArray($schedule);

		try {
			$principal = CashFlowValidations::validateFloat($principal);

			foreach ($schedule as $rate) {
				$rate = CashFlowValidations::validateFloat($rate);
				$principal *= 1 + $rate;
			}
		} catch (Exception $e) {
			return $e->getMessage();
		}

		return $principal;
	}

	/**
	 * PDURATION.
	 *
	 * Calculates the number of periods required for an investment to reach a specified value.
	 *
	 * @param mixed $rate Interest rate per period
	 * @param mixed $presentValue Present Value
	 * @param mixed $futureValue Future Value
	 *
	 * @return float|string Result, or a string containing an error
	 */
	public static function periods($rate, $presentValue, $futureValue)
	{
		$rate = Functions::flattenSingleValue($rate);
		$presentValue = Functions::flattenSingleValue($presentValue);
		$futureValue = Functions::flattenSingleValue($futureValue);

		try {
			$rate = CashFlowValidations::validateRate($rate);
			$presentValue = CashFlowValidations::validatePresentValue($presentValue);
			$futureValue = CashFlowValidations::validateFutureValue($futureValue);
		} catch (Exception $e) {
			return $e->getMessage();
		}

		// Validate parameters
		if ($rate <= 0.0 || $presentValue <= 0.0 || $futureValue <= 0.0) {
			return ExcelError::NAN();
		}

		return (log($futureValue) - log($presentValue)) / log(1 + $rate);
	}

	/**
	 * RRI.
	 *
	 * Calculates the interest rate required for an investment to grow to a specified future value .
	 *
	 * @param mixed $periods The number of periods over which the investment is made, expect array|float
	 * @param mixed $presentValue Present Value, expect array|float
	 * @param mixed $futureValue Future Value, expect array|float
	 *
	 * @return float|string Result, or a string containing an error
	 */
	public static function interestRate($periods = 0.0, $presentValue = 0.0, $futureValue = 0.0)
	{
		$periods = Functions::flattenSingleValue($periods);
		$presentValue = Functions::flattenSingleValue($presentValue);
		$futureValue = Functions::flattenSingleValue($futureValue);

		try {
			$periods = CashFlowValidations::validateFloat($periods);
			$presentValue = CashFlowValidations::validatePresentValue($presentValue);
			$futureValue = CashFlowValidations::validateFutureValue($futureValue);
		} catch (Exception $e) {
			return $e->getMessage();
		}

		// Validate parameters
		if ($periods <= 0.0 || $presentValue <= 0.0 || $futureValue < 0.0) {
			return ExcelError::NAN();
		}

		return ($futureValue / $presentValue) ** (1 / $periods) - 1;
	}
}

```