Spreadsheet::Engine::Function::FV - Spreadsheet funtion FV()


Spreadsheet-Engine documentation Contained in the Spreadsheet-Engine distribution.

Index


Code Index:

NAME

Top

Spreadsheet::Engine::Function::FV - Spreadsheet funtion FV()

SYNOPSIS

Top

  =FV(rate, n, payment, [pv, [paytype]])

DESCRIPTION

Top

This calculates the future value of an investment.

HISTORY

Top

This is a Modified Version of code extracted from SocialCalc::Functions in SocialCalc 1.1.0

COPYRIGHT

Top

LICENCE

Top

The contents of this file are subject to the Artistic License 2.0; you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.perlfoundation.org/artistic_license_2_0


Spreadsheet-Engine documentation Contained in the Spreadsheet-Engine distribution.

package Spreadsheet::Engine::Function::FV;

use strict;
use warnings;

use base 'Spreadsheet::Engine::Fn::investment';

sub result_type { Spreadsheet::Engine::Value->new(type => 'n$') }

sub calculate {
  my ($self, $r, $n, $pmt, $pv, $type) = @_;
  $pv ||= 0;
  $type = $type ? 1 : 0;

  return -$pv - ($pmt * $n) if $r == 0;    # simple calculation if no interest
  return -(
    $pv * (1 + $r)**$n + $pmt * (1 + $r * $type) * ((1 + $r)**$n - 1) / $r);
}

1;

__END__