DateTime.IsInNextNHours

Updated on

DateTime.IsInNextNHours is a Power Query M function that indicates whether the provided date(time) value occurs during the next number of hours specified. The function returns true if the value occurs within the specified hours, otherwise false.

Compatible with: Power BI Service Power BI Desktop Excel Microsoft 365

Syntax

DateTime.IsInNextNHours(
   dateTime as any,
   hours as number,
) as nullable logical

Description

DateTime.IsInNextNHours indicates whether the given dateTime argument (which can be of type datetime or datetimezone) occurs during the next number of hours, as determined by the current date and time on the system. This function will return false for a value within the current hour.

Examples

Determine if the hour after the current system time is in the next two hours.

// Output: true
DateTime.IsInNextNHours( DateTime.FixedLocalNow() + #duration( 0, 2, 0, 0 ), 2 )

Other functions related to DateTime.IsInNextNHours are:

Contribute » | Contributors: Rick de Groot
Microsoft documentation: https://learn.microsoft.com/en-us/powerquery-m/datetime-isinnextnhours