PHP SDK: Адреса и диапазоны Excel

Объект возвращает $ctx->documents()->coordinates(). Создавать объекты самостоятельно в сценарии не требуется.

columnName

columnName(int $column): string

Номер столбца с единицы в буквы: 1 → A, 27 → AA. Допустимо 1–16384.

$coordinates = $ctx->documents()->coordinates();
$name = $coordinates->columnName(27);

columnNumber

columnNumber(string $column): int

Буквы столбца в номер с единицы, регистр не важен. Неверный адрес вызывает ошибку.

$coordinates = $ctx->documents()->coordinates();
$number = $coordinates->columnNumber('AA');

position

position(string $address): array

Адрес ячейки в [строка, столбец], оба с единицы. Поддерживаются абсолютные ссылки $A$1. Адреса с именем листа не принимаются: сначала выберите лист через sheet().

$coordinates = $ctx->documents()->coordinates();
$position = $coordinates->position('AA12');

bounds

bounds(string $range): array

Диапазон в [первая строка, первый столбец, последняя строка, последний столбец]. Одна ячейка допустима, обратные диапазоны вызывают ошибку.

$coordinates = $ctx->documents()->coordinates();
$bounds = $coordinates->bounds('A2:C8');