pandas.DataFrame.at_time#

DataFrame.at_time(time, asof=False, axis=None)[source]#

Select values at particular time of day (e.g., 9:30AM).

Parameters:

timedatetime.time or str: The values to select.
asofbool, default False: This parameter is currently not supported.
axis{0 or ‘index’, 1 or ‘columns’}, default 0: For Series this parameter is unused and defaults to 0.

Returns:

Series or DataFrame: The values with the specified time.

Raises:

TypeError: If the index is not a DatetimeIndex

See also

between_time: Select values between particular times of the day.
first: Select initial periods of time series based on a date offset.
last: Select final periods of time series based on a date offset.
DatetimeIndex.indexer_at_time: Get just the index locations for values at particular time of the day.

Examples

>>> i = pd.date_range("2018-04-09", periods=4, freq="12h")
>>> ts = pd.DataFrame({"A": [1, 2, 3, 4]}, index=i)
>>> ts
                     A
2018-04-09 00:00:00  1
2018-04-09 12:00:00  2
2018-04-10 00:00:00  3
2018-04-10 12:00:00  4

>>> ts.at_time("12:00")
                     A
2018-04-09 12:00:00  2
2018-04-10 12:00:00  4