What the name means | "Depreciate"
| Syntax | Depreciate ( Time, Base, StartDep, LifeOrDecRate, DepType, InitialValue, [FinalValue], [DayCount], [Periods], [ProjMode] )
| Description | Calculates depreciation for a time period.
| Auto Array Function | This function can be used as an array function as well as a normal function, by pluralising the first variable (in this case Time) to give an answer array. See Array Functions.
| Auto Multi Function | This function is an 'AutoMulti' function and can accept range inputs as well as single values for the variables indicated AM, in which case the function will perform its calculation on each of the values in the range. See Auto Multi Functions. In this case the function can repeat its calculations for each corresponding value of StartDeps,LifeOrDecRates,InitialValues,FinalValues.
|
| Variable | Type or Value | Description |
Inputs: (10)
|
1
| Time
| TimePeriod Start
| The Time or Date that signifies the start of a time period. Usually accompanied by Base, the length (months) or end of the time period.
|
2
| Base
| TimePeriod Base
| Either the length of a Time Period, expressed in exact months, or as a date, in which case it is the date of the end of the time period.
|
3
| StartDep
| Date
 AM
| The Start date of Depreciation (this is usually the Initial Date, but it is possible for depreciation to commence later)
|
4
| LifeOrDecRate
| Float
 AM
| Either the life in years of the asset (eg 10 years) OR an annual rate of decline eg (0.25 per year)
|
5
| DepType
| Integer
| The type of depreciation ( 0=Straight Line, 1= Declining Balance, 2=Double Declining,3=Sum of Years Digits)
|
6
| InitialValue
| Float
 AM
| The initial value of something (for depreciation, the purchase cost)
|
7
| FinalValue
| Float (Optional)
 AM
