SqlMethods.DateDiffYear Method

Definition

Counts the number of year boundaries between two specified dates.

Overloads

DateDiffYear(Nullable<DateTime>, Nullable<DateTime>)

Counts the number of year boundaries between two nullable dates.

DateDiffYear(DateTime, DateTime)

Counts the number of year boundaries between two non-nullable dates.

DateDiffYear(DateTimeOffset, DateTimeOffset)

Counts the number of year boundaries between two non-nullable dates.

DateDiffYear(Nullable<DateTimeOffset>, Nullable<DateTimeOffset>)

Counts the number of year boundaries between two nullable dates.

Remarks

Corresponds to the SQL Server DATEDIFF function using year to specify the type of time boundary crossed. For more about this SQL Server function, see DATEDIFF.

DateDiffYear(Nullable<DateTime>, Nullable<DateTime>)

Counts the number of year boundaries between two nullable dates.

public:
 static Nullable<int> DateDiffYear(Nullable<DateTime> startDate, Nullable<DateTime> endDate);
public static int? DateDiffYear (DateTime? startDate, DateTime? endDate);
static member DateDiffYear : Nullable<DateTime> * Nullable<DateTime> -> Nullable<int>
Public Shared Function DateDiffYear (startDate As Nullable(Of DateTime), endDate As Nullable(Of DateTime)) As Nullable(Of Integer)

Parameters

startDate
Nullable<DateTime>

The start date for the time period.

endDate
Nullable<DateTime>

The end date for the time period.

Returns

When both parameters are not null, returns the number of year boundaries between the two specified dates. When one or both parameters are null, returns a null value.

Remarks

Corresponds to the SQL Server DATEDIFF function using year to specify the type of time boundary crossed. For more about this SQL Server function, see DATEDIFF.

Applies to

DateDiffYear(DateTime, DateTime)

Counts the number of year boundaries between two non-nullable dates.

public:
 static int DateDiffYear(DateTime startDate, DateTime endDate);
public static int DateDiffYear (DateTime startDate, DateTime endDate);
static member DateDiffYear : DateTime * DateTime -> int
Public Shared Function DateDiffYear (startDate As DateTime, endDate As DateTime) As Integer

Parameters

startDate
DateTime

The start date for the time period.

endDate
DateTime

The end date for the time period.

Returns

The number of year boundaries between the two specified dates.

Remarks

Corresponds to the SQL Server DATEDIFF function using year to specify the type of time boundary crossed. For more about this SQL Server function, see DATEDIFF.

Applies to

DateDiffYear(DateTimeOffset, DateTimeOffset)

Counts the number of year boundaries between two non-nullable dates.

public:
 static int DateDiffYear(DateTimeOffset startDate, DateTimeOffset endDate);
public static int DateDiffYear (DateTimeOffset startDate, DateTimeOffset endDate);
static member DateDiffYear : DateTimeOffset * DateTimeOffset -> int
Public Shared Function DateDiffYear (startDate As DateTimeOffset, endDate As DateTimeOffset) As Integer

Parameters

startDate
DateTimeOffset

The start date for the time period.

endDate
DateTimeOffset

The end date for the time period.

Returns

The number of year boundaries between the two specified dates.

Remarks

Corresponds to the SQL Server DATEDIFF function using year to specify the type of time boundary crossed. For more about this SQL Server function, see DATEDIFF.

Applies to

DateDiffYear(Nullable<DateTimeOffset>, Nullable<DateTimeOffset>)

Counts the number of year boundaries between two nullable dates.

public:
 static Nullable<int> DateDiffYear(Nullable<DateTimeOffset> startDate, Nullable<DateTimeOffset> endDate);
public static int? DateDiffYear (DateTimeOffset? startDate, DateTimeOffset? endDate);
static member DateDiffYear : Nullable<DateTimeOffset> * Nullable<DateTimeOffset> -> Nullable<int>
Public Shared Function DateDiffYear (startDate As Nullable(Of DateTimeOffset), endDate As Nullable(Of DateTimeOffset)) As Nullable(Of Integer)

Parameters

startDate
Nullable<DateTimeOffset>

The start date for the time period.

endDate
Nullable<DateTimeOffset>

The end date for the time period.

Returns

When both parameters are not null, returns the number of year boundaries between the two specified dates. When one or both parameters are null, returns a null value.

Remarks

Corresponds to the SQL Server DATEDIFF function using year to specify the type of time boundary crossed. For more about this SQL Server function, see DATEDIFF.

Applies to