Table.PromoteHeaders

Syntax

Table.PromoteHeaders(table as table, optional options as nullable record) as table

About

将值的第一行提升为新的列标题(即列名)。 默认情况下,仅将文本或数字值提升为标头。 有效选项:

  • PromoteAllScalars:如果设置为 true,则第一行中的所有标量值都使用 Culture指定(或当前文档区域设置)提升为标头。 对于无法转换为文本的值,将使用默认列名。
  • Culture:一个区域性名称,用于指定数据的区域性。

示例 1

提升表中第一行值。

用法

Table.PromoteHeaders(
    Table.FromRecords({
        [Column1 = "CustomerID", Column2 = "Name", Column3 = #date(1980, 1, 1)],
        [Column1 = 1, Column2 = "Bob", Column3 = #date(1980, 1, 1)]
    })
)

输出

Table.FromRecords({[CustomerID = 1, Name = "Bob", Column3 = #date(1980, 1, 1)]})

示例 2

将表第一行中的所有标量提升为标题。

用法

Table.PromoteHeaders(
    Table.FromRecords({
        [Rank = 1, Name = "Name", Date = #date(1980, 1, 1)],
        [Rank = 1, Name = "Bob", Date = #date(1980, 1, 1)]}
    ),
    [PromoteAllScalars = true, Culture = "en-US"]
)

输出

Table.FromRecords({[1 = 1, Name = "Bob", #"1/1/1980" = #date(1980, 1, 1)]})