| The final value of something (for depreciation, the salvage value at the end of the assets life). Zero if omitted.
(Optional)
|
8
| DayCount
| Float (Optional)
| Either a single number denoting the DayCount method, or a number in the form ww.ss where ww is the daycount of whole periods and ss applies to stub periods. See Using Daycount.
(Optional)
|
9
| Periods
| Annual Sequence (Optional)
| Either an option number, or a range of floats, describing the accruals periods or the timing of cash payments, in the format mm.dd for payments in advance or -mm.dd for payments in arrears. See Using Daycount
(Optional)
|
10
| ProjMode
| Float (Optional)
| Accruals=0, Cash=1. Has other settings. See detail and the topic Accruals and Cash
(Optional)
|
Output:
|
Return Value
| Result
| Float
| The result of the function, expressed as a number.
|
Defaults and Values The variable(s) of this function have certain defaults and/or switch values associated with them. Click here to see more. Type of Value | Value | Description | Detail | Default(s)
| DepType | 0 | Straight Line
| | FinalValue | 0 | Zero Final Value
| | DayCount | 5 | Decimal Year (ACTM/12): ActualMonths / 12
| | Periods | 4 | Calendar quarters (1.01, 4.01, 7.01, 10.01)
| | ProjMode | 0 | Accruals Projection Mode | Switches
| DepType | 3 | Sum of Years Digits
| | | 0 | Straight Line
| | | 2 | Double Declining Balance
| | | 1 | Declining Balance
| | DayCount | 0 | 30/360 BMA (Bond Market Association, formerly the PSA)
| | | 1 | ACT/ACT (365 or 366)
| | | 2 | ACT/360: ActualDaysInPeriod / 360
| | | 3 | ACT/365: ActualDaysInPeriod / 365
| | | 4 | 30E/360: Also known as European 30/360. Standard bond literature definition.
| | | 5 | Decimal Year (ACTM/12): ActualMonths / 12
| | | 6 | ACT/ACT (in period)
| | | 7 | 30/360 BMA (Bond Market Association, formerly the PSA)
| | | 8 | ACT (Non Leap)/365: Same as ACT/365 but ignoring Feb 29
| | | 9 | 30/365: Standard bond literature definition (same as 30/360 but with 365 denominator)
| | | 10 | 30/360 ISDA
| | | 11 | 30/360 ISDA + Feb Adj
| | | 12 | ISDA + Feb EOM Adj
| | | 13 | Brazilian ACTBD/252
| | | -12 | Monthly in arrear, calendar months {1st Jan payment for Dec accrual, Feb 1 payment for Jan accrual etc}
| | | -4 | Quarterly in arrear, calendar quarters (1st April for Jan-March accrual, 1st Jul payment for April-June accrual, etc)
| | | -2 | 6 monthly in arrears (1st Jan payment for Jul-Dec accrual,1st July payment for Jan-June accrual )
| | | -1 | Annually In Arrear 1st Jan payment for Jul-Dec accrual
| | | 1 | Annually, 1st Jan
| | | 2 | 6 monthly (1st Jan, 1st July)
| | | 4 | Calendar quarters (1.01, 4.01, 7.01, 10.01)
| | | 12 | Calendar months {1.01, 1.02 etc}
| | | 13 | Real Estate English Quarter Days:25th March, 24th June, 29th September and 25th December of each year ie {3.25,6.24,9.29,12.25}
| | | 14 | Continuous (could be thought of as daily)
| | ProjMode | 0 | Accruals Projection Mode
| | | 1 | Cash Projection Mode
| | | 2 | Accruals Projection Mode (include last day)
| | | 3 | Cash Projection Mode (include last day) | Example(s)
| Time | 01/07/2002 |
| | Base | 12 |
| | | 01/01/2003 | |
Extra Features | DepType has to 0,1,2, or 3 to use one of the pre-defined depreciation types. However any other number is used as the factor for n-declining balance depreciation. See the example for more details | Discussion | There are two depreciation functions, DepreciatedValue and Depreciate, the first calculates the value of an asset at a specific point in time, and the second calculates the depreciation during a timeperiod. Depreciate works by simply determining the difference in the value of the asset between the beginning and end of the timeperiod. DepreciatedValue has a list of input parameters that entirely describe the assets life.
- The InitialDate is when the asset is purchased and comes into being in the accounts. It is not necessarily when the asset starts to depreciate.
- The InitialValue is the value at the initial date. The assets depreciated value stays at InitialValue until the asset's value starts to depreciate.
- Depreciation starts on the date denoted by StartDep. This can, and often is, the same as InitialDate, meaning tha depreciation starts immediately. But with this function depreciateion does not have to start immediately.
- Once depreciation starts, the way that the value of the asset declines is determined by LifeOrDecRate and DepType . The LifeOrDecRate parameter works in one of two ways. If you specify an annual rate, as a fraction less than 1 (eg 0.25 for 25% per year), this is the rate of depreciation that is applied, whether its Straight-Line, Declining or DoubleDeclining. If you specify a number greater or equal to 1, then this is used as the lifetime over which the asset is depreciated. Note that the life commences at the start of depreciation, StartDep, not InitialDate. Therefore, LifeOrDecRate=0.25, and LifeOrDecRate=4 amount to the same thing for straight line depreciation. Note that for the Sum Of Years digits type depreciation the life must boild down to and integer number of years.
- DepType determines the TYPE Of depreciation applied between StartDep, when the asset starts to be depreciated, and the end of the assets life as defined by LifeOrDecRate. You can also optionally set a FinalValue, so that the asset value does not have to decline to zero, but perhaps to some other salvage value. The four types of depreciation currently supported and well-documeneted in the literature, they are STRAIGHT-LINE (the value of the asset declines linearly over time), DECLINING (the value declines exponentially, for example each year the asset declines by 25%, or is 75% of its previous years value), DOUBLE-DECLINING (discussed below), and SUM OF YEARS DIGITS.
- Double-declining depreciation is where the value declines according to a logarithmic relationship according to an input factor 'f'. The way you set factor 'f', is to set DepType, as this factor. The function knows that any value other than zero, 1, or 3 for DepType MUST be the factor 'f' for double-declining balance type depreciation. Once f is determined the RATE of decline is determined by using LifeOrDecRate so that the decline rate is equal to the factor divided by LifeOrDecRate (if LifeOrDecRate refers to the life in years of the asset). If LifeOrDecRate refers to a rate of decline, then the life of the asset is determined as factor 'f' divided by this life in years. Once the double-declining rate is established, the value at any point in time is: exp(log(InitialValue)+log(1-rate)*t), where t is the number of years elapsed since depreciation began.
- To recap in overall terms, the depreciation functions model the asset, initially with a zero value, coming into being at time InitialDate. the value of the asset stays at InitialValue, whereupon it starts to depreciate according to DepType and LifeOrDecRate. Depreciation carries on until the assets value reaches zero or the optional FinalValue.
- Note that the asset will STAY at the the value of FinalValue indefinitely - it is the lowermost value this asset can ever have. If you have a non-zero FinalValue and wish to 'cut off' the depreciated value, then the best thing to do is simply wrap your DepreciatedValue function with a Level function which will just return zero if outside its dates limits, for example: Level(TheDate,InitialDate,MyCutOffDate,DepreciatedValue(TheDate,...)).
|
Examples | - Preview of the Depreciate example.
- The above spreadsheet can be accessed from the Quick Reference (on the Business Functions menu), on the Examples menu, or in the Business Functions\Component Examples directory
|
Published Edition Changes in Behaviour This function has experienced some changes in its behaviour over its history. Click here to see more. Version | No | Change In Behaviour |
---|
1 | 143 | InitialDate variable removed because it was superfluous to the start of depreciation. Any function calls using the old system will flag an error and require adjusting (very sorry for any inconvenience). |
|