Excel) (WorksheetFunction.YearFrac 方法

計算 start_date 與 end_date 間的天數於一年中的比例。 使用 YearFrac 工作表函式來識別要指派給特定詞彙的整年權益或義務比例。

語法

運算式。YearFrac (Arg1、 Arg2、 Arg3)

表達 代表 WorksheetFunction 物件的 變數。

參數

名稱	必要/選用	資料類型	描述
Arg1	必要	Variant	Start_date - 表示開始日期。
Arg2	必要	Variant	End_date - 代表結束日期的日期。
Arg3	選用	Variant	Basis - 要使用的日計數基礎類型。

傳回值

雙精確度

註解

重要事項

日期必須使用 DATE 函數來輸入，或是使用其他公式或函數的計算結果來輸入。 例如，使用 DATE(2008,5,23) 表示 2008 年 5 月 23 日。 若使用文字格式輸入日期，可能會發生問題。

下表代表 Arg3的可能值。

基礎	日計數基礎
0 或省略	US (NASD) 30/360
1	實際/實際
2	實際/360
3	實際/365
4	歐洲 30/360

Microsoft Excel 會以連續的序列值來儲存日期，以便用來計算。 根據預設，1900 年 1 月 1 日是序列值 1，而 2008 年 1 月 1 日則是序列值 39448，因為這是 1900 年 1 月 1 日之後的第 39,448 天。 Microsoft Excel for the Macintosh 則使用不同的預設日期系統。

注意事項

Visual Basic for Applications (VBA) 會以不同于 Excel 的方式計算序列日期。 在 VBA 中，序號 1 是 1899 年 12 月 31 日，而不是 1900 年 1 月 1 日。

會將所有引數無條件捨去成整數。

如果start_date或end_date不是有效的日期， YearFrac 會 傳回#VALUE！ 錯誤值。

如果 basis < 0 或 basis > 4， 則 YearFrac 會傳回#NUM！ 錯誤值。

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。