pandas.io.formats.style.Styler.format_index_names#

Styler.format_index_names(formatter=None, axis=0, level=None, na_rep=None, precision=None, decimal='.', thousands=None, escape=None, hyperlinks=None)[源代码]#

格式化索引名称或列名称的文本显示值。

Added in version 3.0.

参数:

formatterstr, 可调用对象, dict 或 None: 对象用于定义值的显示方式。请参阅注释。
轴{0, “index”, 1, “columns”}: 是否将格式化器应用于索引或列标题。
级别int, str, list: 应用于通用格式化器的级别。
na_repstr, 可选: 缺失值的表示。如果 na_rep 是 None，则不应用特殊格式。
精度int, 可选: 用于显示目的的浮点精度，如果未由指定的 formatter 确定。
decimalstr, 默认 “.”: 用于浮点数、复数和整数的十进制分隔符。
thousandsstr, 可选, 默认 None: 用于浮点数、复数和整数千位分隔符的字符。
escapestr, 可选: 使用 ‘html’ 将单元格显示字符串中的字符 &, <, >, ', 和 " 替换为 HTML 安全的序列。使用 ‘latex’ 将单元格显示字符串中的字符 &, %, $, #, _, {, }, ~, ^, 和 \ 替换为 LaTeX 安全的序列。在 formatter 之前进行转义。
超链接{“html”, “latex”}, 可选: 如果为“html”，则将包含 https://、http://、ftp:// 或 www. 的字符串模式转换为 HTML <a> 标签作为可点击的 URL 超链接；如果为“latex”，则转换为 LaTeX href 命令。

返回:

Styler: 返回自身以进行链式调用。

引发:

ValueError: 如果 formatter 是一个字符串并且数据类型不兼容。

参见

Styler.format_index: 格式化索引标签或列标题的文本显示值。

备注

这种方法与 Styler.format_index() 有相似的签名。由于 names 通常是基于标签的，并且往往不是数字的，这里预期会更频繁使用的典型功能是 escape 和 hyperlinks。

警告

当使用输出格式 Styler.to_excel 时，Styler.format_index_names 被忽略，因为 Excel 和 Python 具有本质上不同的格式结构。

例子

>>> df = pd.DataFrame(
...     [[1, 2], [3, 4]],
...     index=pd.Index(["a", "b"], name="idx"),
... )
>>> df  
     0  1
idx
a    1  2
b    3  4
>>> df.style.format_index_names(lambda x: x.upper(), axis=0)  
     0  1
IDX
a    1  2
b    3  4