website logo
ChartHop documentation
Carrot reference
Product updates
Navigate through spaces
ChartHop documentation
Carrot reference
Product updates
⌘K
Getting started
Getting started with Carrot
Operator precedence
Data categories
Basic Org Information
Compensation
Job Changes
Permissions
Personal
Recruiting
Structure
Time off
Data types
Address
Boolean
Comp
Comp Band
Currency
Date
DateTime
DaysOff
Enum
EnumList
File
Group
Image
Job
List
Money
Name
Number
Null
Percent
Person
PersonList
Shares
StockGrant
String
TimeOff
User
Operators
+ (add)
- (subtract)
* (multiply)
/ (divide)
% (modulus)
&& (and)
|| (or)
if
: (match)
= (equals)
!= (not-equals)
! (not)
> (greater-than)
>= (greater-than-equals)
< (less-than)
<= (less-than-equals)
[ ](array)
. (dot)
? (ternary)
?: (elvis)
Functions
abs()
boolean()
compHistory()
date()
day()
daysOffBetween()
diffYears()
diffMonths()
distance()
monthEnd()
formatMoney()
formatRound()
formatNumber()
formatPercent()
formatDate()
grantedShares()
length()
max()
mean()
money()
month()
min()
nextAnniversary()
number()
pluralize()
percent()
random()
round()
roundUp()
roundDown()
string()
subString()
stockPrice()
monthStart()
split()
vestValue()
vestShares()
year()
Aggregators
count{}
max{}
mean{}
min{}
sum{}
Docs powered by archbee 
4min

diffYears()

Returns the total number of years between two given dates.

Syntax

diffYears(date1, date2)

  • date1 - the date from which counting begins.
  • date2 - the date at which counting ceases.
  • Return type: Number

Sample usage

diffYears('2021-10-11', '2020-10-11') returns 1.

Supported data types

Input type

Return type

Logic

Date (x2)

Number

The function will count the number of years beginning with date1, and ending with date2.

Unsupported data types

Null

Unsupported data types return Null.



Updated 07 Dec 2021
Did this page help you?
Yes
No
UP NEXT
diffMonths()
Docs powered by archbee 
Updated 07 Dec 2021
Did this page help you?
Yes
No
UP NEXT
diffMonths()
Docs powered by archbee 
TABLE OF CONTENTS
Syntax
Sample usage
Supported data types