Partilhar via

Table.PromoteHeaders

  • Artigo

Sintaxe

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

Sobre nós

Transforma a primeira linha de valores nos novos cabeçalhos de coluna (ou seja, nos nomes de coluna). Por padrão, apenas valores de texto ou número são promovidos a cabeçalhos. Opções válidas:

  • PromoteAllScalars: Se definido como true, todos os valores escalares na primeira linha são promovidos a cabeçalhos usando o Culture, se especificado (ou localidade atual do documento). Para valores que não podem ser convertidos em texto, um nome de coluna padrão será usado.
  • Culture: Um nome de cultura especificando a cultura para os dados.

Exemplo 1

Promova a primeira linha de valores na tabela.

Utilização

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

Saída

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

Exemplo 2

Promova todos os escalares na primeira linha da tabela a cabeçalhos.

Utilização

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"]
)

Saída

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

Conteúdo relacionado