Finance 類別是 BIRT 所提供的 JavaScript 類別,它提供了一組靜態金融函數,讓您用來執行各種一般商業計算。Financial 值可以用浮點值表示。應用程式無法建立這個類別的實例。
這個函數利用餘額倍減方法,傳回資產在給定單一期間的折舊。餘額倍減折舊是一種加速折舊的方法,可在固定資產的可用年限前幾年產生較高的折舊費用以及節省較多的稅金,而直線折舊法 (SLN) 的費用則是完全一致的。
函數會使用下列公式來計算一段期間內的折舊:
適用規則如下:
語法
參數
initial
Double。數值表示式,用來指定資產起始成本。
salvage
Double。數值表示式,用來指定資產在可用年限結束時的值。
life
Double。數值表示式,用來指定資產的可用年限長度。您必須使用與 singlePeriod 相同的度量單位來提供這個值。比方說,如果 singlePeriod 代表一個月,就必須以月份來表示 assetLifespan。
period
Integer。數值表示式,用來指定您要 DDB 計算折舊的期間。您必須使用與 assetLifespan 相同的度量單位來提供這個值。比方說,如果 assetLifespan 是以月份表示,則 singlePeriod 必須代表一個月的時期。
傳回
Double。
範例
下列範例是針對一台以 $1400 購買的新機器(預估 10 年的使用年限,殘餘價值為 $200),以餘額倍減方法計算第一年的折舊。結果 ($280) 會指派給變數 Year1Deprec:
另請參閱
Finance.sln 函數
Finance.syd 函數
這個函數所傳回的年金未來值,以定期固定金額付款及非變動利率為依據。年金是指在一段期間內,一系列的固定金額現金付款。年金可以是一種投資(例如每月的儲蓄計畫),或是借貸(例如房屋抵押)。
例如,公司或企業、子公司、組織單位(如:分區、位置或部門)。年金的未來值是在付完最後一筆付款之後,您想要的現金結餘。
比方說,如果您的儲蓄計畫目標是 18 年存入 $75,000 來負擔小孩的教育費用,則計畫的未來值就是 $75,000。
或者,如果您借貸 $11,000,借貸的未來值就是 $0.00(這是任何一般借貸的狀況)。
適用規則如下:
語法
參數
rate
指定孳生每個期間之利率的倍精準度數值表示式。您必須使用與 numberPayPeriods 相同的度量單位來提供這個值。比方說,如果 numberPayPeriods 是以月份表示,則 ratePerPeriod 必須以月利率來表示。
nPer
指定年金支付總期數的整數。您必須使用與 ratePerPeriod 相同的度量單位來提供這個值。比方說,如果 ratePerPeriod 是以月利率表示,則 numberPayPeriods 必須以月份來表示。
pmt
指定每次付款之金額的倍精準度數值表示式。您必須使用與 ratePerPeriod 相同的度量單位來提供這個值。比方說,如果 ratePerPeriod 是以月份表示,則 eachPmt 必須以月付款來表示。
pvalue
指定未來付款或一連串付款之今日價值的倍精準度數值表示式。比方說,如果您今天在銀行存入 $23.94,然後以 10 百分比的利率存 15 年(年利率,以複利計算),您最後會有 $100。$100 的現值大約是 $23.94。
due
指定各期付款是在期初 (1) 或是期末 (0) 進行的整數。這個值必須是 0 或 1。
傳回
Double
範例
下列範例假設您在女兒出生時,在儲蓄帳戶中為她存入 $10,000。如果帳戶每天的複利是 5.7 百分比,在 18 年後,她會有多少錢可以上大學?答案是 $27,896.60,這個值會指派給變數 TotalValue:
下列範例與上一個範例幾乎相同。但是在這個範例中,會假設利率是月複利,而不是日複利,而且您已決定要每個月另外存 $55 到戶頭中。在此情況下,指派給 TotalValue 的未來值是 $48,575.82:
另請參閱
Finance.ipmt 函數
Finance.nper 函數
Finance.pmt 函數
Finance.ppmt 函數
Finance.pv 函數
Finance.rate 函數
傳回年金在給定期間內支付的利息,以定期固定金額付款及非變動利率為依據。年金是指在一段期間內,一系列的固定金額現金付款。年金可以是一種投資(例如每月的儲蓄計畫),或是借貸(例如房屋抵押)。
例如,公司或企業、子公司、組織單位(如:分區、位置或部門)。每一次付款都包含兩個元件:本金和利息。iPmt 會傳回付款的利息元件。
適用規則如下:
語法
參數
rate
指定孳生每個期間之利率的倍精準度數值表示式。您必須使用與 numberPayPeriods 相同的度量單位來提供這個值。比方說,如果 numberPayPeriods 是以月份表示,則 ratePerPeriod 必須以月利率來表示。
per
指定特定之期間的整數,會決定該期間的利息。您提供的這個值必須介於 1 和 numberPayPeriods 的範圍之間。
nPer
指定年金支付總期數的整數。您必須使用與 ratePerPeriod 相同的度量單位來提供這個值。比方說,如果 ratePerPeriod 是以月利率表示,則 numberPayPeriods 必須以月份來表示。
pvalue
指定未來付款或一連串付款之今日價值的倍精準度數值表示式。比方說,如果您今天在銀行存入 $23.94,然後以 10 百分比的利率存 15 年(年利率,以複利計算),您最後會有 $100。在此情況下,$100 的現值大約是 $23.94。
fvalue
指定在付完最後一筆付款之後,您想要的現金結餘的倍精準度數值表示式。例如:
due
指定各期付款是在期初 (1) 或是期末 (0) 進行的整數。這個值必須是 0 或 1。
傳回
Double。
範例
下列範例假設您借貸 $20,000,貸款期數為 36 個月,年利率 (APR) 是 11.5 百分比,並且在每月第一天支付款項。在您的第五次付款中,有多少是利息?答案是 $171.83,這個值會指派給 Interest5:
另請參閱
Finance.fv 函數
Finance.nper 函數
Finance.pmt 函數
Finance.ppmt 函數
Finance.pv 函數
Finance.rate 函數
這個函數會傳回現有陣列中一系列定期現金流動、付款和收款的內部報酬率。內部報酬率是指由定期發生的付款和收款所組成的投資的利率。每一個時期的現金流動並不需要固定(但是在年金中是固定的)。
IRR 與淨現值函數 NPV 密切相關,因為 IRR 所計算的報酬率是與淨現值零相對應的利率。IRR 是依重複的方式來計算。它會從 <starting guess> 的值開始,重複計算,直到結果精度達到 0.00001 個百分比內。如果在重複 20 次之後仍無法判斷結果,則函數會失敗。
適用規則如下:
以下是若干有用的提示:
語法
參數
cash
指定代表現金流量值的現有 Double 陣列名稱的倍精準度值陣列。cashArray 必須包含至少一個正值(或收款)以及一個負值(或付款)。
s
指定您預估內部報酬率值的倍精準度數值表示式。在大部分的情況下,這個值是 0.1 或 10 百分比。
傳回
Double
範例
下列範例假設您已經在 myArray 陣列中填入一系列的現金流動值。內部報酬率是指派給變數 IRRValue:
另請參閱
Finance.mirr 函數
Finance.npv 函數
Finance.rate 函數
這個函數會針對現有陣列中一系列定期現金流動(或付款和收款),傳回已修正的內部報酬率。修正內部報酬率是指在依照不同利率來進行收款和付款時的內部報酬率 (IRR)。MIRR 會考量投資成本(或 financeRate)以及再投資時所獲得的利率(或 reinvestmentRate)。
適用規則如下:
由於 MIRR 使用陣列值的順序來解譯付款和收款順序,請務必依照正確的順序來輸入付款和收款值。
語法
參數
arptr
Double 的陣列,用來指定現有的現金流程值陣列的名稱。Array 必須包含至少一個正值(或收款)以及一個負值(或付款)。
frate
指定為資金成本支付之利率的倍精準度數值表示式。它必須是代表百分比的十進位值。
rrate
指定現金再投資之報酬率的倍精準度數值表示式。它必須是代表百分比的十進位值。
傳回
Double。
範例
下列範例假設您已經在 myArray 陣列中填入一系列的現金流動值。如果您為資金付出的利率是 12 百分比,而您的收入所賺取的利率 11.5 百分比,那麼修正內部報酬率為何?這個答案會指派給變數 MIRRValue:
另請參閱
Finance.irr 函數
Finance.rate 函數
傳回以定期固定金額付款及非變動利率為基準時的年金期數。年金是指在一段期間內,一系列的固定金額現金付款。年金可以是一種投資(例如每月的儲蓄計畫),或是借貸(例如房屋抵押)。
適用規則如下:
語法
參數
rate
指定孳生每個期間之利率的倍精準度數值表示式。您必須使用與 eachPmt 相同的度量單位來提供這個值。比方說,如果 eachPmt 是以月付款來表示,則 ratePerPeriod 必須以月利率來表示。
pmt
指定每次付款之金額的倍精準度數值表示式。您必須使用與 ratePerPeriod 相同的度量單位來提供這個值。比方說,如果 ratePerPeriod 是以月份表示,則 eachPmt 必須以月付款來表示。
pvalue
指定未來付款或一連串付款之今日價值的倍精準度數值表示式。比方說,如果您今天在銀行存入 $23.94,然後以 10 百分比的利率存 15 年(年利率,以複利計算),您最後會有大約 $100。在此情況下,$100 的現值大約是 $23.94。
fvalue
指定在付完最後一筆付款之後,您想要的現金結餘的倍精準度數值表示式。例如:
due
指定各期付款是在期初 (1) 或是期末 (0) 進行的整數。這個值必須是 0 或 1。
傳回
Double。
範例
下列範例假設您借貸 $20,000,年利率 (APR) 是 11.5 百分比,並且在每月第一天支付月付款。如果每一次付款的金額是 $653.26,那麼還需要付多少次,才能付清貸款?答案是 36,這個值會指派給變數 NumPeriods。
另請參閱
Finance.fv 函數
Finance.ipmt 函數
Finance.pmt 函數
Finance.ppmt 函數
Finance.pv 函數
Finance.rate 函數
在使用給定的利率時,這個函數會傳回一個變動系列的定期現金流動(正數和負數)淨現值。PV 可決定一系列固定付款的現值,而 NPV 則決定一系列變動付款的現值。淨現值是指與投資相關的所有未來現金流動的現值,再扣除任何起始成本。換言之,這就是指如果今天將一整筆錢存在銀行中,並依照 <rate> 所提供的利率讓它孳息,且存放的時期與一連串現金流動所考慮的時間相同時,會與所考量的一系列現金流動獲得相同利潤或損失的一整筆錢。
適用規則如下:
由於 NPV 使用陣列值的順序來解譯付款和收款順序,請務必依照正確的順序來提供付款和收款值。
語法
參數
rate
指定期間內之折扣率的倍精準度數值表示式。您必須以十進位數來表示這個值。
arptr
doubles 的陣列,用來指定現有的現金流程值陣列的名稱。陣列必須包含至少一個正值(收款)以及一個負值(付款)。
傳回
Double。
範例
下列範例假設您已經在 myArray 陣列中填入一系列的現金流動值,而利率是 11 百分比。淨現值為何?這個答案會指派給變數 NetPValue:
這個函數會計算兩個數字的百分比。這個函數會處理兩個與計算百分比相關的主要內務處理作業:處理分子中的零以及處理空值。
語法
參數
denom
Double。分母。引數必須包含一個數值。
num
Double。分子。引數必須包含數值。值可以是 0。
valueIfZero
Double。分子為零時,要傳回的百分比值。預設值是空值。
傳回
兩個數字的比例,以百分比表示。若分子為零,則傳回 0。如果兩個引數中有一個是空值,則傳回空值。
範例
以定期固定金額付款及非變動利率為基準,傳回年金付款金額。年金是指在一段期間內,一系列的固定金額現金付款。年金可以是一種投資(例如每月的儲蓄計畫),或是借貸(例如房屋抵押)。
適用規則如下:
語法
參數
rate
指定孳生每個期間之利率的倍精準度數值表示式。您必須使用與 ratePerPeriod 相同的度量單位來提供這個值。比方說,如果 numberPayPeriods 是以月份表示,則 ratePerPeriod 必須以月利率來表示。
nPer
指定年金支付總期數的整數。您必須使用與 ratePerPeriod 相同的度量單位來提供這個值。比方說,如果 ratePerPeriod 是以月利率表示,則 numberPayPeriods 必須以月份來表示。
pvalue
指定未來付款或一系列付款之現值的倍精準度數值表示式。比方說,如果您今天在銀行存入 $23.94,然後以 10 百分比的利率存 15 年(年利率,以複利計算),您最後會有 $100。在此情況下,$100 的現值大約是 $23.94。
fvalue
指定在付完最後一筆付款之後,您想要的現金結餘的倍精準度數值表示式。例如:
due
指定各期付款是在期初 (1) 或是期末 (0) 進行的整數。這個值必須是 0 或 1。
傳回
Double。
範例
下列範例假設您借貸 $20,000,貸款期數為 36 個月,年利率 (APR) 是 11.5 百分比,並且在每月第一天支付款項。您每一次要支付多少金額?答案是 $653.26,這個值會指派給 PaymentAmt。
另請參閱
Finance.fv 函數
Finance.ipmt 函數
Finance.nper 函數
Finance.ppmt 函數
Finance.pv 函數
Finance.rate 函數
傳回年金在給定期間內的本金付款,以定期固定金額付款及非變動利率為依據。年金是指在一段期間內,一系列的固定金額現金付款。年金可以是一種投資(例如每月的儲蓄計畫),或是借貸(例如房屋抵押)。
例如,公司或企業、子公司、組織單位(如:分區、位置或部門)。年金中的每一次付款都包含兩個元件:本金和利息。ppmt 會傳回付款的本金元件。
適用規則如下:
語法
參數
rate
指定孳生每個期間之利率的倍精準度數值表示式。您必須使用與 nPer 相同的度量單位來提供這個值。比方說,如果 nPer 是以月份表示,則 rate 必須以月利率來表示。
per
指定特定之期間的整數,會決定該期間的利息。這個值必須介於 1 和 nPer 的範圍之間。
nPer
指定年金支付總期數的整數。您必須使用與 rate 相同的度量單位來提供這個值。比方說,如果 rate 是以月利率表示,則 nPer 必須以月份來表示。
pvalue
指定未來付款或一連串付款之今日價值的倍精準度數值表示式。比方說,如果您今天在銀行存入 $23.94,然後以 10 百分比的利率存 15 年(年利率,以複利計算),您最後會有 $100。在此情況下,$100 的現值大約是 $23.94。
fvalue
指定在付完最後一筆付款之後,您想要的現金結餘的倍精準度數值表示式。例如:
due
指定各期付款是在期初 (1) 或是期末 (0) 進行的整數。這個值必須是 0 或 1。
傳回
Double。
範例
下列範例假設您借貸 $20,000,貸款期數為 36 個月,年利率 (APR) 是 11.5 百分比,並且在每月第一天支付款項。在您的第五次付款中,有多少是本金?答案是 $481.43,這個值會指派給 Principal5:
另請參閱
Finance.fv 函數
Finance.ipmt 函數
Finance.nper 函數
Finance.pmt 函數
Finance.pv 函數
Finance.rate 函數
這個函數會傳回以未來將支付的定期固定金額付款及非變動利率為基準時的年金現值。年金是指在一段期間內,一系列的固定金額現金付款。年金可以是一種投資(例如每月的儲蓄計畫),或是借貸(例如房屋抵押)。
例如,公司或企業、子公司、組織單位(如:分區、位置或部門)。現值是年金的未來付款或一連串付款的今日價值。
比方說,如果您今天在銀行存入 $23.94,然後以 10 百分比的利率存 15 年(年利率,以複利計算),您最後會有 $100。所以,$100 的現值大約是 $23.94。
適用規則如下:
語法
參數
rate
指定孳生每個期間之利率的倍精準度數值表示式。您必須使用與 nPer 相同的度量單位來提供這個值。比方說,如果 nPer 是以月份表示,則 rate 必須以月利率來表示。
nPer
指定年金支付總期數的整數。您必須使用與 rate 相同的度量單位來提供這個值。比方說,如果 rate 是以月利率表示,則 nPer 必須以月份來表示。
pmt
指定每次付款之金額的倍精準度數值表示式。您必須使用與 rate 相同的度量單位來提供這個值。比方說,如果 rate 是以月份表示,則 pmt 必須以月付款來表示。
fvalue
Double。指定在付完最後一筆付款之後,您想要的現金結餘。例如:
due
指定各期付款是在期初或是期末進行的整數。這個值必須是 1(代表時期開始)或 0(代表時期結束)。
傳回
Double
範例
下列範例假設您正在考慮購買面值為 $1000 的公司債券。債券每年可享有 $100 的債券息票,15 年後到期,下次配息是在年底。而類似債券的到期獲益是 12.5 百分比。那麼這支債券的合理價應該是多少,換言之,其現值為何?答案是 $834.18,這個值會指派給變數 PresentValue:
下列範例假設您贏得樂透獎。彩金是 $1000 萬,在未來的 20 年,您每年可以收到 $500,000,並且從一年後的今天開始支領。如果年利率(複利)是 9.5 百分比,那麼樂透獎現在價值多少?答案是 $4,406,191.06,這個值會指派給 PresentValue:
下列範例假設您要在 3 年內存入 $11,000。如果 APR 是 10.5 百分比,而您打算每個月存 $325,如果您是在每個月初存入款項,那麼您的戶頭現在需要有多少錢,才能達成目標?答案是 $2,048.06,這個值會指派給 StartValue。
請注意,eachPmt 是以負數表示,因為它代表支付的現金:
另請參閱
Finance.fv 函數
Finance.ipmt 函數
Finance.nper 函數
Finance.pmt 函數
Finance.ppmt 函數
Finance.rate 函數
這個函數會傳回年金在每個時期的利率。年金是指在一段期間內,一系列的固定金額現金付款。年金可以是一種投資(例如每月的儲蓄計畫),或是借貸(例如房屋抵押)。
Rate 會重複計算年金的利率。它會從 startingGuess 的值開始,重複計算,直到結果精確度達到 0.00001 個百分比內。如果在重複 20 次之後仍無法判斷結果,則函數會失敗。
適用規則如下:
以下是若干有用的提示:
語法
參數
nper
指定年金支付總期數的整數。您必須使用與 pmt 相同的度量單位來提供這個值。比方說,如果 pmt 是表示月付款,則 nper 必須以月份來表示。
pmt
指定每次付款之金額的倍精準度數值表示式。您必須使用與 nper 相同的度量單位來提供這個值。比方說,如果 nper 是以月份表示,則 pmt 必須以月付款來表示。
pvalue
指定未來付款或一連串付款之今日價值的倍精準度數值表示式。比方說,如果您今天在銀行存入 $23.94,然後以 10 百分比的利率存 15 年(年利率,以複利計算),您最後會有大約 $100。在此情況下,$100 的現值大約是 $23.94。
fvalue
指定在付完最後一筆付款之後,您想要的現金結餘的倍精準度數值表示式。例如:
due
指定各期付款是在期初或是期末進行的整數。這個值必須是 1(代表時期開始)或 0(代表時期結束)。
guess
指定您預估報酬 Rate 值的倍精準度數值表示式。在大部分的情況下,這個值是 0.1 或 10 百分比。
傳回
Double
範例
下列範例假設您已經借貸 $20,000,並且要在三年內付清。如果每個月支付 $653.26,並且在月初付款,那麼您的利率 (APR) 是多少?答案是 .115 或 11.5 百分比,這個值會指派給變數 InterestRate。
請注意,Rate 的回覆值必須乘以 12,才能得到年利率:
另請參閱
Finance.fv 函數
Finance.ipmt 函數
Finance.nper 函數
Finance.pmt 函數
Finance.ppmt 函數
Finance.pv 函數
這個函數會傳回資產在單一期間的直線折舊。直線折舊是固定資產最古老也最簡單的折舊方法。它使用的資產帳面價值小於預估剩餘價值,並且可以將差值平均配置給資產生命週期的每一個時期。這類程序是用來達成一致的年折舊費用,這是在計算所得稅之前,針對收入所收取的費用。所有的引數都必須是正數。
語法
參數
cost
指定資產起始成本的倍精準度數值表示式。
salvage
指定資產在可用年限結束時之值的倍精準度數值表示式。您可以輸入殘餘價值,來檢視殘餘價值的直線折舊抵銷,或是藉由在殘餘價值中提供 0(零),以傳回不含殘餘價值的直線折舊。
life
指定資產的可用年限長度的倍精準度數值表示式。在提供這個值時,所使用的度量單位,必須與您要函數傳回的值相同。比方說,如果您要 SLN 決定資產的年度折舊,就必須以年份來提供 assetLifespan。
傳回
Double。
範例
下列範例會計算在使用直線方法時,一台以 $1400 購買的新機器(該機器預估有 10 年的使用壽命,殘餘價值為 $200)的折舊。結果是每年 $120,這個值會指派給 AnnualDeprec:
另請參閱
Finance.ddb 函數
Finance.syd 函數
這個函數會傳回資產在指定期間的年數加總折舊。年數加總是一種加速折舊的方法,可在固定資產的可用年限前幾年產生較高的折舊費用以及節省較多的稅金,而直線折舊法 (SLN) 的費用則是完全一致的。
這個函數的折舊是基於可用年限數字總計的反向級距。比方說,如果資產的可用年限是 4 年,就會將數字 4、3、2 和 1 加總來產生 10。第一年的年數加總 (SYD) 會變成資產可折舊成本(或成本減殘值)的 4/10。第二年的比率變成 3/10,依此類推。
適用規則如下:
語法
參數
cost
指定資產起始成本的倍精準度數值表示式。
salvage
指定資產在可用年限結束時之值的倍精準度數值表示式。
life
指定資產的可用年限長度的倍精準度數值表示式。您必須使用與 period 相同的度量單位來提供這個值。比方說,如果 period 代表一個月,就必須以月份來表示 life。
period
指定您要 syd 計算折舊之期間的整數。您必須使用與 life 相同的度量單位來提供這個值。比方說,如果 life 是以月份表示,則 period 必須代表一個月的時期。
傳回
Double
範例
下列範例是針對一台以 $1400 購買的新機器(預估 10 年的使用年限,殘餘價值為 $200),以年數加總方法計算第一年的折舊。結果是 $218.18,這個值會指派給 Year1Deprec。
請注意:
下列範例會計算同一個資產在第二年可用年限的折舊。結果是 $196.36,這個值會指派給 Year2Deprec。
請注意:
另請參閱
Finance.ddb 函數
Finance.sln 函數