@dgcode/gsheet-utils

google spreadsheet utilities

Install

$ npm install @dgcode/gsheet-utils

Usage

Conversion

import { toColumnString, toColumnNumber, toRowString, toRowNumber } from '@dgcode/gsheet-utils';

toColumnString(1); // 'A'
toColumnString(2); // 'B'
toColumnString(26); // 'Z'
toColumnString(27); // 'AA'
toColumnString(52); // 'AZ'

toRowString(5); // '5'
toRowString(27); // '27'

Validation

import { isSheetTitle, isColumnString, isColumnNumber, isRowString, isRowNumber } from '@dgcode/gsheet-utils';

isSheetTitle('Foo'); // true
isSheetTitle('Foo Bar'); // true

isColumnString('A'); // true
isColumnString('XZ'); // true
isColumnString('a'); // false

isColumnNumber(1); // true
isColumnNumber(0); // false

A1 Notation parsing

import { toA1Notation, parseA1Notation } from '@dgcode/gsheet-utils';

toA1Notation({
  sheetTitle: 'Foo',
  fromColumn: 'A',
  fromRow: 3,
  toColumn: 10,
  toRow: 8
});
// 'Foo!A3:J8'

parseA1Notation('Foo!A3:J8');
// { sheetTitle: 'Foo', fromColumn: 'A', fromRow: '3', toColumn: 'J', toRow: '8' }

parseA1Notation('Foo!A3:J8', Number);
// { sheetTitle: 'Foo', fromColumn: 1, fromRow: 3, toColumn: 10, toRow: 8 }

License

MIT