PV
- 28 Sep 2023
- 1 Minute to read
- Print
- DarkLight
PV
- Updated on 28 Sep 2023
- 1 Minute to read
- Print
- DarkLight
Article Summary
Share feedback
Thanks for sharing your feedback!
| Step Details | |
| Introduced in Version | 4.0.0 |
| Last Modified in Version | 7.12.0 |
| Location | Data > Financial > Excel Functions |
The PV step is available in the Finance module. The PV function, which stands for "Present Value," is used to calculate the present value of a loan or an investment based on a constant interest rate.
Prerequisites
This step requires the Financial module to be installed before it will be available in the toolbox.
Properties
Inputs
| Property | Description | Data Type |
|---|---|---|
| Future Value | The future value, or a cash balance after the last payment. | Double |
| Interest Rate per period | This property represents the interest rate for each period. | Double |
| Number of Periods | This property represents the total number of payment periods. It defines the duration over which cumulative interest is calculated. The number of periods can be a whole number or a decimal depending on the frequency of payments. | Double |
| Payment due | This property indicates the timing of the payment, which can be either "End of Period" or "Beginning of Period." It determines whether payments are made at the end or the beginning of each compounding period. | PaymentDue |
| Periodic Payment | The payment that is made each period. For example, the monthly payments on a $10,000, four-year car loan at 12 percent are $263.33. You would enter -263.33 into the formula as the Periodic Payment. | Double |
Outputs
| Property | Description | Data Type |
|---|---|---|
| PV1_Output | The calculated present value. | Double |
Example Inputs and Outputs
| Future Value | Interest Rate per period | Number of Periods | Payment due | Periodic Payment | Output |
|---|---|---|---|---|---|
| 0 | 0.012 | 48 | BeginningOfPeriod | -263.33 | 9680.844872753258 |
| 0 | 0.0025 | 360 | BeginningOfPeriod | -1900 | 451786.47442028055 |
Common Errors
Invalid Inputs
If the Interest Rate per period, Number of Periods, or Periodic Payment inputs are empty, the step will return an error. Please ensure these inputs have data mapped correctly.
Exception Message:
Exception Stack Trace: DecisionsFramework.BusinessRuleException: [BusinessRule] Parameter 'intRate' of 'PV' can not be null at DecisionsFramework.Design.Flow.CoreSteps.InvokeMethodUtility.ThrowErrorIfNullIsNotAllowed(MethodInfo methodInfo, Object[] parameterValues, String errorMessage
at DecisionsFramework.Design.Flow.StepImplementations.InvokeMethodStep.Run(StepStartData data
at DecisionsFramework.Design.Flow.FlowStep.RunStepInternal(String flowTrackingID, String stepTrackingID, KeyValuePairDataStructure[] stepRunDataValues, AbstractFlowTrackingData trackingData
at DecisionsFramework.Design.Flow.FlowStep.Start(String flowTrackingID, String stepTrackingID, FlowStateData data, AbstractFlowTrackingData trackingData, RunningStepData currentStepData)Was this article helpful?
