pandas.DatetimeIndex.indexer_between_time#

DatetimeIndex.indexer_between_time(start_time, end_time, include_start=True, include_end=True)[source]#

Return index locations of values between particular times of day.

Parameters:
start_time, end_timedatetime.time, str

Time passed either as object (datetime.time) or as string in appropriate format (“%H:%M”, “%H%M”, “%I:%M%p”, “%I%M%p”, “%H:%M:%S”, “%H%M%S”, “%I:%M:%S%p”,”%I%M%S%p”).

include_startbool, default True

Include boundaries; whether to set start bound as closed or open.

include_endbool, default True

Include boundaries; whether to set end bound as closed or open.

Returns:
np.ndarray[np.intp]

Index locations of values between particular times of day.

See also

indexer_at_time

Get index locations of values at particular time of day.

DataFrame.between_time

Select values between particular times of day.

Examples

>>> idx = pd.date_range("2023-01-01", periods=4, freq="h")
>>> idx
DatetimeIndex(['2023-01-01 00:00:00', '2023-01-01 01:00:00',
                   '2023-01-01 02:00:00', '2023-01-01 03:00:00'],
                  dtype='datetime64[ns]', freq='h')
>>> idx.indexer_between_time("00:00", "2:00", include_end=False)
array([0, 1])