DateTimeOffsetExtensionsYearsBetween Method

Returns the total number of years between this DateTimeOffset and another DateTimeOffset.

Definition

Namespace: InnerDrive.Core
Assembly: InnerDrive.Core (in InnerDrive.Core.dll) Version: 5.2.9017.0

C#

public static int YearsBetween(
	this DateTimeOffset firstDate,
	DateTimeOffset secondDate
)

Parameters

firstDate DateTimeOffset: This DateTimeOffset value.
secondDate DateTimeOffset: The second DateTimeOffset value.

Return Value

Int32
An Int32 containing the total number of years between firstDate and secondDate.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type DateTimeOffset. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Remarks

The parameters firstDate and secondDate may be specified in any order. If firstDate is less than or equal to secondDate, a positive number will be returned. If firstDate is larger, a negative number will be returned.

First date	Second date	Result
2001-01-15	1999-01-14	-2
2001-01-15	1999-01-15	-1
2001-01-15	2000-01-15	-1
2001-01-15	2000-01-16	0
2001-01-15	2001-01-15	0
2001-01-15	2002-01-14	0
2001-01-15	2002-01-15	1
2001-01-15	2006-01-01	4
2001-01-15	2006-01-14	4
2001-01-15	2006-01-15	5
2001-01-15	2006-12-31	5
2001-01-15	2007-01-14	5

Example

C#

var firstDate = new DateTimeOffset(2012, 1, 1, 0, 0, 0, TimeSpan.Zero);
var secondDate = new DateTimeOffset(2010, 1, 1, 0, 0, 0, TimeSpan.Zero);
? firstDate.YearsBetween(secondDate);

// Result: -2