SqlMethods.DateDiffYear Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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
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.