WorksheetFunction.YearFrac Method
Calculates the fraction of the year represented by the number of whole days between two dates (the start_date and the end_date). Use the YEARFRAC worksheet function to identify the proportion of a whole year's benefits or obligations to assign to a specific term.
Namespace: Microsoft.Office.Interop.Excel
Assembly: Microsoft.Office.Interop.Excel (in Microsoft.Office.Interop.Excel.dll)
Syntax
'Declaration
Function YearFrac ( _
Arg1 As Object, _
Arg2 As Object, _
Arg3 As Object _
) As Double
'Usage
Dim instance As WorksheetFunction
Dim Arg1 As Object
Dim Arg2 As Object
Dim Arg3 As Object
Dim returnValue As Double
returnValue = instance.YearFrac(Arg1, _
Arg2, Arg3)
double YearFrac(
Object Arg1,
Object Arg2,
Object Arg3
)
Parameters
Arg1
Type: System.ObjectStart_date - a date that represents the start date.
Arg2
Type: System.ObjectEnd_date - a date that represents the end date.
Arg3
Type: System.ObjectBasis - the type of day count basis to use.
Return Value
Type: System.Double
Remarks
Important
Dates should be entered by using the DATE function, or as results of other formulas or functions. For example, use DATE(2008,5,23) for the 23rd day of May, 2008. Problems can occur if dates are entered as text.
Basis |
Day count basis |
|---|---|
0 or omitted |
US (NASD) 30/360 |
1 |
Actual/actual |
2 |
Actual/360 |
3 |
Actual/365 |
4 |
European 30/360 |
Microsoft Excel stores dates as sequential serial numbers so they can be used in calculations. By default, January 1, 1900 is serial number 1, and January 1, 2008 is serial number 39448 because it is 39,448 days after January 1, 1900. Microsoft Excel for the Macintosh uses a different date system as its default.
All arguments are truncated to integers.
If start_date or end_date are not valid dates, YearFrac returns the #VALUE! error value.
If basis < 0 or if basis > 4, YearFrac returns the #NUM! error value.