pandas.Index.rename#

Index.rename(name, inplace=False)[源代码]#

更改索引或多索引名称。

可以在没有关卡的情况下设置新名称。默认返回新索引。名称的长度必须与多重索引中的级数匹配。

参数
name标签或标签列表

要设置的名称。

inplace布尔值,默认为False

直接修改对象,而不是创建新的索引或多重索引。

退货
索引或无

与调用方相同的类型,如果 inplace=True

参见

Index.set_names

能够部分和按级别设置新名称。

示例

>>> idx = pd.Index(['A', 'C', 'A', 'B'], name='score')
>>> idx.rename('grade')
Index(['A', 'C', 'A', 'B'], dtype='object', name='grade')
>>> idx = pd.MultiIndex.from_product([['python', 'cobra'],
...                                   [2018, 2019]],
...                                   names=['kind', 'year'])
>>> idx
MultiIndex([('python', 2018),
            ('python', 2019),
            ( 'cobra', 2018),
            ( 'cobra', 2019)],
           names=['kind', 'year'])
>>> idx.rename(['species', 'year'])
MultiIndex([('python', 2018),
            ('python', 2019),
            ( 'cobra', 2018),
            ( 'cobra', 2019)],
           names=['species', 'year'])
>>> idx.rename('species')
Traceback (most recent call last):
TypeError: Must pass list-like as `names`.