前一主題下一主題


Finance 類別

Finance 類別是 BIRT 所提供的 JavaScript 類別,它提供了一組靜態金融函數,讓您用來執行各種一般商業計算。Financial 值可以用浮點值表示。應用程式無法建立這個類別的實例。

Finance.ddb

這個函數會利用餘額倍減方法,傳回資產在給定的單一期間的折舊。餘額倍減折舊是一種加速折舊的方法, 可在固定資產的可用年限前幾年產生較高的折舊費用以及節省較多的稅金,而直線折舊法 (SLN) 的費用則是完全一致的。

函數會使用下列公式來計算一段期間內的折舊:

depreciation = (( initialCost - totalDepreciationFromPriorPeriods) * 2) / 
assetLifespan 

適用規則如下:

語法

ddb( initialCost, salvageValue, assetLifespan, singlePeriod )

引數

範例

下列會計算在使用餘額倍減方法時,一台以 $1400 購買的新機器(該機器預估有 10 年的使用壽命,殘餘價值為 $200), 第一年的折舊。結果 ($280) 會指派給變數 Year1Deprec:

Year1Deprec = Finance.ddb(1400, 200, 10, 1)  

另請參閱

Finance.sln 函數

Finance.syd 函數

Finance.fv

這個函數會傳回基於定期固定金額付款及非變動利率時,年金未來的值。年金是指在一段期間內,一系列的固定金額現金付款。年金可以是一種投資(例如每月的儲蓄計畫),或是借貸(例如房屋抵押)。 例如,公司或企業、子公司、組織單位(如:分區、位置或部門)。年金的未來值是在付完最後一筆付款之後,您想要的現金結餘。

比方說,如果您的儲蓄計畫目標是 18 年存入 $75,000 來負擔小孩的教育費用,則計畫的未來值就是 $75,000。

或者,如果您借貸 $11,000,借貸的未來值就是 $0.00(這是任何一般借貸的狀況)。

適用規則如下:

語法

fv( ratePerPeriod, numberPayPeriods, eachPmt, presentValue, whenDue )

引數

範例

下列範例假設您在女兒出生時,在儲蓄帳戶中為她存入 $10,000。如果帳戶每天的複利是 5.7%,在 18 年後,她會有多少錢可以上大學?答案是 $27,896.60,這個值會指派給變數 TotalValue:

TotalValue = Finance.fv(0.057/365, 18*365, 0, -10000, 1)  

下列範例與上一個範例幾乎相同。但是在這個範例中,會假設利率是月複利,而不是日複利,而且您已決定要每個月另外存 $55 到戶頭中。在此情況下,指派給 TotalValue 的未來值是 $48,575.82:

TotalValue = Finance.fv(0.057/12, 18*12, -55, -10000, 1)  

另請參閱

Finance.ipmt 函數

Finance.nper 函數

Finance.pmt 函數

Finance.ppmt 函數

Finance.pv 函數

Finance.rate 函數

Finance.ipmt

傳回基於定期固定金額付款及非變動利率時,年金在給定期間內支付的利息。年金是指在一段期間內,一系列的固定金額現金付款。年金可以是一種投資(例如每月的儲蓄計畫),或是借貸(例如房屋抵押)。 例如,公司或企業、子公司、組織單位(如:分區、位置或部門)。每一次付款都包含兩個元件:本金和利息。iPmt 會傳回付款的利息元件。

適用規則如下:

語法

ipmt( ratePerPeriod, singlePeriod, numberPayPeriods, presentValue, futureValue, whenDue )

引數

範例

下列範例假設您借貸 $20,000,貸款期數為 36 個月,年利率 (APR) 是 11.5%,並且在每月第一天支付款項。在您的第五次付款中,有多少是利息?答案是 $171.83,這個值會指派給 Interest5:

Interest5 = Finance.ipmt(.115/12, 5, 36, -20000, 0, 1)  

另請參閱

Finance.fv 函數

Finance.nper 函數

Finance.pmt 函數

Finance.ppmt 函數

Finance.pv 函數

Finance.rate 函數

