Table.PromoteHeaders

語法

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

關於

將第一個資料列的值升階為新資料行標頭 (亦即，資料行名稱)。 根據預設，只有文字或數值會升階為標頭。 有效選項：

• 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)]})