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