Finance.irr

這個函數會傳回現有陣列中一系列定期現金流程、付款和收款的內部報酬率。內部報酬率是指由定期發生的付款和收款所組成的投資的利率。每一個時期的現金流程並不需要固定(但是在年金中是固定的)。

IRR 與淨現值函數 NPV 密切相關,因為 IRR 所計算的報酬率是與淨現值零相對應的利率。IRR 是依重複的方式來計算。它會從 <starting guess> 的值開始,重複計算,直到結果精度達到 0.00001 個百分比內。如果在重複 20 次之後仍無法判斷結果,則函數會失敗。

適用規則如下:

以下是若干有用的提示:

語法

irr( cashArray, startingGuess )

引數

範例

下列範例假設您已經在 myArray 陣列中移入一系列的現金流程值。內部報酬率是指派給變數 IRRValue:

IRRValue = Finance.irr( myArray, .1 ) 

另請參閱

Finance.mirr 函數

Finance.npv 函數

Finance.rate 函數

Finance.mirr

這個函數會傳回現有陣列中一系列定期現金流程,或付款和收款的修正內部報酬率。修正內部報酬率是指在依照不同利率來進行收款和付款時的內部報酬率 (IRR)。MIRR 會考量投資成本(或 financeRate)以及再投資時所獲得的利率(或 reinvestmentRate)。

適用規則如下:

由於 MIRR 使用陣列值的順序來解譯付款和收款順序,請務必依照正確的順序來輸入付款和收款值。

語法

mirr( cashArray, financeRate, reinvestmentRate )

引數

範例

下列範例假設您已經在 myArray 陣列中移入一系列的現金流程值。如果您為資金付出的利率是 12%,而您的收入所賺取的利率 11.5%,那麼修正內部報酬率為何?這個答案會指派給變數 MIRRValue:

MIRRValue = Finance.mirr( myArray, 0.12, 0.115 )   

另請參閱

Finance.irr 函數

Finance.rate 函數

Finance.nper

傳回基於定期、固定金額付款及非變動利率時,年金的期數。年金是指在一段期間內,一系列的固定金額現金付款。年金可以是一種投資(例如每月的儲蓄計畫),或是借貸(例如房屋抵押)。 例如,公司或企業、子公司、組織單位(如:分區、位置或部門)。

適用規則如下:

語法

nper( ratePerPeriod, eachPmt, presentValue, futureValue, whenDue )

引數

範例

下列範例假設您借貸 $20,000,年利率 (APR) 是 11.5%,並且在每月第一天支付月付款。如果每一次付款的金額是 $653.26,那麼還需要付多少次,才能付清貸款?答案是 36,這個值會指派給變數 NumPeriods。

NumPeriods = Finance.nper(.115/12, -653.26, 20000, 0, 1) 

另請參閱

Finance.fv 函數

Finance.ipmt 函數

Finance.pmt 函數

Finance.ppmt 函數

Finance.pv 函數

Finance.rate 函數

Finance.npv

這個函數會傳回在使用給定的利率時,一個變動系列的定期現金流程(正數和負數)的淨現值。PV 可決定一系列固定付款的現值,而 NPV 則決定一系列變動付款的現值。淨現值是指與投資相關的所有未來現金流程的現值再扣除任何起始成本。換言之,這就是指如果今天將一整筆錢存在銀行中, 並依照 <rate> 所提供的利率讓它孳息,且存放的時期與一連串現金流程所考慮的時間相同時, 會與所考量的一系列現金流程獲得相同利潤或損失的一整筆錢。

適用規則如下:

由於 NPV 使用陣列值的順序來解譯付款和收款順序,請務必依照正確的順序來提供付款和收款值。

語法

npv( rate, cashArray )

引數

範例

下列範例假設您已經在 myArray 陣列中移入一系列的現金流程值,而利率是 11%。淨現值為何?這個答案會指派給變數 NetPValue:

NetPValue = Finance.npv( .11, MyArray )  

Finance.percent

