Pandas2.2 General
Top-level dealing with Interval data
| 方法 | 描述 |
|---|---|
| interval_range([start, end, periods, freq, …]) | 用于生成固定长度的区间序列 |
pandas.interval_range()
pandas.interval_range() 是 Pandas 库中用于生成固定频率的 Interval 对象的函数。这些 Interval 对象表示的是一系列连续的、非重叠的区间。下面是对 pandas.interval_range() 函数每个参数的详细介绍，以及示例和结果。
def interval_range(
start=None,
end=None,
periods=None,
freq=None,
name: Hashable | None = None,
closed: IntervalClosedType = "right",
) -> IntervalIndex:
...
参数介绍
-
start : float, int, datetime-like, or Period-like, optional
- 区间范围的起始值。
- 默认为 0。
-
end : float, int, datetime-like, or Period-like, optional
- 区间范围的结束值。
- 默认为 10。
-
periods : int, optional
- 要生成的区间数量。
- 如果指定了
periods，则start和end参数将被忽略。 - 默认为 50。
-
freq : str or DateOffset, optional
- 每个区间之间的频率间隔。
- 对于数值类型，可以是如 ‘D’（天）、‘H’（小时）、‘T’/‘min’（分钟）、‘S’（秒）等。
- 对于日期时间类型，可以是如 ‘D’（日）、‘W’（周）、‘M’（月）、‘Q’（季度）、‘A’/‘Y’（年）等。
- 默认为 ‘D’（对于日期时间类型）或 1（对于数值类型）。
-
name : str, optional
- 返回的 IntervalIndex 的名称。
- 默认为 None。
-
closed : {‘left’, ‘right’, ‘both’, ‘neither’}, default ‘right’
- 区间的闭合性。
- ‘left’：区间左闭右开。
- ‘right’：区间左开右闭（默认）。
- ‘both’：区间两端都闭合。
- ‘neither’：区间两端都不闭合。
示例 1：生成数值区间
import pandas as pd
# 生成从0到9的整数区间，每个区间间隔为1
intervals = pd.interval_range(start=0, end=10, freq=1)
print(intervals)
结果：
IntervalIndex([(0, 1], (1, 2], (2, 3], (3, 4], (4, 5], (5, 6], (6, 7], (7, 8],
(8, 9], (9, 10]],
dtype='interval[int64, right]')
示例 2：生成日期时间区间
import pandas as pd
# 生成从2023-01-01到2023-01-05的日期时间区间，每个区间间隔为1天
intervals = pd.interval_range(start=pd.Timestamp('2023-01-01'), end=pd.Timestamp('2023-01-05'))
print(intervals)
结果：
IntervalIndex([(2023-01-01 00:00:00, 2023-01-02 00:00:00],
(2023-01-02 00:00:00, 2023-01-03 00:00:00],
(2023-01-03 00:00:00, 2023-01-04 00:00:00],
(2023-01-04 00:00:00, 2023-01-05 00:00:00]],
dtype='interval[datetime64[ns], right]')
示例 3：指定区间数量
import pandas as pd
# 生成5个从0开始的整数区间，每个区间间隔为2
intervals = pd.interval_range(start=0, periods=5, freq=2)
print(intervals)
结果：
IntervalIndex([(0, 2], (2, 4], (4, 6], (6, 8], (8, 10]], dtype='interval[int64, right]')
示例 4：指定区间闭合性
import pandas as pd
# 生成从0到4的整数区间，每个区间间隔为1，区间左闭右开
intervals = pd.interval_range(start=0, end=5, freq=1, closed='left')
print(intervals)
结果：
IntervalIndex([[0, 1), [1, 2), [2, 3), [3, 4), [4, 5)], dtype='interval[int64, left]')
这些示例展示了如何使用 pandas.interval_range() 函数生成不同类型的区间，并可以根据需要调整参数来生成所需的区间范围。