TypeScript SDK: SheetCoordinates: адреса ячеек
ctx.documents().coordinates() преобразует буквенные адреса ячеек и числовые индексы. Методы работают локально.
Примеры — отдельные фрагменты тела async function run(ctx: Akmelo.Context): Promise<void>. Используйте await только для методов с Promise в сигнатуре.
Методы
columnName
ctx.documents().coordinates().columnName(column) → string
Преобразует положительный номер столбца в буквы: 1 → A, 27 → AA.
const result = ctx.documents().coordinates().columnName(2);
columnNumber
ctx.documents().coordinates().columnNumber(column) → number
Преобразует буквы столбца в номер с единицы. Передавайте только латинские буквы столбца, например B или AA.
const result = ctx.documents().coordinates().columnNumber('B');
position
ctx.documents().coordinates().position(address) → [number, number]
Преобразует адрес вроде B2 в [2, 2]. В TypeScript SDK абсолютные адреса с $ не принимаются.
const result = ctx.documents().coordinates().position('B2');
bounds
ctx.documents().coordinates().bounds(range) → Array<[number, number]>
Разбирает диапазон вроде A1:B3 в массив из двух позиций [row, column]. В TypeScript это не плоский список из четырёх чисел.
const result = ctx.documents().coordinates().bounds('A1:B3');