這個函數會計算兩個數字的百分比。這個函數會處理兩個與計算百分比相關的主要內務處理作業:處理分子中的零以及處理空值。

語法

percent( denom, num, valueIfZero )

引數

傳回

範例

pct = Finance.percent( 20, 50 ) // 傳回 40 
pct = Finance.percent( 20, 0 ) // 傳回 0 

Finance.pmt

傳回基於定期、固定金額付款及非變動利率時,年金的付款金額。年金是指在一段期間內,一系列的固定金額現金付款。年金可以是一種投資(例如每月的儲蓄計畫),或是借貸(例如房屋抵押)。 例如,公司或企業、子公司、組織單位(如:分區、位置或部門)。

適用規則如下:

語法

pmt( ratePerPeriod, numberPayPeriods, presentValue, futureValue, whenDue )

引數

範例

下列範例假設您借貸 $20,000,貸款期數為 36 個月,年利率 (APR) 是 11.5%,並且在每月第一天支付款項。您每一次要支付多少金額?答案是 $653.26,這個值會指派給 PaymentAmt。

PaymentAmt = Finance.pmt(.115/12, 36, -20000, 0, 1)  

另請參閱

Finance.fv 函數

Finance.ipmt 函數

Finance.nper 函數

Finance.ppmt 函數

Finance.pv 函數

Finance.rate 函數

Finance.ppmt

傳回基於定期固定金額付款及非變動利率時,年金在給定期間內的本金付款。年金是指在一段期間內,一系列的固定金額現金付款。年金可以是一種投資(例如每月的儲蓄計畫),或是借貸(例如房屋抵押)。 例如,公司或企業、子公司、組織單位(如:分區、位置或部門)。年金中的每一次付款都包含兩個元件:本金和利息。ppmt 會傳回付款的本金元件。

適用規則如下:

語法

ppmt( ratePerPeriod, singlePeriod, numberPayPeriods, presentValue, futureValue, whenDue )

引數

範例

下列範例假設您借貸 $20,000,貸款期數為 36 個月,年利率 (APR) 是 11.5%,並且在每月第一天支付月付款。在您的第五次付款中,有多少是本金?答案是 $481.43,這個值會指派給 Principal5:

Principal5 = Finance.ppmt(.115/12, 5, 36, -20000, 0, 1)  

另請參閱

Finance.fv 函數

Finance.ipmt 函數

Finance.nper 函數

Finance.pmt 函數

Finance.pv 函數

Finance.rate 函數

Finance.pv

這個函數會傳回基於未來將支付的定期固定金額付款及非變動利率時,年金的現值。年金是指在一段期間內,一系列的固定金額現金付款。年金可以是一種投資(例如每月的儲蓄計畫),或是借貸(例如房屋抵押)。 例如,公司或企業、子公司、組織單位(如:分區、位置或部門)。現值是年金的未來付款或一連串付款的今日價值。

比方說,如果您今天在銀行存入 $23.94,然後以 10% 的利率存 15 年(年利率,以複利計算),您最後會有 $100。所以,$100 的現值大約是 $23.94。

適用規則如下:

語法

pv( ratePerPeriod, numberPayPeriods, eachPmt, futureValue, whenDue )

引數

範例

下列範例假設您正在考慮購買面值為 $1000 的公司債券。債券每年可享有 $100 的債券息票,15 年後到期,下次配息是在年底。而類似債券的到期獲益是 12.5%。那麼這支債券的合理價應該是多少,換言之,其現值為何?答案是 $834.18,這個值會指派給變數 PresentValue:

PresentValue = Finance.pv(.125, 15, 100, 1000, 0)  

下列範例假設您贏得樂透獎。彩金是 $1000 萬,在未來的 20 年,您每年可以收到 $500,000,並且從一年後的今天開始支領。如果年利率(複利)是 9.5%,那麼樂透獎現在價值多少?答案是 $4,406,191.06,這個值會指派給 PresentValue:

PresentValue = Finance.pv(.095, 20, 50000,10000000, 0)  

