---
title: diffYears()
slug: diffyears
docTags: 
createdAt: 2021-09-14T17:45:36.000Z
---

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](docId\:ucI5tCTfVBhonEJ6ZQijg) 

### Sample usage

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

### Supported data types

| **Input type**                                 | **Return type**                         | **Logic**                                                                                    |
| ---------------------------------------------- | --------------------------------------- | -------------------------------------------------------------------------------------------- |
| ****[Date](docId\:xTAQdzvLBTAKjxRnpFwe9)  (x2) | [Number](docId\:ucI5tCTfVBhonEJ6ZQijg)  | The function will count the number of years beginning with `date1`, and ending with `date2`. |
| *Unsupported data types*                       | **[Null](docId\:N9trVqonnBknqL9DrNBP6)  | Unsupported data types return `Null`.                                                        |