Перейти к основному содержимому

Table.PromoteHeaders

Назначает первую строку значений в качестве новых заголовков столбцов (например, имена столбцов).

Syntax

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

Remarks

Назначает первую строку значений в качестве новых заголовков столбцов (т. е. имен столбцов). По умолчанию заголовками назначаются только текстовые или числовые значения. Допустимые параметры:

PromoteAllScalars: если задано значение true, все скалярные значения в первой строке назначаются заголовками с использованием языка и региональных параметров (Culture), если они указаны (или текущего языкового стандарта документа). Для значений, которые невозможно преобразовать в текст, будет использоваться имя столбца по умолчанию.
Culture: имя языка и региональных параметров для данных.

Examples

Example #1

Повышение уровня первой строки значений в таблице.

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

Result:

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

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

Result:

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

Category

Table.Column operations