下列範例假設您要在 3 年內存 $11,000。如果 APR 是 10.5%,而您打算每個月存 $325,如果您是在每個月初存入款項,那麼您的戶頭現在需要有多少錢,才能達成目標?答案是 $2,048.06,這個值會指派給 StartValue。 請注意,eachPmt 是以負數表示,因為它代表支付的現金:

StartValue = Finance.pv(.105/12, 3*12, -325, 11000, 1)  

另請參閱

Finance.fv 函數

Finance.ipmt 函數

Finance.nper 函數

Finance.pmt 函數

Finance.ppmt 函數

Finance.rate 函數

Finance.rate

這個函數會傳回年金在每個時期的利率。年金是指在一段期間內,一系列的固定金額現金付款。年金可以是一種投資(例如每月的儲蓄計畫),或是借貸(例如房屋抵押)。 例如,公司或企業、子公司、組織單位(如:分區、位置或部門)。

Rate 會重複計算年金的利率。它會從 startingGuess 的值開始,重複計算,直到結果精度達到 0.00001 個百分比內。如果在重複 20 次之後仍無法判斷結果,則函數會失敗。

適用規則如下:

以下是若干有用的提示:

語法

rate( numberPayPeriods, eachPmt, presentValue, futureValue, whenDue, startingGuess )

引數

範例

下列範例假設您已經借貸 $20,000,並且要在三年內付清。如果每個月支付 $653.26,並且在月初付款,那麼您的利率 (APR) 是多少?答案是 .115 或 11.5%,這個值會指派給變數 InterestRate。 請注意,Rate 的回覆值必須乘以 12,才能得到年利率:

InterestRate = Finance.rate(3*12, -653.26, 20000, 0, 1, .1) * 12  

另請參閱

Finance.fv 函數

Finance.ipmt 函數

Finance.nper 函數

Finance.pmt 函數

Finance.ppmt 函數

Finance.pv 函數

Finance.sln

這個函數會傳回資產在單一期間的直線折舊。直線折舊是固定資產最古老也最簡單的折舊方法。它使用的資產帳面價值小於預估剩餘價值,並且可以將差值平均配置給資產壽年的每一個時期。這類程序是用來達成一致的年折舊費用,這是在計算所得稅之前,針對收入所收取的費用。所有的引數都必須是正數。

語法

sln( initialCost, salvageValue, assetLifespan )

引數

範例

下列範例會計算在使用折線方法時,一台以 $1400 購買的新機器(該機器預估有 10 年的使用壽命,殘餘價值為 $200)的折舊。結果是每年 $120,這個值會指派給 AnnualDeprec:

AnnualDeprec = Finance.sln(1400, 200, 10)  

另請參閱

Finance.ddb 函數

Finance.syd 函數

Finance.syd

這個函數會傳回資產在指定期間的年數加總折舊。年數加總折舊是一種加速折舊的方法, 可在固定資產的可用年限前幾年產生較高的折舊費用以及節省較多的稅金,而直線折舊法 (SLN) 的費用則是完全一致的。

這個函數的折舊是基於可用年限數字總計的反相級距。比方說,如果資產的可用期限是 4 年,就會將數字 4、3、2 和 1 加總來產生 10。第一年的年數加總 (SYD) 會變成資產可折舊成本(或成本減殘值)的 4/10。第二年的比率變成 3/10,依此類推。

適用規則如下:

語法

syd( initialCost, salvageValue, assetLifespan, singlePeriod )

引數

範例

下列範例會計算在使用年數加總方法時,一台以 $1400 購買的新機器(該機器預估有 10 年的使用壽命,殘餘價值為 $200), 第一年的折舊。結果是 $218.18,這個值會指派給 Year1Deprec。

Year1Deprec = Finance.syd(1400, 200, 10, 1)  

請注意:

下列範例會計算同一個資產在第二年的使用期限的折舊。結果是 $196.36,這個值會指派給 Year2Deprec。

Year2Deprec = Finance.syd(1400, 200, 10, 2)  

請注意

另請參閱

Finance.ddb 函數

Finance.sln 函數


(c) Copyright Actuate Corporation 2006

前一主題下一主題