Halaman ini diterjemahkan oleh Cloud Translation API.

Class Range

Mengakses dan mengubah rentang spreadsheet. Rentang dapat berupa satu sel dalam sheet atau grup sel yang berdekatan dalam sheet.

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`activate()`	`Range`	Menetapkan rentang yang ditentukan sebagai `active range`, dengan sel kiri atas dalam rentang sebagai `current cell`.
`activateAsCurrentCell()`	`Range`	Menetapkan sel yang ditentukan sebagai `current cell`.
`addDeveloperMetadata(key)`	`Range`	Menambahkan metadata developer dengan kunci yang ditentukan ke rentang.
`addDeveloperMetadata(key, visibility)`	`Range`	Menambahkan metadata developer dengan kunci dan visibilitas yang ditentukan ke rentang.
`addDeveloperMetadata(key, value)`	`Range`	Menambahkan metadata developer dengan kunci dan nilai yang ditentukan ke rentang.
`addDeveloperMetadata(key, value, visibility)`	`Range`	Menambahkan metadata developer dengan kunci, nilai, dan visibilitas yang ditentukan ke rentang.
`applyColumnBanding()`	`Banding`	Menerapkan tema banding kolom default ke rentang.
`applyColumnBanding(bandingTheme)`	`Banding`	Menerapkan tema pengelompokan kolom yang ditentukan ke rentang.
`applyColumnBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Menerapkan tema banding kolom yang ditentukan ke rentang dengan setelan header dan footer yang ditentukan.
`applyRowBanding()`	`Banding`	Menerapkan tema pengelompokan baris default ke rentang.
`applyRowBanding(bandingTheme)`	`Banding`	Menerapkan tema banding baris yang ditentukan ke rentang.
`applyRowBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Menerapkan tema pengelompokan baris yang ditentukan ke rentang dengan setelan header dan footer yang ditentukan.
`autoFill(destination, series)`	`void`	Mengisi `destinationRange` dengan data berdasarkan data dalam rentang ini.
`autoFillToNeighbor(series)`	`void`	Menghitung rentang yang akan diisi dengan data baru berdasarkan sel di sekitarnya dan otomatis mengisi rentang tersebut dengan nilai baru berdasarkan data yang terdapat dalam rentang ini.
`breakApart()`	`Range`	Pisahkan sel multi-kolom dalam rentang menjadi sel terpisah lagi.
`canEdit()`	`Boolean`	Menentukan apakah pengguna memiliki izin untuk mengedit setiap sel dalam rentang.
`check()`	`Range`	Mengubah status kotak centang dalam rentang menjadi “ dicentang”.
`clear()`	`Range`	Menghapus rentang konten dan format.
`clear(options)`	`Range`	Menghapus rentang konten, format, aturan validasi data, dan/atau komentar, seperti yang ditentukan dengan opsi lanjutan yang diberikan.
`clearContent()`	`Range`	Menghapus konten rentang, tanpa mengubah pemformatan.
`clearDataValidations()`	`Range`	Menghapus aturan validasi data untuk rentang.
`clearFormat()`	`Range`	Menghapus pemformatan untuk rentang ini.
`clearNote()`	`Range`	Menghapus catatan di sel yang ditentukan.
`collapseGroups()`	`Range`	Menciutkan semua grup yang sepenuhnya berada dalam rentang.
`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Menyalin pemformatan rentang ke lokasi yang ditentukan.
`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Menyalin pemformatan rentang ke lokasi yang ditentukan.
`copyTo(destination)`	`void`	Menyalin data dari rentang sel ke rentang sel lain.
`copyTo(destination, copyPasteType, transposed)`	`void`	Menyalin data dari rentang sel ke rentang sel lain.
`copyTo(destination, options)`	`void`	Menyalin data dari rentang sel ke rentang sel lain.
`copyValuesToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Menyalin konten rentang ke lokasi yang ditentukan.
`copyValuesToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Menyalin konten rentang ke lokasi yang ditentukan.
`createDataSourcePivotTable(dataSource)`	`DataSourcePivotTable`	Membuat tabel pivot sumber data kosong dari sumber data, yang disematkan di sel pertama dalam rentang ini.
`createDataSourceTable(dataSource)`	`DataSourceTable`	Membuat tabel sumber data kosong dari sumber data, yang disematkan di sel pertama dalam rentang ini.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Menampilkan DeveloperMetadataFinderApi untuk menemukan metadata developer dalam cakupan rentang ini.
`createFilter()`	`Filter`	Membuat filter dan menerapkannya ke rentang yang ditentukan pada sheet.
`createPivotTable(sourceData)`	`PivotTable`	Membuat tabel pivot kosong dari `sourceData` yang ditentukan dan disematkan di sel pertama dalam rentang ini.
`createTextFinder(findText)`	`TextFinder`	Membuat pencari teks untuk rentang, yang dapat menemukan dan mengganti teks dalam rentang ini.
`deleteCells(shiftDimension)`	`void`	Menghapus rentang sel ini.
`expandGroups()`	`Range`	Memperluas grup yang diciutkan yang rentang atau tombol kontrolnya bersimpangan dengan rentang ini.
`getA1Notation()`	`String`	Menampilkan deskripsi string rentang, dalam notasi A1.
`getBackground()`	`String`	Menampilkan warna latar belakang sel kiri atas dalam rentang (misalnya, `'#ffffff'`).
`getBackgroundObject()`	`Color`	Menampilkan warna latar belakang sel kiri atas dalam rentang.
`getBackgroundObjects()`	`Color[][]`	Menampilkan warna latar belakang sel dalam rentang.
`getBackgrounds()`	`String[][]`	Menampilkan warna latar belakang sel dalam rentang (misalnya, `'#ffffff'`).
`getBandings()`	`Banding[]`	Menampilkan semua banding yang diterapkan ke sel apa pun dalam rentang ini.
`getCell(row, column)`	`Range`	Menampilkan sel tertentu dalam rentang.
`getColumn()`	`Integer`	Menampilkan posisi kolom awal untuk rentang ini.
`getDataRegion()`	`Range`	Menampilkan salinan rentang yang diperluas dalam empat `Direction` kardinal untuk mencakup semua sel yang berdekatan dengan data di dalamnya.
`getDataRegion(dimension)`	`Range`	Menampilkan salinan rentang yang diperluas `Direction.UP` dan `Direction.DOWN` jika dimensi yang ditentukan adalah `Dimension.ROWS`, atau `Direction.NEXT` dan `Direction.PREVIOUS` jika dimensinya adalah `Dimension.COLUMNS`.
`getDataSourceFormula()`	`DataSourceFormula`	Menampilkan `DataSourceFormula` untuk sel pertama dalam rentang, atau `null` jika sel tidak berisi formula sumber data.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Menampilkan `DataSourceFormula` untuk sel dalam rentang.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Mendapatkan semua tabel pivot sumber data yang berpotongan dengan rentang.
`getDataSourceTables()`	`DataSourceTable[]`	Mendapatkan semua tabel sumber data yang berpotongan dengan rentang.
`getDataSourceUrl()`	`String`	Menampilkan URL untuk data dalam rentang ini, yang dapat digunakan untuk membuat diagram dan kueri.
`getDataTable()`	`DataTable`	Menampilkan data di dalam objek ini sebagai DataTable.
`getDataTable(firstRowIsHeader)`	`DataTable`	Menampilkan data di dalam rentang ini sebagai DataTable.
`getDataValidation()`	`DataValidation`	Menampilkan aturan validasi data untuk sel kiri atas dalam rentang.
`getDataValidations()`	`DataValidation[][]`	Menampilkan aturan validasi data untuk semua sel dalam rentang.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	Mendapatkan metadata developer yang terkait dengan rentang ini.
`getDisplayValue()`	`String`	Menampilkan nilai sel kiri atas yang ditampilkan dalam rentang.
`getDisplayValues()`	`String[][]`	Menampilkan petak nilai persegi panjang untuk rentang ini.
`getFilter()`	`Filter`	Menampilkan filter di sheet tempat rentang ini berada, atau `null` jika tidak ada filter di sheet.
`getFontColorObject()`	`Color`	Menampilkan warna font sel di sudut kiri atas rentang.
`getFontColorObjects()`	`Color[][]`	Menampilkan warna font sel dalam rentang.
`getFontFamilies()`	`String[][]`	Menampilkan jenis font sel dalam rentang.
`getFontFamily()`	`String`	Menampilkan jenis font sel di pojok kiri atas rentang.
`getFontLine()`	`String`	Mendapatkan gaya garis sel di sudut kiri atas rentang (`'underline'`, `'line-through'`, atau `'none'`).
`getFontLines()`	`String[][]`	Mendapatkan gaya garis sel dalam rentang (`'underline'`, `'line-through'`, atau `'none'`).
`getFontSize()`	`Integer`	Menampilkan ukuran font dalam ukuran titik sel di sudut kiri atas rentang.
`getFontSizes()`	`Integer[][]`	Menampilkan ukuran font sel dalam rentang.
`getFontStyle()`	`String`	Menampilkan gaya font (`'italic'` atau `'normal'`) sel di pojok kiri atas rentang.
`getFontStyles()`	`String[][]`	Menampilkan gaya font sel dalam rentang.
`getFontWeight()`	`String`	Menampilkan ketebalan font (normal/tebal) sel di pojok kiri atas rentang.
`getFontWeights()`	`String[][]`	Menampilkan ketebalan font sel dalam rentang.
`getFormula()`	`String`	Menampilkan formula (notasi A1) untuk sel kiri atas rentang, atau string kosong jika sel kosong atau tidak berisi formula.
`getFormulaR1C1()`	`String`	Menampilkan formula (notasi R1C1) untuk sel tertentu, atau `null` jika tidak ada.
`getFormulas()`	`String[][]`	Menampilkan formula (notasi A1) untuk sel dalam rentang.
`getFormulasR1C1()`	`String[][]`	Menampilkan formula (notasi R1C1) untuk sel dalam rentang.
`getGridId()`	`Integer`	Menampilkan ID petak dari sheet induk rentang.
`getHeight()`	`Integer`	Menampilkan tinggi rentang.
`getHorizontalAlignment()`	`String`	Menampilkan perataan horizontal teks (kiri/tengah/kanan) sel di sudut kiri atas rentang.
`getHorizontalAlignments()`	`String[][]`	Menampilkan perataan horizontal sel dalam rentang.
`getLastColumn()`	`Integer`	Menampilkan posisi kolom akhir.
`getLastRow()`	`Integer`	Menampilkan posisi baris akhir.
`getMergedRanges()`	`Range[]`	Menampilkan array objek `Range` yang mewakili sel gabungan yang sepenuhnya berada dalam rentang saat ini, atau berisi setidaknya satu sel dalam rentang saat ini.
`getNextDataCell(direction)`	`Range`	Mulai dari sel di kolom dan baris pertama rentang, menampilkan sel berikutnya di arah yang ditentukan, yaitu tepi rentang sel yang berdekatan dengan data di dalamnya atau sel di tepi spreadsheet dalam arah tersebut.
`getNote()`	`String`	Menampilkan catatan yang terkait dengan rentang yang diberikan.
`getNotes()`	`String[][]`	Menampilkan catatan yang terkait dengan sel dalam rentang.
`getNumColumns()`	`Integer`	Menampilkan jumlah kolom dalam rentang ini.
`getNumRows()`	`Integer`	Menampilkan jumlah baris dalam rentang ini.
`getNumberFormat()`	`String`	Mendapatkan pemformatan angka atau tanggal sel kiri atas dari rentang yang diberikan.
`getNumberFormats()`	`String[][]`	Menampilkan format angka atau tanggal untuk sel dalam rentang.
`getRichTextValue()`	`RichTextValue`	Menampilkan nilai Rich Text untuk sel kiri atas rentang, atau `null` jika nilai sel bukan teks.
`getRichTextValues()`	`RichTextValue[][]`	Menampilkan nilai Teks Kaya untuk sel dalam rentang.
`getRow()`	`Integer`	Menampilkan posisi baris untuk rentang ini.
`getRowIndex()`	`Integer`	Menampilkan posisi baris untuk rentang ini.
`getSheet()`	`Sheet`	Menampilkan sheet tempat rentang ini berada.
`getTextDirection()`	`TextDirection`	Menampilkan arah teks untuk sel kiri atas rentang.
`getTextDirections()`	`TextDirection[][]`	Menampilkan arah teks untuk sel dalam rentang.
`getTextRotation()`	`TextRotation`	Menampilkan setelan rotasi teks untuk sel kiri atas rentang.
`getTextRotations()`	`TextRotation[][]`	Menampilkan setelan rotasi teks untuk sel dalam rentang.
`getTextStyle()`	`TextStyle`	Menampilkan gaya teks untuk sel kiri atas rentang.
`getTextStyles()`	`TextStyle[][]`	Menampilkan gaya teks untuk sel dalam rentang.
`getValue()`	`Object`	Menampilkan nilai sel kiri atas dalam rentang.
`getValues()`	`Object[][]`	Menampilkan petak nilai persegi panjang untuk rentang ini.
`getVerticalAlignment()`	`String`	Menampilkan perataan vertikal (atas/tengah/bawah) sel di pojok kiri atas rentang.
`getVerticalAlignments()`	`String[][]`	Menampilkan perataan vertikal sel dalam rentang.
`getWidth()`	`Integer`	Menampilkan lebar rentang dalam kolom.
`getWrap()`	`Boolean`	Menampilkan apakah teks dalam sel disambungkan.
`getWrapStrategies()`	`WrapStrategy[][]`	Menampilkan strategi penggabungan teks untuk sel dalam rentang.
`getWrapStrategy()`	`WrapStrategy`	Menampilkan strategi penggabungan teks untuk sel kiri atas rentang.
`getWraps()`	`Boolean[][]`	Menampilkan apakah teks dalam sel disambungkan.
`insertCells(shiftDimension)`	`Range`	Menyisipkan sel kosong ke dalam rentang ini.
`insertCheckboxes()`	`Range`	Menyisipkan kotak centang ke setiap sel dalam rentang, yang dikonfigurasi dengan `true` untuk dicentang dan `false` untuk tidak dicentang.
`insertCheckboxes(checkedValue)`	`Range`	Menyisipkan kotak centang ke setiap sel dalam rentang, yang dikonfigurasi dengan nilai kustom untuk dicentang dan string kosong untuk tidak dicentang.
`insertCheckboxes(checkedValue, uncheckedValue)`	`Range`	Menyisipkan kotak centang ke setiap sel dalam rentang, yang dikonfigurasi dengan nilai kustom untuk status dicentang dan tidak dicentang.
`isBlank()`	`Boolean`	Menampilkan `true` jika rentang benar-benar kosong.
`isChecked()`	`Boolean`	Menampilkan apakah semua sel dalam rentang memiliki status kotak centang sebagai 'checked'.
`isEndColumnBounded()`	`Boolean`	Menentukan apakah akhir rentang terikat ke kolom tertentu.
`isEndRowBounded()`	`Boolean`	Menentukan apakah akhir rentang terikat ke baris tertentu.
`isPartOfMerge()`	`Boolean`	Menampilkan `true` jika sel dalam rentang saat ini tumpang-tindih dengan sel yang digabungkan.
`isStartColumnBounded()`	`Boolean`	Menentukan apakah awal rentang terikat ke kolom tertentu.
`isStartRowBounded()`	`Boolean`	Menentukan apakah awal rentang terikat ke baris tertentu.
`merge()`	`Range`	Menggabungkan sel dalam rentang menjadi satu blok.
`mergeAcross()`	`Range`	Menggabungkan sel dalam rentang di seluruh kolom rentang.
`mergeVertically()`	`Range`	Menggabungkan sel dalam rentang.
`moveTo(target)`	`void`	Potong dan tempel (format dan nilai) dari rentang ini ke rentang target.
`offset(rowOffset, columnOffset)`	`Range`	Menampilkan rentang baru yang di-offset dari rentang ini dengan jumlah baris dan kolom tertentu (yang dapat negatif).
`offset(rowOffset, columnOffset, numRows)`	`Range`	Menampilkan rentang baru yang relatif terhadap rentang saat ini, yang titik kiri atas di-offset dari rentang saat ini oleh baris dan kolom yang diberikan, dan dengan tinggi yang diberikan dalam sel.
`offset(rowOffset, columnOffset, numRows, numColumns)`	`Range`	Menampilkan rentang baru yang relatif terhadap rentang saat ini, yang titik kiri atas dioffset dari rentang saat ini oleh baris dan kolom yang diberikan, dan dengan tinggi dan lebar yang diberikan di sel.
`protect()`	`Protection`	Membuat objek yang dapat melindungi rentang agar tidak diedit kecuali oleh pengguna yang memiliki izin.
`randomize()`	`Range`	Mengacak urutan baris dalam rentang yang ditentukan.
`removeCheckboxes()`	`Range`	Menghapus semua kotak centang dari rentang.
`removeDuplicates()`	`Range`	Menghapus baris dalam rentang ini yang berisi nilai yang merupakan duplikat dari nilai di baris sebelumnya.
`removeDuplicates(columnsToCompare)`	`Range`	Menghapus baris dalam rentang ini yang berisi nilai di kolom yang ditentukan yang merupakan duplikat nilai baris sebelumnya.
`setBackground(color)`	`Range`	Menetapkan warna latar belakang semua sel dalam rentang dalam notasi CSS (seperti `'#ffffff'` atau `'white'`).
`setBackgroundObject(color)`	`Range`	Menetapkan warna latar belakang semua sel dalam rentang.
`setBackgroundObjects(color)`	`Range`	Menetapkan petak persegi panjang warna latar belakang (harus cocok dengan dimensi rentang ini).
`setBackgroundRGB(red, green, blue)`	`Range`	Menetapkan latar belakang ke warna yang diberikan menggunakan nilai RGB (bilangan bulat antara 0 dan 255 inklusif).
`setBackgrounds(color)`	`Range`	Menetapkan petak persegi panjang warna latar belakang (harus cocok dengan dimensi rentang ini).
`setBorder(top, left, bottom, right, vertical, horizontal)`	`Range`	Menetapkan properti batas.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`Range`	Menetapkan properti batas dengan warna dan/atau gaya.
`setDataValidation(rule)`	`Range`	Menetapkan satu aturan validasi data untuk semua sel dalam rentang.
`setDataValidations(rules)`	`Range`	Menetapkan aturan validasi data untuk semua sel dalam rentang.
`setFontColor(color)`	`Range`	Menetapkan warna font dalam notasi CSS (seperti `'#ffffff'` atau `'white'`).
`setFontColorObject(color)`	`Range`	Menetapkan warna font rentang yang diberikan.
`setFontColorObjects(colors)`	`Range`	Menetapkan petak persegi panjang warna font (harus cocok dengan dimensi rentang ini).
`setFontColors(colors)`	`Range`	Menetapkan petak persegi panjang warna font (harus cocok dengan dimensi rentang ini).
`setFontFamilies(fontFamilies)`	`Range`	Menetapkan petak persegi panjang jenis font (harus cocok dengan dimensi rentang ini).
`setFontFamily(fontFamily)`	`Range`	Menetapkan jenis font, seperti "Arial" atau "Helvetica".
`setFontLine(fontLine)`	`Range`	Menetapkan gaya garis font dari rentang yang diberikan (`'underline'`, `'line-through'`, atau `'none'`).
`setFontLines(fontLines)`	`Range`	Menetapkan petak persegi panjang gaya garis (harus cocok dengan dimensi rentang ini).
`setFontSize(size)`	`Range`	Menetapkan ukuran font, dengan ukuran yang merupakan ukuran titik yang akan digunakan.
`setFontSizes(sizes)`	`Range`	Menetapkan petak persegi panjang ukuran font (harus cocok dengan dimensi rentang ini).
`setFontStyle(fontStyle)`	`Range`	Menetapkan gaya font untuk rentang yang diberikan (`'italic'` atau `'normal'`).
`setFontStyles(fontStyles)`	`Range`	Menetapkan petak persegi panjang gaya font (harus cocok dengan dimensi rentang ini).
`setFontWeight(fontWeight)`	`Range`	Menetapkan ketebalan font untuk rentang yang diberikan (normal/tebal).
`setFontWeights(fontWeights)`	`Range`	Menetapkan petak persegi panjang ketebalan font (harus cocok dengan dimensi rentang ini).
`setFormula(formula)`	`Range`	Memperbarui formula untuk rentang ini.
`setFormulaR1C1(formula)`	`Range`	Memperbarui formula untuk rentang ini.
`setFormulas(formulas)`	`Range`	Menetapkan petak persegi panjang formula (harus cocok dengan dimensi rentang ini).
`setFormulasR1C1(formulas)`	`Range`	Menetapkan petak persegi panjang formula (harus cocok dengan dimensi rentang ini).
`setHorizontalAlignment(alignment)`	`Range`	Tetapkan perataan horizontal (kiri ke kanan) untuk rentang yang diberikan (kiri/tengah/kanan).
`setHorizontalAlignments(alignments)`	`Range`	Menetapkan petak persegi panjang perataan horizontal.
`setNote(note)`	`Range`	Menetapkan catatan ke nilai yang diberikan.
`setNotes(notes)`	`Range`	Menetapkan petak persegi panjang catatan (harus cocok dengan dimensi rentang ini).
`setNumberFormat(numberFormat)`	`Range`	Menetapkan format angka atau tanggal ke string pemformatan yang diberikan.
`setNumberFormats(numberFormats)`	`Range`	Menetapkan petak persegi panjang format angka atau tanggal (harus cocok dengan dimensi rentang ini).
`setRichTextValue(value)`	`Range`	Menetapkan nilai Teks Kaya untuk sel dalam rentang.
`setRichTextValues(values)`	`Range`	Menetapkan petak persegi panjang nilai Rich Text.
`setShowHyperlink(showHyperlink)`	`Range`	Menetapkan apakah rentang harus menampilkan hyperlink atau tidak.
`setTextDirection(direction)`	`Range`	Menetapkan arah teks untuk sel dalam rentang.
`setTextDirections(directions)`	`Range`	Menetapkan petak persegi panjang arah teks.
`setTextRotation(degrees)`	`Range`	Menetapkan setelan rotasi teks untuk sel dalam rentang.
`setTextRotation(rotation)`	`Range`	Menetapkan setelan rotasi teks untuk sel dalam rentang.
`setTextRotations(rotations)`	`Range`	Menetapkan petak persegi panjang rotasi teks.
`setTextStyle(style)`	`Range`	Menetapkan gaya teks untuk sel dalam rentang.
`setTextStyles(styles)`	`Range`	Menetapkan petak persegi panjang gaya teks.
`setValue(value)`	`Range`	Menetapkan nilai rentang.
`setValues(values)`	`Range`	Menetapkan petak nilai persegi panjang (harus cocok dengan dimensi rentang ini).
`setVerticalAlignment(alignment)`	`Range`	Tetapkan perataan vertikal (atas ke bawah) untuk rentang yang diberikan (atas/tengah/bawah).
`setVerticalAlignments(alignments)`	`Range`	Menetapkan petak persegi panjang dari perataan vertikal (harus cocok dengan dimensi rentang ini).
`setVerticalText(isVertical)`	`Range`	Menetapkan apakah akan menumpuk teks untuk sel dalam rentang atau tidak.
`setWrap(isWrapEnabled)`	`Range`	Menetapkan penggabungan sel dari rentang yang diberikan.
`setWrapStrategies(strategies)`	`Range`	Menetapkan petak persegi panjang strategi penggabungan.
`setWrapStrategy(strategy)`	`Range`	Menetapkan strategi penggabungan teks untuk sel dalam rentang.
`setWraps(isWrapEnabled)`	`Range`	Menetapkan petak persegi panjang kebijakan penggabungan kata (harus cocok dengan dimensi rentang ini).
`shiftColumnGroupDepth(delta)`	`Range`	Mengubah kedalaman pengelompokan kolom rentang dengan jumlah yang ditentukan.
`shiftRowGroupDepth(delta)`	`Range`	Mengubah kedalaman pengelompokan baris rentang dengan jumlah yang ditentukan.
`sort(sortSpecObj)`	`Range`	Menyortir sel dalam rentang yang diberikan, menurut kolom dan urutan yang ditentukan.
`splitTextToColumns()`	`void`	Memisahkan kolom teks menjadi beberapa kolom berdasarkan pemisah yang terdeteksi secara otomatis.
`splitTextToColumns(delimiter)`	`void`	Memisahkan kolom teks menjadi beberapa kolom menggunakan string yang ditentukan sebagai pembatas kustom.
`splitTextToColumns(delimiter)`	`void`	Memisahkan kolom teks menjadi beberapa kolom berdasarkan pemisah yang ditentukan.
`trimWhitespace()`	`Range`	Memangkas spasi kosong (seperti spasi, tab, atau baris baru) di setiap sel dalam rentang ini.
`uncheck()`	`Range`	Mengubah status kotak centang dalam rentang menjadi “tidak dicentang”.

Metode yang tidak digunakan lagi

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`getFontColor()`	`String`	Menampilkan warna font sel di sudut kiri atas rentang, dalam notasi CSS (seperti `'#ffffff'` atau `'white'`).
`getFontColors()`	`String[][]`	Menampilkan warna font sel dalam rentang dalam notasi CSS (seperti `'#ffffff'` atau `'white'`).

Dokumentasi mendetail

`activate()`

Menetapkan rentang yang ditentukan sebagai active range, dengan sel kiri atas dalam rentang sebagai current cell.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('A1:D10');
range.activate();

const selection = sheet.getSelection();
// Current cell: A1
const currentCell = selection.getCurrentCell();
// Active Range: A1:D10
const activeRange = selection.getActiveRange();

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

`activateAsCurrentCell()`

Menetapkan sel yang ditentukan sebagai current cell.

Jika sel yang ditentukan ada dalam rentang yang ada, rentang tersebut akan menjadi rentang aktif dengan sel sebagai sel saat ini.

Jika sel yang ditentukan tidak ada dalam rentang yang ada, pemilihan yang ada akan dihapus dan sel menjadi sel saat ini dan rentang aktif.

Catatan: Range yang ditentukan harus terdiri dari satu sel, jika tidak, akan menampilkan pengecualian.

// Gets the first sheet of the spreadsheet.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];

// Gets the cell B5 and sets it as the active cell.
const range = sheet.getRange('B5');
const currentCell = range.activateAsCurrentCell();

// Logs the activated cell.
console.log(currentCell.getA1Notation());

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key)`

Menambahkan metadata developer dengan kunci yang ditentukan ke rentang.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' to the developer metadata for row 2.
range.addDeveloperMetadata('NAME');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());

Parameter

Nama	Jenis	Deskripsi
`key`	`String`	Kunci untuk metadata developer baru.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, visibility)`

Menambahkan metadata developer dengan kunci dan visibilitas yang ditentukan ke rentang.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the developer metadata visibility to 'DOCUMENT'
// for row 2 on Sheet1.
range.addDeveloperMetadata(
    'NAME',
    SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT,
);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getVisibility().toString());

Parameter

Nama	Jenis	Deskripsi
`key`	`String`	Kunci untuk metadata developer baru.
`visibility`	`DeveloperMetadataVisibility`	Visibilitas metadata developer baru.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, value)`

Menambahkan metadata developer dengan kunci dan nilai yang ditentukan ke rentang.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 of Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the value to 'GOOGLE' for the metadata of row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());

Parameter

Nama	Jenis	Deskripsi
`key`	`String`	Kunci untuk metadata developer baru.
`value`	`String`	Nilai untuk metadata developer baru.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, value, visibility)`

Menambahkan metadata developer dengan kunci, nilai, dan visibilitas yang ditentukan ke rentang.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility
// to PROJECT for row 2 on the sheet.
range.addDeveloperMetadata(
    'NAME',
    'GOOGLE',
    SpreadsheetApp.DeveloperMetadataVisibility.PROJECT,
);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

Parameter

Nama	Jenis	Deskripsi
`key`	`String`	Kunci untuk metadata developer baru.
`value`	`String`	Nilai untuk metadata developer baru.
`visibility`	`DeveloperMetadataVisibility`	Visibilitas metadata developer baru.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`applyColumnBanding()`

Menerapkan tema banding kolom default ke rentang. Secara default, banding memiliki header dan tidak memiliki warna footer.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies column banding to row 2.
const colBanding = range.applyColumnBanding();

// Gets the first banding on the sheet and logs the color of the header column.
console.log(
    sheet.getBandings()[0]
        .getHeaderColumnColorObject()
        .asRgbColor()
        .asHexString(),
);

// Gets the first banding on the sheet and logs the color of the second column.
console.log(
    sheet.getBandings()[0]
        .getSecondColumnColorObject()
        .asRgbColor()
        .asHexString(),
);

Pulang pergi

Banding — Banding baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`applyColumnBanding(bandingTheme)`

Menerapkan tema pengelompokan kolom yang ditentukan ke rentang. Secara default, banding memiliki header dan tidak memiliki warna footer.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies the INDIGO color banding theme to the columns in row 2.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the first banding on the sheet and logs the color of the second column.
console.log(
    sheet.getBandings()[0]
        .getSecondColumnColorObject()
        .asRgbColor()
        .asHexString(),
);

Parameter

Nama	Jenis	Deskripsi
`bandingTheme`	`BandingTheme`	Tema warna yang akan diterapkan ke kolom dalam rentang.

Pulang pergi

Banding — Banding baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`applyColumnBanding(bandingTheme, showHeader, showFooter)`

Menerapkan tema banding kolom yang ditentukan ke rentang dengan setelan header dan footer yang ditentukan.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 12-22 on the sheet.
const range = sheet.getRange('12:22');

// Applies the BLUE color banding theme to rows 12-22.
// Sets the header visibility to false and the footer visibility to true.
const colBanding = range.applyColumnBanding(
    SpreadsheetApp.BandingTheme.BLUE,
    false,
    true,
);

// Gets the banding color and logs it to the console.
console.log(
    sheet.getBandings()[0]
        .getSecondColumnColorObject()
        .asRgbColor()
        .asHexString(),
);

// Gets the header color object and logs it to the console. Returns null because
// the header visibility is set to false.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject());

// Gets the footer color and logs it to the console.
console.log(
    sheet.getBandings()[0]
        .getFooterColumnColorObject()
        .asRgbColor()
        .asHexString(),
);

Parameter

Nama	Jenis	Deskripsi
`bandingTheme`	`BandingTheme`	Tema warna yang akan diterapkan ke kolom dalam rentang.
`showHeader`	`Boolean`	Jika `true`, warna header tema banding diterapkan ke kolom pertama.
`showFooter`	`Boolean`	Jika `true`, warna footer tema banding diterapkan ke kolom terakhir.

Pulang pergi

Banding — Banding baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`applyRowBanding()`

Menerapkan tema pengelompokan baris default ke rentang. Secara default, banding memiliki header dan tidak memiliki warna footer.

// Opens the spreadsheet by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies row banding to rows 1-30.
range.applyRowBanding();

// Gets the hex color of the second banded row.
const secondRowColor =
    range.getBandings()[0].getSecondRowColorObject().asRgbColor().asHexString();

// Logs the hex color to console.
console.log(secondRowColor);

Pulang pergi

Banding — Banding.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`applyRowBanding(bandingTheme)`

Menerapkan tema banding baris yang ditentukan ke rentang. Secara default, banding memiliki header dan tidak memiliki warna footer.

// Opens the spreadsheet by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies the INDIGO row banding theme to rows 1-30.
range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the hex color of the second banded row.
const secondRowColor =
    range.getBandings()[0].getSecondRowColorObject().asRgbColor().asHexString();

// Logs the hex color to console.
console.log(secondRowColor);

Parameter

Nama	Jenis	Deskripsi
`bandingTheme`	`BandingTheme`	Tema warna yang akan diterapkan ke baris dalam rentang.

Pulang pergi

Banding — Banding baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`applyRowBanding(bandingTheme, showHeader, showFooter)`

Menerapkan tema pengelompokan baris yang ditentukan ke rentang dengan setelan header dan footer yang ditentukan.

// Opens the spreadsheet by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies the INDIGO row banding to rows 1-30 and
// specifies to hide the header and show the footer.
range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO, false, true);

Parameter

Nama	Jenis	Deskripsi
`bandingTheme`	`BandingTheme`	Tema warna yang akan diterapkan ke baris dalam rentang.
`showHeader`	`Boolean`	Jika `true`, warna header tema banding diterapkan ke baris pertama.
`showFooter`	`Boolean`	Jika `true`, warna footer tema banding diterapkan ke baris terakhir.

Pulang pergi

Banding — Banding baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`autoFill(destination, series)`

Mengisi destinationRange dengan data berdasarkan data dalam rentang ini. Nilai baru juga ditentukan oleh jenis series yang ditentukan. Rentang tujuan harus berisi rentang ini dan memperluasnya hanya dalam satu arah. Misalnya, kode berikut mengisi A1:A20 dengan serangkaian angka yang meningkat berdasarkan nilai saat ini di A1:A4:

const sheet = SpreadsheetApp.getActiveSheet();

// Has values [1, 2, 3, 4].
const sourceRange = sheet.getRange('A1:A4');
// The range to fill with values.
const destination = sheet.getRange('A1:A20');

// Inserts new values in A5:A20, continuing the pattern expressed in A1:A4
sourceRange.autoFill(destination, SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

Parameter

Nama	Jenis	Deskripsi
`destination`	`Range`	Rentang yang akan diisi otomatis dengan nilai. Rentang tujuan harus berisi rentang ini dan memperluasnya hanya dalam satu arah (ke atas, ke bawah, ke kiri, atau kanan).
`series`	`AutoFillSeries`	Jenis deret isi otomatis yang harus digunakan untuk menghitung nilai baru. Efek deret ini berbeda-beda berdasarkan jenis dan jumlah data sumber.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`autoFillToNeighbor(series)`

Menghitung rentang yang akan diisi dengan data baru berdasarkan sel di sekitarnya dan otomatis mengisi rentang tersebut dengan nilai baru berdasarkan data yang terdapat dalam rentang ini. Nilai baru ini juga ditentukan oleh jenis series yang ditentukan.

Rentang tujuan yang dihitung mempertimbangkan data di sekitarnya untuk menentukan tempat nilai baru harus disisipkan: jika ada data di sebelah kiri atau kanan kolom yang diisi otomatis, nilai baru hanya akan diperluas sejauh data yang berdekatan ini.

Misalnya, jika A1:A20 diisi dengan serangkaian angka yang bertambah dan metode ini dipanggil pada rentang B1:B4 yang berisi serangkaian tanggal, nilai baru hanya disisipkan ke B5:B20. Dengan cara ini, nilai baru ini "melekat" ke sel yang berisi nilai di kolom A.

const sheet = SpreadsheetApp.getActiveSheet();

// A1:A20 has values [1, 2, 3, ... 20].
// B1:B4 has values [1/1/2017, 1/2/2017, ...]
const sourceRange = sheet.getRange('B1:B4');

// Results in B5:B20 having values [1/5/2017, ... 1/20/2017]
sourceRange.autoFillToNeighbor(SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

Parameter

Nama	Jenis	Deskripsi
`series`	`AutoFillSeries`	Jenis deret isi otomatis yang harus digunakan untuk menghitung nilai baru. Pengaruh deret ini berbeda-beda berdasarkan jenis dan jumlah data sumber.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`breakApart()`

Pisahkan sel multi-kolom dalam rentang menjadi sel terpisah lagi.

Memanggil fungsi ini pada rentang sama dengan memilih rentang dan mengklik Format > Gabungkan sel > Pisahkan.

// Opens the spreadsheet by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6 on Sheet1.
const range = sheet.getRange('A1:C6');

// Unmerges the range A1:C6 into individual cells.
range.breakApart();

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`canEdit()`

Menentukan apakah pengguna memiliki izin untuk mengedit setiap sel dalam rentang. Pemilik spreadsheet selalu dapat mengedit rentang dan sheet yang dilindungi.

// Opens the spreadsheet by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6 on Sheet1.
const range = sheet.getRange('A1:C6');

// Logs whether the user has permission to edit every cell in the range.
console.log(range.canEdit());

Pulang pergi

Boolean — true jika pengguna memiliki izin untuk mengedit setiap sel dalam rentang; false jika tidak.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`check()`

Mengubah status kotak centang dalam rentang menjadi “ dicentang”. Mengabaikan sel dalam rentang yang saat ini tidak berisi nilai dicentang atau tidak dicentang yang dikonfigurasi.

// Changes the state of cells which currently contain either the checked or
// unchecked value configured in the range A1:B10 to 'checked'.
const range = SpreadsheetApp.getActive().getRange('A1:B10');
range.check();

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clear()`

Menghapus rentang konten dan format.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:D10');
range.clear();

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clear(options)`

Menghapus rentang konten, format, aturan validasi data, dan/atau komentar, seperti yang ditentukan dengan opsi lanjutan yang diberikan. Secara default, semua data akan dihapus.

// The code below clears range C2:G7 in the active sheet, but preserves the
// format, data validation rules, and comments.
SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 5).clear({
  contentsOnly: true
});

Parameter

Nama	Jenis	Deskripsi
`options`	`Object`	Objek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah.

Parameter lanjutan

Nama	Jenis	Deskripsi
`commentsOnly`	`Boolean`	Apakah hanya akan menghapus komentar.
`contentsOnly`	`Boolean`	Apakah hanya akan menghapus konten.
`formatOnly`	`Boolean`	Apakah hanya akan menghapus format; perhatikan bahwa menghapus format juga akan menghapus aturan validasi data.
`validationsOnly`	`Boolean`	Apakah hanya akan menghapus aturan validasi data.
`skipFilteredRows`	`Boolean`	Apakah akan menghindari penghapusan baris yang difilter.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clearContent()`

Menghapus konten rentang, tanpa mengubah pemformatan.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:D10');
range.clearContent();

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clearDataValidations()`

Menghapus aturan validasi data untuk rentang.

// Clear the data validation rules for cells A1:B5.
const range = SpreadsheetApp.getActive().getRange('A1:B5');
range.clearDataValidations();

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clearFormat()`

Menghapus pemformatan untuk rentang ini.

Tindakan ini akan menghapus format teks untuk sel atau sel dalam rentang, tetapi tidak mereset aturan pemformatan angka.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:D10');
range.clearFormat();

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clearNote()`

Menghapus catatan di sel yang ditentukan.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:D10');
range.clearNote();

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`collapseGroups()`

Menciutkan semua grup yang sepenuhnya berada dalam rentang. Jika tidak ada grup yang sepenuhnya berada dalam rentang, grup yang diperluas paling dalam yang sebagian berada dalam rentang akan diciutkan.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getActiveRange();

// All row and column groups within the range are collapsed.
range.collapseGroups();

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`

Menyalin pemformatan rentang ke lokasi yang ditentukan. Jika tujuan lebih besar atau lebih kecil dari rentang sumber, sumber akan diulang atau dipotong sesuai kebutuhan. Perhatikan bahwa metode ini hanya menyalin format.

Untuk deskripsi mendetail tentang parameter gridId, lihat getGridId().

const ss = SpreadsheetApp.getActiveSpreadsheet();
const source = ss.getSheets()[0];

const range = source.getRange('B2:D4');

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 1555299895. Note that you can get the gridId
// of a sheet by calling sheet.getSheetId() or range.getGridId().
range.copyFormatToRange(1555299895, 4, 6, 4, 6);

Parameter

Nama	Jenis	Deskripsi
`gridId`	`Integer`	ID unik sheet dalam spreadsheet, terlepas dari posisinya.
`column`	`Integer`	Kolom pertama dari rentang target.
`columnEnd`	`Integer`	Kolom akhir rentang target.
`row`	`Integer`	Baris awal rentang target.
`rowEnd`	`Integer`	Baris akhir rentang target.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Lihat juga

getGridId()

`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`

const ss = SpreadsheetApp.getActiveSpreadsheet();
const source = ss.getSheets()[0];
const destination = ss.getSheets()[1];

const range = source.getRange('B2:D4');

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyFormatToRange(destination, 4, 6, 4, 6);

Parameter

Nama	Jenis	Deskripsi
`sheet`	`Sheet`	Sheet target.
`column`	`Integer`	Kolom pertama dari rentang target.
`columnEnd`	`Integer`	Kolom akhir rentang target.
`row`	`Integer`	Baris awal rentang target.
`rowEnd`	`Integer`	Baris akhir rentang target.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`copyTo(destination)`

Menyalin data dari rentang sel ke rentang sel lain. Nilai dan format akan disalin.

// The code below copies the first 5 columns over to the 6th column.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5);
rangeToCopy.copyTo(sheet.getRange(1, 6));

Parameter

Nama	Jenis	Deskripsi
`destination`	`Range`	Rentang tujuan untuk menyalin; hanya posisi sel kiri atas yang relevan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`copyTo(destination, copyPasteType, transposed)`

Menyalin data dari rentang sel ke rentang sel lain.

// The code below copies only the values of the first 5 columns over to the 6th
// column.
const sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange('A:E').copyTo(
    sheet.getRange('F1'),
    SpreadsheetApp.CopyPasteType.PASTE_VALUES,
    false,
);

Parameter

Nama	Jenis	Deskripsi
`destination`	`Range`	Rentang tujuan untuk menyalin; hanya posisi sel kiri atas yang relevan.
`copyPasteType`	`CopyPasteType`	Jenis yang menentukan cara konten rentang ditempel ke tujuan.
`transposed`	`Boolean`	Apakah rentang harus ditempel dalam orientasi yang ditransposisi.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`copyTo(destination, options)`

Menyalin data dari rentang sel ke rentang sel lain. Secara default, nilai dan format akan disalin, tetapi hal ini dapat diganti menggunakan argumen lanjutan.

// The code below copies only the values of the first 5 columns over to the 6th
// column.
const sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange('A:E').copyTo(sheet.getRange('F1'), {contentsOnly: true});

Parameter

Nama	Jenis	Deskripsi
`destination`	`Range`	Rentang tujuan untuk menyalin; hanya posisi sel kiri atas yang relevan.
`options`	`Object`	Objek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah.

Parameter lanjutan

Nama	Jenis	Deskripsi
`formatOnly`	`Boolean`	menunjukkan bahwa hanya format yang harus disalin
`contentsOnly`	`Boolean`	menunjukkan bahwa hanya konten yang harus disalin

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`copyValuesToRange(gridId, column, columnEnd, row, rowEnd)`

Menyalin konten rentang ke lokasi yang ditentukan. Jika tujuan lebih besar atau lebih kecil dari rentang sumber, sumber akan diulang atau dipotong sesuai kebutuhan.

Untuk deskripsi mendetail tentang parameter gridId, lihat getGridId().

const ss = SpreadsheetApp.getActiveSpreadsheet();
const source = ss.getSheets()[0];

const range = source.getRange('B2:D4');

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 0
range.copyValuesToRange(0, 4, 6, 4, 6);

Parameter

Nama	Jenis	Deskripsi
`gridId`	`Integer`	ID unik sheet dalam spreadsheet, terlepas dari posisinya.
`column`	`Integer`	Kolom pertama dari rentang target.
`columnEnd`	`Integer`	Kolom akhir rentang target.
`row`	`Integer`	Baris awal rentang target.
`rowEnd`	`Integer`	Baris akhir rentang target.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Lihat juga

getGridId()

`copyValuesToRange(sheet, column, columnEnd, row, rowEnd)`

Menyalin konten rentang ke lokasi yang ditentukan. Jika tujuan lebih besar atau lebih kecil dari rentang sumber, sumber akan diulang atau dipotong sesuai kebutuhan.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const source = ss.getSheets()[0];
const destination = ss.getSheets()[1];

const range = source.getRange('B2:D4');

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyValuesToRange(destination, 4, 6, 4, 6);

Parameter

Nama	Jenis	Deskripsi
`sheet`	`Sheet`	Sheet target.
`column`	`Integer`	Kolom pertama dari rentang target.
`columnEnd`	`Integer`	Kolom akhir rentang target.
`row`	`Integer`	Baris awal rentang target.
`rowEnd`	`Integer`	Baris akhir rentang target.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`createDataSourcePivotTable(dataSource)`

Membuat tabel pivot sumber data kosong dari sumber data, yang disematkan di sel pertama dalam rentang ini.

Contoh ini menunjukkan cara membuat dan mengonfigurasi tabel pivot sumber data baru.

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const anchorCell = spreadsheet.getSheets()[0].getRange('A1');
const dataSource = spreadsheet.getDataSources()[0];

const pivotTable = anchorCell.createDataSourcePivotTable(dataSource);
pivotTable.addRowGroup('dataColumnA');
pivotTable.addColumnGroup('dataColumnB');
pivotTable.addPivotValue(
    'dataColumnC',
    SpreadsheetApp.PivotTableSummarizeFunction.SUM,
);
pivotTable.addFilter(
    'dataColumnA',
    SpreadsheetApp.newFilterCriteria().whenTextStartsWith('A').build(),
);

Parameter

Nama	Jenis	Deskripsi
`dataSource`	`DataSource`	Sumber data yang akan digunakan untuk membuat tabel pivot.

Pulang pergi

DataSourcePivotTable — Tabel pivot sumber data yang baru dibuat.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`createDataSourceTable(dataSource)`

Membuat tabel sumber data kosong dari sumber data, yang disematkan di sel pertama dalam rentang ini.

Contoh ini menunjukkan cara membuat dan mengonfigurasi tabel sumber data baru.

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const anchorCell = spreadsheet.getSheets()[0].getRange('A1');
const dataSource = spreadsheet.getDataSources()[0];

const dataSourceTable =
    anchorCell.createDataSourceTable(dataSource)
        .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC')
        .addSortSpec('dataColumnA', true)    // ascending=true
        .addSortSpec('dataColumnB', false);  // ascending=false

Parameter

Nama	Jenis	Deskripsi
`dataSource`	`DataSource`	Sumber data yang akan digunakan untuk membuat tabel pivot.

Pulang pergi

DataSourceTable — Tabel sumber data yang baru dibuat.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`createDeveloperMetadataFinder()`

Menampilkan DeveloperMetadataFinderApi untuk menemukan metadata developer dalam cakupan rentang ini. Metadata berada dalam cakupan rentang hanya jika sepenuhnya berada dalam rentang tersebut. Misalnya, metadata yang terkait dengan baris '3:3' tidak berada dalam cakupan rentang 'A1:D5', tetapi berada dalam cakupan rentang '1:5'.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6.
const range = sheet.getRange('A1:C6');

// Creates a developer metadata finder to search for metadata in the scope of
// this range.
const developerMetaDataFinder = range.createDeveloperMetadataFinder();

// Logs information about the developer metadata finder to the console.
const developerMetaData = developerMetaDataFinder.find()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

Pulang pergi

DeveloperMetadataFinder — Pencari metadata developer untuk menelusuri metadata dalam cakupan rentang ini.

`createFilter()`

Membuat filter dan menerapkannya ke rentang yang ditentukan pada sheet. Anda tidak dapat membuat lebih dari satu filter di sheet. Untuk mengakses dan mengubah filter setelah Anda membuatnya, gunakan getFilter() atau Sheet.getFilter().

const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');

// Creates a new filter and applies it to the range A1:C20 on the active sheet.
function createFilter() {
  range.createFilter();
}
// Gets the filter and applies criteria that only shows cells that aren't empty.
function getFilterAddCriteria() {
  const filter = range.getFilter();
  const criteria =
      SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build();
  filter.setColumnFilterCriteria(2, criteria);
}

Gunakan metode ini untuk membuat filter untuk sheet Grid, jenis sheet default. Sheet petak adalah sheet yang tidak terhubung ke database. Untuk membuat jenis filter lainnya, lihat hal berikut:

Membuat filter tabel pivot dengan PivotTable.addFilter(sourceDataColumn, filterCriteria)
Membuat filter untuk sheet yang terhubung ke database dengan DataSourceSheet.addFilter(columnName, filterCriteria)
Membuat filter untuk tabel pivot yang terhubung ke database dengan DataSourcePivotTable.addFilter(columnName, filterCriteria)

Pulang pergi

Filter — Filter baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`createPivotTable(sourceData)`

Membuat tabel pivot kosong dari sourceData yang ditentukan dan disematkan di sel pertama dalam rentang ini.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A1 as a range in order to place the pivot table.
const range = sheet.getRange('A1');

// Gets the range of the source data for the pivot table.
const dataRange = sheet.getRange('E12:G20');

// Creates an empty pivot table from the specified source data.
const pivotTable = range.createPivotTable(dataRange);

// Logs the values from the pivot table's source data to the console.
console.log(pivotTable.getSourceDataRange().getValues());

Parameter

Nama	Jenis	Deskripsi
`sourceData`	`Range`	Data yang akan digunakan untuk membuat tabel pivot.

Pulang pergi

PivotTable — PivotTable yang baru dibuat.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`createTextFinder(findText)`

Membuat pencari teks untuk rentang, yang dapat menemukan dan mengganti teks dalam rentang ini.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getActiveRange();

// Creates  a text finder for the range.
const textFinder = range.createTextFinder('dog');

// Returns the first occurrence of 'dog'.
const firstOccurrence = textFinder.findNext();

// Replaces the last found occurrence of 'dog' with 'cat' and returns the number
// of occurrences replaced.
const numOccurrencesReplaced = textFinder.replaceWith('cat');

Parameter

Nama	Jenis	Deskripsi
`findText`	`String`	Teks yang akan ditelusuri.

Pulang pergi

TextFinder — TextFinder untuk rentang

`deleteCells(shiftDimension)`

Menghapus rentang sel ini. Data yang ada di sheet di sepanjang dimensi yang diberikan akan digeser ke rentang yang dihapus.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:D10');
range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);

Parameter

Nama	Jenis	Deskripsi
`shiftDimension`	`Dimension`	Dimensi yang digunakan untuk menggeser data yang ada.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`expandGroups()`

Memperluas grup yang diciutkan yang rentang atau tombol kontrolnya bersimpangan dengan rentang ini. Lokasi tombol kontrol adalah indeks tempat tombol kontrol ditampilkan, tepat sebelum atau setelah grup, bergantung pada setelan. Jika ada lebih dari satu grup di lokasi yang sama, grup yang paling dangkal akan diperluas.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getActiveRange();

// All row and column groups within the range are expanded.
range.expandGroups();

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getA1Notation()`

Menampilkan deskripsi string rentang, dalam notasi A1.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange(1, 1, 2, 5);

// Logs "A1:E2"
Logger.log(range.getA1Notation());

Pulang pergi

String — Deskripsi string rentang dalam notasi A1.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getBackground()`

Menampilkan warna latar belakang sel kiri atas dalam rentang (misalnya, '#ffffff').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B5');
Logger.log(cell.getBackground());

Pulang pergi

String — Kode warna latar belakang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getBackgroundObject()`

Menampilkan warna latar belakang sel kiri atas dalam rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B5');
Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());

Pulang pergi

Color — Warna latar belakang sel kiri atas dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getBackgroundObjects()`

Menampilkan warna latar belakang sel dalam rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B5:C6');
const bgColors = range.getBackgroundObjects();
for (const i in bgColors) {
  for (const j in bgColors[i]) {
    Logger.log(bgColors[i][j].asRgbColor().asHexString());
  }
}

Pulang pergi

Color[][] — Array dua dimensi warna latar belakang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getBackgrounds()`

Menampilkan warna latar belakang sel dalam rentang (misalnya, '#ffffff').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B5:C6');
const bgColors = range.getBackgrounds();
for (const i in bgColors) {
  for (const j in bgColors[i]) {
    Logger.log(bgColors[i][j]);
  }
}

Pulang pergi

String[][] — Array dua dimensi kode warna latar belakang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getBandings()`

Menampilkan semua banding yang diterapkan ke sel apa pun dalam rentang ini.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Sets a range.
const range = sheet.getRange('A1:K50');

// Gets the banding info for the range.
const bandings = range.getBandings();

// Logs the second row color for each banding to the console.
for (const banding of bandings) {
  console.log(banding.getSecondRowColor());
}

Pulang pergi

Banding[] — Semua banding yang diterapkan ke sel mana pun dalam rentang ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getCell(row, column)`

Menampilkan sel tertentu dalam rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2:D4');

// The row and column here are relative to the range
// getCell(1,1) in this code returns the cell at B2
const cell = range.getCell(1, 1);
Logger.log(cell.getValue());

Parameter

Nama	Jenis	Deskripsi
`row`	`Integer`	Baris sel relatif terhadap rentang.
`column`	`Integer`	Kolom sel yang relatif terhadap rentang.

Pulang pergi

Range — Rentang yang berisi satu sel pada koordinat yang ditentukan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getColumn()`

Menampilkan posisi kolom awal untuk rentang ini.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2:D4');
// Logs "2.0"
Logger.log(range.getColumn());

Pulang pergi

Integer — Posisi kolom awal rentang di spreadsheet.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataRegion()`

Menampilkan salinan rentang yang diperluas dalam empat Direction kardinal untuk mencakup semua sel yang berdekatan dengan data di dalamnya. Jika rentang dikelilingi oleh sel kosong, tidak termasuk sel di sepanjang diagonal, rentang itu sendiri akan ditampilkan. Caranya mirip dengan memilih rentang dan mengetik Ctrl+A di editor.

// Assume the active spreadsheet is blank.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
sheet.getRange('C2').setValue(100);
sheet.getRange('B3').setValue(100);
sheet.getRange('D3').setValue(100);
sheet.getRange('C4').setValue(100);
// Logs "B2:D4"
Logger.log(sheet.getRange('C3').getDataRegion().getA1Notation());

Pulang pergi

Range — Wilayah data rentang atau rentang untuk seluruh spreadsheet.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataRegion(dimension)`

Menampilkan salinan rentang yang diperluas Direction.UP dan Direction.DOWN jika dimensi yang ditentukan adalah Dimension.ROWS, atau Direction.NEXT dan Direction.PREVIOUS jika dimensinya adalah Dimension.COLUMNS. Perluasan rentang didasarkan pada deteksi data di samping rentang yang diatur seperti tabel. Rentang yang diperluas mencakup semua sel yang berdekatan dengan data di dalamnya di sepanjang dimensi yang ditentukan, termasuk batas tabel. Jika rentang asli diapit oleh sel kosong di sepanjang dimensi yang ditentukan, rentang itu sendiri akan ditampilkan. Metode ini mirip dengan memilih rentang dan mengetik Ctrl+Space untuk kolom atau Shift+Space untuk baris di editor.

// Assume the active spreadsheet is blank.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
sheet.getRange('C2').setValue(100);
sheet.getRange('B3').setValue(100);
sheet.getRange('D3').setValue(100);
sheet.getRange('C4').setValue(100);
// Logs "C2:C4"
Logger.log(
    sheet.getRange('C3')
        .getDataRegion(SpreadsheetApp.Dimension.ROWS)
        .getA1Notation(),
);
// Logs "B3:D3"
Logger.log(
    sheet.getRange('C3')
        .getDataRegion(SpreadsheetApp.Dimension.COLUMNS)
        .getA1Notation(),
);

Parameter

Nama	Jenis	Deskripsi
`dimension`	`Dimension`	Dimensi yang akan digunakan untuk memperluas rentang.

Pulang pergi

Range — Wilayah data rentang atau rentang yang mencakup setiap kolom atau setiap baris yang dibentangkan oleh rentang asli.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceFormula()`

Menampilkan DataSourceFormula untuk sel pertama dalam rentang, atau null jika sel tidak berisi formula sumber data.

// Opens the spreadsheet file by its ID. If you created your script from a
// Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1 on Sheet1.
const range = sheet.getRange('A1');

// Gets the data source formula from cell A1.
const dataSourceFormula = range.getDataSourceFormula();

// Gets the formula.
const formula = dataSourceFormula.getFormula();

// Logs the formula.
console.log(formula);

Pulang pergi

DataSourceFormula — DataSourceFormula untuk sel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceFormulas()`

Menampilkan DataSourceFormula untuk sel dalam rentang.

// Opens the spreadsheet file by its ID. If you created your script from a
// Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:B5 on Sheet1.
const range = sheet.getRange('A1:B5');

// Gets an array of the data source formulas in the range A1:B5.
const dataSourceFormulas = range.getDataSourceFormulas();

// Logs the first formula in the array.
console.log(dataSourceFormulas[0].getFormula());

Pulang pergi

DataSourceFormula[] — Array DataSourceFormula.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourcePivotTables()`

Mendapatkan semua tabel pivot sumber data yang berpotongan dengan rentang.

// Opens the spreadsheet file by its ID. If you created your script from a
// Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:G50 on Sheet1.
const range = sheet.getRange('A1:G50');

// Gets an array of the data source pivot tables in the range A1:G50.
const dataSourcePivotTables = range.getDataSourcePivotTables();

// Logs the last time that the first pivot table in the array was refreshed.
console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());

Pulang pergi

DataSourcePivotTable[] — Daftar tabel pivot sumber data.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceTables()`

Mendapatkan semua tabel sumber data yang berpotongan dengan rentang.

// Opens the spreadsheet file by its ID. If you created your script from a
// Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:G50 on Sheet1.
const range = sheet.getRange('A1:G50');

// Gets the first data source table in the range A1:G50.
const dataSourceTable = range.getDataSourceTables()[0];

// Logs the time of the last completed data execution on the data source table.
console.log(dataSourceTable.getStatus().getLastExecutionTime());

Pulang pergi

DataSourceTable[] — Daftar tabel sumber data.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceUrl()`

Menampilkan URL untuk data dalam rentang ini, yang dapat digunakan untuk membuat diagram dan kueri.

Code.gs

function doGet() {
  const ss = SpreadsheetApp.openById(
      '1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c',
  );
  const sheet = ss.getSheetByName('ContinentData');
  const range = sheet.getRange('A1:B8');

  const template = HtmlService.createTemplateFromFile('piechart');
  template.dataSourceUrl = range.getDataSourceUrl();
  return template.evaluate();
}

piechart.html

<!DOCTYPE html>
<html>
  <head>
    <!--Load the AJAX API-->
    <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
    <script type="text/javascript">
      // Load the Visualization API and the corechart package.
      google.charts.load('current', {'packages': ['corechart']});

      // Set a callback to run when the Google Visualization API is loaded.
      google.charts.setOnLoadCallback(queryData);

      function queryData() {
        var query = new google.visualization.Query('<?= dataSourceUrl ?>');
        query.send(drawChart);
      }

      // Callback that creates and populates a data table,
      // instantiates the pie chart, passes in the data and
      // draws it.
      function drawChart(response) {
        if (response.isError()) {
          alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage());
          return;
        }
        var data = response.getDataTable();

        // Set chart options.
        var options = {
          title: 'Population by Continent',
          width: 400,
          height: 300
        };

        // Instantiate and draw the chart, passing in some options.
        var chart = new google.visualization.PieChart(document.getElementById('chart_div'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <!-- Div that holds the pie chart. -->
    <div id="chart_div"></div>
  </body>
</html>

Pulang pergi

String — URL untuk rentang ini sebagai sumber data yang dapat diteruskan ke API lain seperti diagram.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataTable()`

Menampilkan data di dalam objek ini sebagai DataTable.

// Opens the spreadsheet file by its ID. If you created your script from a
// Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:B7 on Sheet1.
const range = sheet.getRange('A1:B7');

// Gets the range A1:B7 as a data table. The values in each column must be of
// the same type.
const datatable = range.getDataTable();

// Uses the Charts service to build a bar chart from the data table.
// This doesn't build an embedded chart. To do that, use
// sheet.newChart().addRange() instead.
const chart = Charts.newBarChart()
                  .setDataTable(datatable)
                  .setOption('title', 'Your Chart Title Here')
                  .build();

Pulang pergi

DataTable — data sebagai tabel data.

`getDataTable(firstRowIsHeader)`

Menampilkan data di dalam rentang ini sebagai DataTable.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('A1:B7');

// Calling this method with "true" sets the first line to be the title of the
// axes
const datatable = range.getDataTable(true);

// Note that this doesn't build an EmbeddedChart, so you can't just use
// Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead.
const chart = Charts.newBarChart()
                  .setDataTable(datatable)
                  .setOption('title', 'Your Title Here')
                  .build();

Parameter

Nama	Jenis	Deskripsi
`firstRowIsHeader`	`Boolean`	Apakah akan memperlakukan baris pertama sebagai header.

Pulang pergi

DataTable — Data sebagai tabel data.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataValidation()`

Menampilkan aturan validasi data untuk sel kiri atas dalam rentang. Jika validasi data belum ditetapkan pada sel, metode ini akan menampilkan null.

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.');
}

Pulang pergi

DataValidation — Aturan validasi data untuk sel kiri atas dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataValidations()`

Menampilkan aturan validasi data untuk semua sel dalam rentang. Jika validasi data belum ditetapkan pada sel tertentu, metode ini akan menampilkan null untuk posisi sel tersebut dalam array.

// Change existing data validation rules that require a date in 2013 to require
// a date in 2014.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    const rule = rules[i][j];

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const args = rule.getCriteriaValues();

      if (criteria === SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN &&
          args[0].getTime() === oldDates[0].getTime() &&
          args[1].getTime() === oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

Pulang pergi

DataValidation[][] — Array dua dimensi aturan validasi data yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDeveloperMetadata()`

Mendapatkan metadata developer yang terkait dengan rentang ini.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on Sheet1.
const range = sheet.getRange('2:2');

// Adds metadata to row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

// Logs the metadata to console.
for (const metadata of range.getDeveloperMetadata()) {
  console.log(`${metadata.getKey()}: ${metadata.getValue()}`);
}

Pulang pergi

DeveloperMetadata[] — Metadata developer yang terkait dengan rentang ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDisplayValue()`

Menampilkan nilai sel kiri atas yang ditampilkan dalam rentang. Nilainya adalah String. Nilai yang ditampilkan memperhitungkan format tanggal, waktu, dan mata uang, termasuk format yang diterapkan secara otomatis oleh setelan lokalitas spreadsheet. Sel kosong menampilkan string kosong.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A30 and sets its value to 'Test code.'
const cell = sheet.getRange('A30');
cell.setValue('Test code');

// Gets the value and logs it to the console.
console.log(cell.getDisplayValue());

Pulang pergi

String — Nilai yang ditampilkan di sel ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDisplayValues()`

Menampilkan petak nilai persegi panjang untuk rentang ini.

Menampilkan array dua dimensi dari nilai yang ditampilkan, yang diindeks menurut baris, lalu menurut kolom. Nilainya adalah objek String. Nilai yang ditampilkan memperhitungkan format tanggal, waktu, dan mata uang, termasuk format yang diterapkan secara otomatis oleh setelan lokalitas spreadsheet. Sel kosong direpresentasikan oleh string kosong dalam array. Ingat bahwa meskipun indeks rentang dimulai dari 1, 1, array JavaScript diindeks dari [0][0].

// The code below gets the displayed values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
const values =
    SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues();
Logger.log(values[0][0]);

Pulang pergi

String[][] — Array nilai dua dimensi.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFilter()`

Menampilkan filter di sheet tempat rentang ini berada, atau null jika tidak ada filter di sheet.

const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
// Gets the existing filter on the sheet that the given range belongs to.
const filter = range.getFilter();

Pulang pergi

Filter — Filter.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontColorObject()`

Menampilkan warna font sel di sudut kiri atas rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getFontColorObject().asRgbColor().asHexString());

Pulang pergi

Color — Warna font sel kiri atas dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontColorObjects()`

Menampilkan warna font sel dalam rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getFontColorObjects();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j].asRgbColor().asHexString());
  }
}

Pulang pergi

Color[][] — Array dua dimensi warna font yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontFamilies()`

Menampilkan jenis font sel dalam rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getFontFamilies();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Pulang pergi

String[][] — Array dua dimensi jenis font yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontFamily()`

Menampilkan jenis font sel di pojok kiri atas rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getFontFamily());

Pulang pergi

String — Jenis font sel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontLine()`

Mendapatkan gaya garis sel di sudut kiri atas rentang ('underline', 'line-through', atau 'none').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getFontLine());

Pulang pergi

String — Baris font.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontLines()`

Mendapatkan gaya garis sel dalam rentang ('underline', 'line-through', atau 'none').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getFontLines();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Pulang pergi

String[][] — Array dua dimensi dari garis font yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontSize()`

Menampilkan ukuran font dalam ukuran titik sel di sudut kiri atas rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getFontSize());

Pulang pergi

Integer — Ukuran font dalam ukuran poin.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontSizes()`

Menampilkan ukuran font sel dalam rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getFontSizes();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Pulang pergi

Integer[][] — Array dua dimensi ukuran font teks yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontStyle()`

Menampilkan gaya font ('italic' atau 'normal') sel di pojok kiri atas rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getFontStyle());

Pulang pergi

String — Gaya font teks dalam sel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontStyles()`

Menampilkan gaya font sel dalam rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getFontStyles();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Pulang pergi

String[][] — Array dua dimensi gaya font teks yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontWeight()`

Menampilkan ketebalan font (normal/tebal) sel di pojok kiri atas rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getFontWeight());

Pulang pergi

String — Ketebalan font teks dalam sel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontWeights()`

Menampilkan ketebalan font sel dalam rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getFontWeights();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Pulang pergi

String[][] — Array dua dimensi ketebalan font teks yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFormula()`

Menampilkan formula (notasi A1) untuk sel kiri atas rentang, atau string kosong jika sel kosong atau tidak berisi formula.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This assumes you have a function in B5 that sums up
// B2:B4
const range = sheet.getRange('B5');

// Logs the calculated value and the formula
Logger.log(
    'Calculated value: %s Formula: %s',
    range.getValue(),
    range.getFormula(),
);

Pulang pergi

String — Formula untuk sel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFormulaR1C1()`

Menampilkan formula (notasi R1C1) untuk sel tertentu, atau null jika tidak ada.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B5');
const formula = range.getFormulaR1C1();
Logger.log(formula);

Pulang pergi

String — Formula dalam notasi R1C1.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFormulas()`

Menampilkan formula (notasi A1) untuk sel dalam rentang. Entri dalam array 2D adalah string kosong untuk sel tanpa formula.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B5:C6');
const formulas = range.getFormulas();
for (const i in formulas) {
  for (const j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

Pulang pergi

String[][] — Array formula dua dimensi dalam format string.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFormulasR1C1()`

Menampilkan formula (notasi R1C1) untuk sel dalam rentang. Entri dalam array 2D adalah null untuk sel tanpa formula.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B5:C6');
const formulas = range.getFormulasR1C1();
for (const i in formulas) {
  for (const j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

Pulang pergi

String[][] — Array formula dua dimensi dalam notasi R1C1.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getGridId()`

Menampilkan ID petak dari sheet induk rentang. ID adalah nilai int acak non-negatif.

// Log the grid ID of the first sheet (by tab position) in the spreadsheet.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getGridId());

Pulang pergi

Integer — ID petak sheet induk.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getHeight()`

Menampilkan tinggi rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2:D4');
// logs 3.0
Logger.log(range.getHeight());

Pulang pergi

Integer — Tinggi rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getHorizontalAlignment()`

Menampilkan perataan horizontal teks (kiri/tengah/kanan) sel di sudut kiri atas rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getHorizontalAlignment());

Pulang pergi

String — Perataan horizontal teks dalam sel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getHorizontalAlignments()`

Menampilkan perataan horizontal sel dalam rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getHorizontalAlignments();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Pulang pergi

String[][] — Array dua dimensi dari perataan horizontal teks yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getLastColumn()`

Menampilkan posisi kolom akhir.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2:D4');
// Logs "4.0"
Logger.log(range.getLastColumn());

Pulang pergi

Integer — Posisi kolom akhir rentang di spreadsheet.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getLastRow()`

Menampilkan posisi baris akhir.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2:D4');
// Logs "4.0"
Logger.log(range.getLastRow());

Pulang pergi

Integer — Posisi baris akhir rentang di spreadsheet.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getMergedRanges()`

Menampilkan array objek Range yang mewakili sel gabungan yang sepenuhnya berada dalam rentang saat ini, atau berisi setidaknya satu sel dalam rentang saat ini.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B3');

const mergedRanges = range.getMergedRanges();
for (let i = 0; i < mergedRanges.length; i++) {
  Logger.log(mergedRanges[i].getA1Notation());
  Logger.log(mergedRanges[i].getDisplayValue());
}

Pulang pergi

Range[] — Array objek Range, yang mewakili sel gabungan yang tumpang-tindih dengan rentang.

`getNextDataCell(direction)`

Mulai dari sel di kolom dan baris pertama rentang, menampilkan sel berikutnya di arah yang ditentukan, yaitu tepi rentang sel yang berdekatan dengan data di dalamnya atau sel di tepi spreadsheet dalam arah tersebut. Hal ini setara dengan mengetik Ctrl+[arrow key] di editor.

// Assume the active spreadsheet is blank.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('C3:E5');
// Logs "C1"
Logger.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getA1Notation());

Parameter

Nama	Jenis	Deskripsi
`direction`	`Direction`	Arah untuk menemukan sel tepi region data berikutnya.

Pulang pergi

Range — Sel tepi wilayah data atau sel di tepi spreadsheet.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNote()`

Menampilkan catatan yang terkait dengan rentang yang diberikan.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getNote());

Pulang pergi

String — Catatan yang terkait dengan sel tertentu.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNotes()`

Menampilkan catatan yang terkait dengan sel dalam rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getNotes();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Pulang pergi

String[][] — Array catatan dua dimensi yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNumColumns()`

Menampilkan jumlah kolom dalam rentang ini.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2:D5');
Logger.log(range.getNumColumns());

Pulang pergi

Integer — Jumlah kolom dalam rentang ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNumRows()`

Menampilkan jumlah baris dalam rentang ini.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2:D5');
Logger.log(range.getNumRows());

Pulang pergi

Integer — Jumlah baris dalam rentang ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNumberFormat()`

Mendapatkan pemformatan angka atau tanggal sel kiri atas dari rentang yang diberikan. Pola format yang ditampilkan dijelaskan dalam dokumentasi Sheets API.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('C4');
Logger.log(cell.getNumberFormat());

Pulang pergi

String — Format angka sel kiri atas rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNumberFormats()`

Menampilkan format angka atau tanggal untuk sel dalam rentang. Pola format yang ditampilkan dijelaskan dalam dokumentasi Spreadsheet API.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B5:C6');
const formats = range.getNumberFormats();
for (const i in formats) {
  for (const j in formats[i]) {
    Logger.log(formats[i][j]);
  }
}

Pulang pergi

String[][] — Array dua dimensi format angka.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRichTextValue()`

Menampilkan nilai Rich Text untuk sel kiri atas rentang, atau null jika nilai sel bukan teks.

// Gets the Rich Text value of cell D4.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('D4:F6');
const richText = range.getRichTextValue();
console.log(richText.getText());

Pulang pergi

RichTextValue — Nilai Rich Text dari sel kiri atas dalam rentang, atau null jika nilai sel bukan teks.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRichTextValues()`

Menampilkan nilai Teks Kaya untuk sel dalam rentang.

// Gets the Rich Text values for all cells in range B5:C6
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B5:C6');
const values = range.getRichTextValues();

for (let i = 0; i < values.length; i++) {
  for (let j = 0; j < values[i].length; j++) {
    console.log(values[i][j].getText());
  }
}

Pulang pergi

RichTextValue[][] — Array dua dimensi dari nilai Rich Text.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRow()`

Menampilkan posisi baris untuk rentang ini. Identik dengan getRowIndex().

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2');
Logger.log(range.getRow());

Pulang pergi

Integer — Posisi baris rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRowIndex()`

Menampilkan posisi baris untuk rentang ini. Identik dengan getRow().

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2');
Logger.log(range.getRowIndex());

Pulang pergi

Integer — Posisi baris rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Lihat juga

getRow()

`getSheet()`

Menampilkan sheet tempat rentang ini berada.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the sheet that the range belongs to.
const rangeSheet = range.getSheet();

// Gets the sheet name and logs it to the console.
console.log(rangeSheet.getName());

Pulang pergi

Sheet — Sheet tempat rentang ini berada.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getTextDirection()`

Menampilkan arah teks untuk sel kiri atas rentang. Menampilkan null jika arah teks sel ditentukan dengan deteksi otomatis.

// Get the text direction of cell B1.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B1:D4');
Logger.log(range.getTextDirection());

Pulang pergi

TextDirection — Arah teks sel kiri atas dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getTextDirections()`

Menampilkan arah teks untuk sel dalam rentang. Entri dalam array 2D adalah null untuk sel yang menggunakan deteksi otomatis.

// Get the text directions for all cells in range B5:C6
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B5:C6');
const directions = range.getTextDirections();

for (let i = 0; i < directions.length; i++) {
  for (let j = 0; j < directions[i].length; j++) {
    Logger.log(directions[i][j]);
  }
}

Pulang pergi

TextDirection[][] — Array dua dimensi dari petunjuk teks.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getTextRotation()`

Menampilkan setelan rotasi teks untuk sel kiri atas rentang.

// Log the text rotation settings for a cell.
const sheet = SpreadsheetApp.getActiveSheet();

const cell = sheet.getRange('A1');
Logger.log(cell.getTextRotation());

Pulang pergi

TextRotation — Setelan rotasi teks.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getTextRotations()`

Menampilkan setelan rotasi teks untuk sel dalam rentang.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

const results = range.getTextRotations();

for (const i in results) {
  for (const j in results[i]) {
    const rotation = results[i][j];
    Logger.log('Cell [%s, %s] has text rotation: %v', i, j, rotation);
  }
}

Pulang pergi

TextRotation[][] — Array rotasi teks dua dimensi yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getTextStyle()`

Menampilkan gaya teks untuk sel kiri atas rentang.

// Get the text style of cell D4.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('D4:F6');
const style = range.getTextStyle();
Logger.log(style);

Pulang pergi

TextStyle — Gaya teks sel kiri atas dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getTextStyles()`

Menampilkan gaya teks untuk sel dalam rentang.

// Get the text styles for all cells in range B5:C6
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B5:C6');
const styles = range.getTextStyles();

for (let i = 0; i < styles.length; i++) {
  for (let j = 0; j < styles[i].length; j++) {
    Logger.log(styles[i][j]);
  }
}

Pulang pergi

TextStyle[][] — Array gaya teks dua dimensi.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getValue()`

Menampilkan nilai sel kiri atas dalam rentang. Nilainya dapat berupa jenis Number, Boolean, Date, atau String, bergantung pada nilai sel. Sel kosong akan menampilkan string kosong.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the value of the top-left cell in the range and logs it to the console.
console.log(range.getValue());

Pulang pergi

Object — Nilai dalam sel ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getValues()`

Menampilkan petak nilai persegi panjang untuk rentang ini.

Menampilkan array nilai dua dimensi, yang diindeks menurut baris, lalu menurut kolom. Nilainya dapat berupa jenis Number, Boolean, Date, atau String, bergantung pada nilai sel. Sel kosong direpresentasikan oleh string kosong dalam array. Ingat bahwa meskipun indeks rentang dimulai dari 1, 1, array JavaScript diindeks dari [0][0].

// The code below gets the values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
const values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues();
Logger.log(values[0][0]);

Di aplikasi web, nilai Date bukan parameter yang valid. getValues() gagal menampilkan data ke aplikasi web jika rentang berisi sel dengan nilai Date. Sebagai gantinya, ubah semua nilai yang diambil dari sheet menjadi primitif JavaScript yang didukung seperti Number, Boolean, atau String.

Pulang pergi

Object[][] — Array nilai dua dimensi.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getVerticalAlignment()`

Menampilkan perataan vertikal (atas/tengah/bawah) sel di pojok kiri atas rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getVerticalAlignment());

Pulang pergi

String — Perataan vertikal teks dalam sel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getVerticalAlignments()`

Menampilkan perataan vertikal sel dalam rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getVerticalAlignments();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Pulang pergi

String[][] — Array dua dimensi dari perataan vertikal teks yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getWidth()`

Menampilkan lebar rentang dalam kolom.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the width of the range in number of columns and logs it to the console.
console.log(range.getWidth());

Pulang pergi

Integer — Jumlah kolom dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getWrap()`

Menampilkan apakah teks dalam sel disambungkan. Untuk mendapatkan strategi penggabungan yang lebih terperinci, gunakan getWrapStrategy().

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getWrap());

Pulang pergi

Boolean — Apakah teks di sel ini digabungkan atau tidak.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getWrapStrategies()`

Menampilkan strategi penggabungan teks untuk sel dalam rentang.

// Get the text wrapping strategies for all cells in range B5:C6
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B5:C6');
const strategies = range.getWrapStrategies();

for (let i = 0; i < strategies.length; i++) {
  for (let j = 0; j < strategies[i].length; j++) {
    Logger.log(strategies[i][j]);
  }
}

Pulang pergi

WrapStrategy[][] — Array dua dimensi dari strategi perataan teks.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getWrapStrategy()`

Menampilkan strategi penggabungan teks untuk sel kiri atas rentang.

// Get the text wrapping strategy of cell B1.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B1:D4');
Logger.log(range.getWrapStrategy());

Pulang pergi

WrapStrategy — Strategi penggabungan teks dari sel kiri atas dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getWraps()`

Menampilkan apakah teks dalam sel disambungkan. Untuk mendapatkan strategi penggabungan yang lebih terperinci, gunakan getWrapStrategies().

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getVerticalAlignments();

for (const i in results) {
  for (const j in results[i]) {
    const isWrapped = results[i][j];
    if (isWrapped) {
      Logger.log('Cell [%s, %s] has wrapped text', i, j);
    }
  }
}

Pulang pergi

Boolean[][] — Array dua dimensi dari perataan vertikal teks yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertCells(shiftDimension)`

Menyisipkan sel kosong ke dalam rentang ini. Sel baru mempertahankan format apa pun yang ada di sel yang sebelumnya menempati rentang ini. Data yang ada di sheet di sepanjang dimensi yang diberikan akan dipindahkan dari rentang yang disisipkan.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:D10');
range.insertCells(SpreadsheetApp.Dimension.COLUMNS);

Parameter

Nama	Jenis	Deskripsi
`shiftDimension`	`Dimension`	Dimensi yang digunakan untuk menggeser data yang ada.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertCheckboxes()`

Menyisipkan kotak centang ke setiap sel dalam rentang, yang dikonfigurasi dengan true untuk dicentang dan false untuk tidak dicentang. Menetapkan nilai semua sel dalam rentang ke false.

const range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'true'
// for checked and 'false' for unchecked. Also, sets the value of each cell in
// the range A1:B10 to 'false'.
range.insertCheckboxes();

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertCheckboxes(checkedValue)`

Menyisipkan kotak centang ke setiap sel dalam rentang, yang dikonfigurasi dengan nilai kustom untuk dicentang dan string kosong untuk tidak dicentang. Menetapkan nilai setiap sel dalam rentang ke string kosong.

const range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes'
// for checked and the empty string for unchecked. Also, sets the value of each
// cell in the range A1:B10 to
//  the empty string.
range.insertCheckboxes('yes');

Parameter

Nama	Jenis	Deskripsi
`checkedValue`	`Object`	Nilai yang dicentang untuk validasi data kotak centang.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertCheckboxes(checkedValue, uncheckedValue)`

Menyisipkan kotak centang ke setiap sel dalam rentang, yang dikonfigurasi dengan nilai kustom untuk status dicentang dan tidak dicentang. Menetapkan nilai setiap sel dalam rentang ke nilai kustom yang tidak dicentang.

const range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes'
// for checked and 'no' for unchecked. Also, sets the value of each cell in the
// range A1:B10 to 'no'.
range.insertCheckboxes('yes', 'no');

Parameter

Nama	Jenis	Deskripsi
`checkedValue`	`Object`	Nilai yang dicentang untuk validasi data kotak centang.
`uncheckedValue`	`Object`	Nilai yang tidak dicentang untuk validasi data kotak centang.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isBlank()`

Menampilkan true jika rentang benar-benar kosong.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.isBlank());

Pulang pergi

Boolean — true jika rentang kosong; false jika tidak.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isChecked()`

Menampilkan apakah semua sel dalam rentang memiliki status kotak centang sebagai 'checked'. Menampilkan null jika beberapa sel dicentang dan sisanya tidak dicentang, atau jika beberapa sel tidak memiliki validasi data kotak centang.

const range = SpreadsheetApp.getActive().getRange('A1:A3');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:A3.
range.insertCheckboxes('yes', 'no');

const range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Sets the value of isRange1Checked as true as it contains the checked value.
const isRange1Checked = range1.isChecked();

const range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('no');
// Sets the value of isRange2Checked as false as it contains the unchecked
// value.
const isRange2Checked = range2.isChecked();

const range3 = SpreadsheetApp.getActive().getRange('A3');
range3.setValue('random');
// Sets the value of isRange3Checked as null, as it contains an invalid checkbox
// value.
const isRange3Checked = range3.isChecked();

Pulang pergi

Boolean — true, jika semua sel dalam rentang dicentang, false jika semua sel dalam rentang tidak dicentang, atau null jika ada sel yang tidak dicentang atau tidak memiliki validasi data kotak centang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isEndColumnBounded()`

Menentukan apakah akhir rentang terikat ke kolom tertentu. Misalnya, untuk rentang A1:B10 atau B:B, yang terikat ke kolom di akhir rentang, metode ini menampilkan true; untuk rentang 3:7 atau A1:5, yang hanya terikat ke baris tertentu di akhir rentang, metode ini menampilkan false.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular column and logs
// it to the console.
console.log(range.isEndColumnBounded());

Pulang pergi

Boolean — true jika akhir rentang terikat ke kolom tertentu; false jika tidak.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isEndRowBounded()`

Menentukan apakah akhir rentang terikat ke baris tertentu. Misalnya, untuk rentang A1:B10 atau 3:7, yang terikat ke baris di akhir rentang, metode ini menampilkan true; untuk rentang B:B atau A1:C, yang hanya terikat ke kolom tertentu di akhir rentang, metode ini menampilkan false.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular row and logs it
// to the console.
console.log(range.isEndRowBounded());

Pulang pergi

Boolean — true jika akhir rentang terikat ke baris tertentu; false jika tidak.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isPartOfMerge()`

Menampilkan true jika sel dalam rentang saat ini tumpang-tindih dengan sel yang digabungkan.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B3');

// True if any of the cells in A1:B3 is included in a merge.
const isPartOfMerge = range.isPartOfMerge();

Pulang pergi

Boolean — true jika rentang tumpang-tindih dengan sel yang digabungkan, jika tidak, menampilkan false.

`isStartColumnBounded()`

Menentukan apakah awal rentang terikat ke kolom tertentu. Misalnya, untuk rentang A1:B10 atau B:B, yang terikat dengan kolom di awal rentang, metode ini menampilkan true; untuk rentang 3:7, yang hanya terikat dengan baris di awal rentang, metode ini menampilkan false.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular column and logs
// it to the console.
console.log(range.isStartColumnBounded());

Pulang pergi

Boolean — true jika awal rentang terikat ke kolom tertentu; false jika tidak.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isStartRowBounded()`

Menentukan apakah awal rentang terikat ke baris tertentu. Misalnya, untuk rentang A1:B10 atau 3:7, yang terikat ke baris di awal rentang, metode ini menampilkan true; untuk rentang B:B, yang hanya terikat ke kolom tertentu di awal rentang, metode ini menampilkan false.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular row and logs it
// to the console.
console.log(range.isStartRowBounded());

Pulang pergi

Boolean — true jika awal rentang terikat ke baris tertentu; false jika tidak.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`merge()`

Menggabungkan sel dalam rentang menjadi satu blok.

const sheet = SpreadsheetApp.getActiveSheet();

// The code below 2-dimensionally merges the cells in A1 to B3
sheet.getRange('A1:B3').merge();

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`mergeAcross()`

Menggabungkan sel dalam rentang di seluruh kolom rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The code below merges cells C5:E5 into one cell
const range1 = sheet.getRange('C5:E5');
range1.mergeAcross();

// The code below creates 2 horizontal cells, F5:H5 and F6:H6
const range2 = sheet.getRange('F5:H6');
range2.mergeAcross();

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`mergeVertically()`

Menggabungkan sel dalam rentang.

const sheet = SpreadsheetApp.getActiveSheet();

// The code below vertically merges the cells in A1 to A10
sheet.getRange('A1:A10').mergeVertically();

// The code below creates 3 merged columns: B1 to B10, C1 to C10, and D1 to D10
sheet.getRange('B1:D10').mergeVertically();

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`moveTo(target)`

Potong dan tempel (format dan nilai) dari rentang ini ke rentang target.

// The code below moves the first 5 columns over to the 6th column
const sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange('A1:E').moveTo(sheet.getRange('F1'));

Parameter

Nama	Jenis	Deskripsi
`target`	`Range`	Rentang target untuk menyalin rentang ini; hanya posisi sel kiri atas yang relevan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`offset(rowOffset, columnOffset)`

Menampilkan rentang baru yang di-offset dari rentang ini dengan jumlah baris dan kolom tertentu (yang dapat negatif). Rentang baru memiliki ukuran yang sama dengan rentang asli.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('A1');

// newCell references B2
const newCell = cell.offset(1, 1);

Parameter

Nama	Jenis	Deskripsi
`rowOffset`	`Integer`	Jumlah baris ke bawah dari sel kiri atas rentang; nilai negatif mewakili baris ke atas dari sel kiri atas rentang.
`columnOffset`	`Integer`	Jumlah kolom tepat dari sel kiri atas rentang; nilai negatif mewakili kolom yang tersisa dari sel kiri atas rentang.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

`offset(rowOffset, columnOffset, numRows)`

Menampilkan rentang baru yang relatif terhadap rentang saat ini, yang titik kiri atas di-offset dari rentang saat ini oleh baris dan kolom yang diberikan, dan dengan tinggi yang diberikan dalam sel.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('A1');

// newCell references B2:B3
const newRange = cell.offset(1, 1, 2);

Parameter

Nama	Jenis	Deskripsi
`rowOffset`	`Integer`	Jumlah baris ke bawah dari sel kiri atas rentang; nilai negatif mewakili baris ke atas dari sel kiri atas rentang.
`columnOffset`	`Integer`	Jumlah kolom tepat dari sel kiri atas rentang; nilai negatif mewakili kolom yang tersisa dari sel kiri atas rentang.
`numRows`	`Integer`	Tinggi dalam baris rentang baru.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

`offset(rowOffset, columnOffset, numRows, numColumns)`

Menampilkan rentang baru yang relatif terhadap rentang saat ini, yang titik kiri atas dioffset dari rentang saat ini oleh baris dan kolom yang diberikan, dan dengan tinggi dan lebar yang diberikan di sel.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('A1');

// newCell references B2:C3
const newRange = cell.offset(1, 1, 2, 2);

Parameter

Nama	Jenis	Deskripsi
`rowOffset`	`Integer`	Jumlah baris ke bawah dari sel kiri atas rentang; nilai negatif mewakili baris ke atas dari sel kiri atas rentang.
`columnOffset`	`Integer`	Jumlah kolom tepat dari sel kiri atas rentang; nilai negatif mewakili kolom yang tersisa dari sel kiri atas rentang.
`numRows`	`Integer`	Tinggi dalam baris rentang baru.
`numColumns`	`Integer`	Lebar dalam kolom dari rentang baru.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

`protect()`

Membuat objek yang dapat melindungi rentang agar tidak diedit kecuali oleh pengguna yang memiliki izin. Hingga skrip benar-benar mengubah daftar editor untuk rentang (dengan memanggil Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses), atau menetapkan nilai baru untuk Protection.setDomainEdit(editable)), izin akan mencerminkan izin spreadsheet itu sendiri, yang secara efektif berarti rentang tetap tidak dilindungi. Jika rentang sudah dilindungi, metode ini akan membuat rentang baru yang dilindungi dan tumpang-tindih dengan rentang yang ada. Jika sel dilindungi oleh beberapa rentang yang dilindungi dan salah satunya mencegah pengguna tertentu mengedit sel, pengguna tersebut tidak diizinkan untuk mengedit sel.

// Protect range A1:B10, then remove all other users from the list of editors.
const ss = SpreadsheetApp.getActive();
const range = ss.getRange('A1:B10');
const protection = range.protect().setDescription('Sample protected range');

// Ensure the current user is an editor before removing others. Otherwise, if
// the user's edit permission comes from a group, the script throws an exception
// upon removing the group.
const me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Pulang pergi

Protection — Objek yang mewakili setelan perlindungan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`randomize()`

Mengacak urutan baris dalam rentang yang ditentukan.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('A1:C7');

// Randomizes the range
range.randomize();

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeCheckboxes()`

Menghapus semua kotak centang dari rentang. Menghapus validasi data setiap sel, dan juga menghapus nilainya jika sel berisi nilai yang dicentang atau tidak dicentang.

const range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:B10.
range.insertCheckboxes('yes', 'no');

const range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Removes the checkbox data validation in cell A1 and clears its value.
range1.removeCheckboxes();

const range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('random');
// Removes the checkbox data validation in cell A2 but does not clear its value.
range2.removeCheckboxes();

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeDuplicates()`

Menghapus baris dalam rentang ini yang berisi nilai yang merupakan duplikat dari nilai di baris sebelumnya. Baris dengan nilai yang sama tetapi memiliki perbedaan kapitalisasi, pemformatan, atau formula akan dianggap duplikat. Metode ini juga menghapus baris duplikat yang disembunyikan dari tampilan (misalnya, karena filter). Konten di luar rentang ini tidak akan dihapus.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B1:D7');

// Remove duplicate rows in the range.
range.removeDuplicates();

Pulang pergi

Range — Rentang yang dihasilkan setelah menghapus duplikat. Ukuran rentang dikurangi satu baris untuk setiap baris yang dihapus.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeDuplicates(columnsToCompare)`

Menghapus baris dalam rentang ini yang berisi nilai di kolom yang ditentukan yang merupakan duplikat nilai baris sebelumnya. Baris dengan nilai yang sama tetapi memiliki perbedaan kapitalisasi, pemformatan, atau formula akan dianggap duplikat. Metode ini juga menghapus baris duplikat yang disembunyikan dari tampilan (misalnya, karena filter). Konten di luar rentang ini tidak akan dihapus.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B1:D7');

// Remove rows which have duplicate values in column B.
range.removeDuplicates([2]);

// Remove rows which have duplicate values in both columns B and D.
range.removeDuplicates([2, 4]);

Parameter

Nama	Jenis	Deskripsi
`columnsToCompare`	`Integer[]`	Kolom yang akan dianalisis untuk menemukan nilai duplikat. Jika tidak ada kolom yang diberikan, semua kolom akan dianalisis untuk menemukan duplikat.

Pulang pergi

Range — Rentang yang dihasilkan setelah menghapus duplikat. Ukuran rentang dikurangi satu baris untuk setiap baris yang dihapus.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setBackground(color)`

Menetapkan warna latar belakang semua sel dalam rentang dalam notasi CSS (seperti '#ffffff' atau 'white').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('B2:D5');
range.setBackground('red');

Parameter

Nama	Jenis	Deskripsi
`color`	`String`	Kode warna dalam notasi CSS (seperti `'#ffffff'` atau `'white'`); nilai `null` mereset warna.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setBackgroundObject(color)`

Menetapkan warna latar belakang semua sel dalam rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const bgColor = SpreadsheetApp.newColor()
                    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
                    .build();

const range = sheet.getRange('B2:D5');
range.setBackgroundObject(bgColor);

Parameter

Nama	Jenis	Deskripsi
`color`	`Color`	Warna latar belakang yang akan ditetapkan; nilai `null` mereset warna latar belakang.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setBackgroundObjects(color)`

Menetapkan petak persegi panjang warna latar belakang (harus cocok dengan dimensi rentang ini).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const colorAccent1 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                         .build();
const colorAccent2 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                         .build();
const colorAccent3 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                         .build();
const colorAccent4 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
                         .build();

const colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4],
];

const cell = sheet.getRange('B5:C6');
cell.setBackgroundObjects(colors);

Parameter

Nama	Jenis	Deskripsi
`color`	`Color[][]`	Array warna dua dimensi; nilai `null` mereset warna.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setBackgroundRGB(red, green, blue)`

Menetapkan latar belakang ke warna yang diberikan menggunakan nilai RGB (bilangan bulat antara 0 dan 255 inklusif).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');

// Sets the background to white
cell.setBackgroundRGB(255, 255, 255);

// Sets the background to red
cell.setBackgroundRGB(255, 0, 0);

Parameter

Nama	Jenis	Deskripsi
`red`	`Integer`	Nilai merah dalam notasi RGB.
`green`	`Integer`	Nilai hijau dalam notasi RGB.
`blue`	`Integer`	Nilai biru dalam notasi RGB.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setBackgrounds(color)`

Menetapkan petak persegi panjang warna latar belakang (harus cocok dengan dimensi rentang ini). Warna berada dalam notasi CSS (seperti '#ffffff' atau 'white').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const colors = [
  ['red', 'white', 'blue'],
  ['#FF0000', '#FFFFFF', '#0000FF'],  // These are the hex equivalents
];

const cell = sheet.getRange('B5:D6');
cell.setBackgrounds(colors);

Parameter

Nama	Jenis	Deskripsi
`color`	`String[][]`	Array warna dua dimensi dalam notasi CSS (seperti `'#ffffff'` atau `'white'`); nilai `null` mereset warna.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setBorder(top, left, bottom, right, vertical, horizontal)`

Menetapkan properti batas. Nilai yang valid adalah true (aktif), false (nonaktif), dan null (tidak ada perubahan).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
// Sets borders on the top and bottom, but leaves the left and right unchanged
cell.setBorder(true, null, true, null, false, false);

Parameter

Nama	Jenis	Deskripsi
`top`	`Boolean`	`true` untuk batas, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`left`	`Boolean`	`true` untuk batas, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`bottom`	`Boolean`	`true` untuk batas, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`right`	`Boolean`	`true` untuk batas, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`vertical`	`Boolean`	`true` untuk batas vertikal internal, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`horizontal`	`Boolean`	`true` untuk batas horizontal internal, `false` untuk tidak ada, `null` untuk tidak ada perubahan.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`

Menetapkan properti batas dengan warna dan/atau gaya. Nilai yang valid adalah true (aktif), false (nonaktif), dan null (tidak ada perubahan). Untuk warna, gunakan Warna dalam notasi CSS (seperti '#ffffff' atau 'white').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
// Sets borders on the top and bottom, but leaves the left and right unchanged
// Also sets the color to "red", and the border to "DASHED".
cell.setBorder(
    true,
    null,
    true,
    null,
    false,
    false,
    'red',
    SpreadsheetApp.BorderStyle.DASHED,
);

Parameter

Nama	Jenis	Deskripsi
`top`	`Boolean`	`true` untuk batas, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`left`	`Boolean`	`true` untuk batas, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`bottom`	`Boolean`	`true` untuk batas, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`right`	`Boolean`	`true` untuk batas, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`vertical`	`Boolean`	`true` untuk batas vertikal internal, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`horizontal`	`Boolean`	`true` untuk batas horizontal internal, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`color`	`String`	Warna dalam notasi CSS (seperti `'#ffffff'` atau `'white'`), `null` untuk warna default (hitam).
`style`	`BorderStyle`	Gaya untuk batas, `null` untuk gaya default (solid).

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setDataValidation(rule)`

Menetapkan satu aturan validasi data untuk semua sel dalam rentang.

// Set the data validation rule for cell A1 to require a value from B1:B10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parameter

Nama	Jenis	Deskripsi
`rule`	`DataValidation`	Aturan validasi data yang akan ditetapkan, atau `null` untuk menghapus validasi data.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setDataValidations(rules)`

Menetapkan aturan validasi data untuk semua sel dalam rentang. Metode ini menggunakan array validasi data dua dimensi, yang diindeks menurut baris, lalu menurut kolom. Dimensi array harus sesuai dengan dimensi rentang.

// Set the data validation rules for Sheet1!A1:B5 to require a value from
// Sheet2!A1:A10.
const destinationRange =
    SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
const sourceRange =
    SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
const rules = destinationRange.getDataValidations();
for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    rules[i][j] = rule;
  }
}
destinationRange.setDataValidations(rules);

Parameter

Nama	Jenis	Deskripsi
`rules`	`DataValidation[][]`	Array dua dimensi aturan validasi data yang akan ditetapkan; nilai `null` menghapus validasi data.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontColor(color)`

Menetapkan warna font dalam notasi CSS (seperti '#ffffff' atau 'white').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setFontColor('red');

Parameter

Nama	Jenis	Deskripsi
`color`	`String`	Warna font dalam notasi CSS (seperti `'#ffffff'` atau `'white'`); nilai `null` mereset warna.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontColorObject(color)`

Menetapkan warna font rentang yang diberikan.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const color = SpreadsheetApp.newColor()
                  .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
                  .build();

const cell = sheet.getRange('B2');
cell.setFontColor(color);

Parameter

Nama	Jenis	Deskripsi
`color`	`Color`	Warna font yang akan ditetapkan; nilai `null` akan mereset warna.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontColorObjects(colors)`

Menetapkan petak persegi panjang warna font (harus cocok dengan dimensi rentang ini).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const colorAccent1 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                         .build();
const colorAccent2 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                         .build();
const colorAccent3 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                         .build();
const colorAccent4 = SpreadsheetApp.newColor()
                         .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
                         .build();

const colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4],
];

const cell = sheet.getRange('B5:C6');
cell.setFontColorObjects(colors);

Parameter

Nama	Jenis	Deskripsi
`colors`	`Color[][]`	Array warna dua dimensi; nilai `null` mereset warna font.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontColors(colors)`

Menetapkan petak persegi panjang warna font (harus cocok dengan dimensi rentang ini). Warna dalam notasi CSS (seperti '#ffffff' atau 'white').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const colors = [
  ['red', 'white', 'blue'],
  ['#FF0000', '#FFFFFF', '#0000FF'],  // These are the hex equivalents
];

const cell = sheet.getRange('B5:D6');
cell.setFontColors(colors);

Parameter

Nama	Jenis	Deskripsi
`colors`	`Object[][]`	Array warna dua dimensi dalam notasi CSS (seperti `'#ffffff'` atau `'white'`); nilai `null` mereset warna.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontFamilies(fontFamilies)`

Menetapkan petak persegi panjang jenis font (harus cocok dengan dimensi rentang ini). Contoh keluarga font adalah "Arial" atau "Helvetica".

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const fonts = [
  ['Arial', 'Helvetica', 'Verdana'],
  ['Courier New', 'Arial', 'Helvetica'],
];

const cell = sheet.getRange('B2:D3');
cell.setFontFamilies(fonts);

Parameter

Nama	Jenis	Deskripsi
`fontFamilies`	`Object[][]`	Array dua dimensi jenis font; nilai `null` mereset jenis font.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontFamily(fontFamily)`

Menetapkan jenis font, seperti "Arial" atau "Helvetica".

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setFontFamily('Helvetica');

Parameter

Nama	Jenis	Deskripsi
`fontFamily`	`String`	Jenis font yang akan ditetapkan; nilai `null` mereset jenis font.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontLine(fontLine)`

Menetapkan gaya garis font dari rentang yang diberikan ('underline', 'line-through', atau 'none').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setFontLine('line-through');

Parameter

Nama	Jenis	Deskripsi
`fontLine`	`String`	Gaya garis font, baik `'underline'`, `'line-through'`, atau `'none'`; nilai `null` mereset gaya garis font.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontLines(fontLines)`

Menetapkan petak persegi panjang gaya garis (harus cocok dengan dimensi rentang ini).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const fontLines = [['underline', 'line-through', 'none']];

const range = sheet.getRange('B2:D2');
range.setFontLines(fontLines);

Parameter

Nama	Jenis	Deskripsi
`fontLines`	`Object[][]`	Array dua dimensi gaya garis font (`'underline'`, `'line-through'`, atau `'none'`); nilai `null` mereset gaya garis font.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontSize(size)`

Menetapkan ukuran font, dengan ukuran yang merupakan ukuran titik yang akan digunakan.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setFontSize(20);

Parameter

Nama	Jenis	Deskripsi
`size`	`Integer`	Ukuran font dalam ukuran poin.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontSizes(sizes)`

Menetapkan petak persegi panjang ukuran font (harus cocok dengan dimensi rentang ini). Ukurannya dalam titik.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const fontSizes = [[16, 20, 24]];

const range = sheet.getRange('B2:D2');
range.setFontSizes(fontSizes);

Parameter

Nama	Jenis	Deskripsi
`sizes`	`Object[][]`	Array ukuran dua dimensi.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontStyle(fontStyle)`

Menetapkan gaya font untuk rentang yang diberikan ('italic' atau 'normal').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setFontStyle('italic');

Parameter

Nama	Jenis	Deskripsi
`fontStyle`	`String`	Gaya font, `'italic'` atau `'normal'`; nilai `null` mereset gaya font.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontStyles(fontStyles)`

Menetapkan petak persegi panjang gaya font (harus cocok dengan dimensi rentang ini).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const fontStyles = [['italic', 'normal']];

const range = sheet.getRange('B2:C2');
range.setFontStyles(fontStyles);

Parameter

Nama	Jenis	Deskripsi
`fontStyles`	`Object[][]`	Array gaya font dua dimensi, baik `'italic'` maupun `'normal'`; nilai `null` mereset gaya font.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontWeight(fontWeight)`

Menetapkan ketebalan font untuk rentang yang diberikan (normal/tebal).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setFontWeight('bold');

Parameter

Nama	Jenis	Deskripsi
`fontWeight`	`String`	Ketebalan font, `'bold'` atau `'normal'`; nilai `null` mereset ketebalan font.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFontWeights(fontWeights)`

Menetapkan petak persegi panjang ketebalan font (harus cocok dengan dimensi rentang ini). Contoh ketebalan font adalah "tebal".

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const fontStyles = [['bold', 'bold', 'normal']];

const range = sheet.getRange('B2:D2');
range.setFontWeights(fontStyles);

Parameter

Nama	Jenis	Deskripsi
`fontWeights`	`Object[][]`	Array dua dimensi ketebalan font, baik `'bold'` maupun `'normal'`; nilai `null` mereset ketebalan font.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFormula(formula)`

Memperbarui formula untuk rentang ini. Formula yang diberikan harus dalam notasi A1.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B5');
cell.setFormula('=SUM(B3:B4)');

Parameter

Nama	Jenis	Deskripsi
`formula`	`String`	String yang mewakili formula yang akan ditetapkan untuk sel.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFormulaR1C1(formula)`

Memperbarui formula untuk rentang ini. Formula yang diberikan harus dalam notasi R1C1.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B5');
// This sets the formula to be the sum of the 3 rows above B5
cell.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');

Parameter

Nama	Jenis	Deskripsi
`formula`	`String`	Formula string.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFormulas(formulas)`

Menetapkan petak persegi panjang formula (harus cocok dengan dimensi rentang ini). Formula yang diberikan harus dalam notasi A1. Metode ini menggunakan array formula dua dimensi, yang diindeks menurut baris, lalu menurut kolom. Dimensi array harus sesuai dengan dimensi rentang.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This sets the formulas to be a row of sums, followed by a row of averages
// right below. The size of the two-dimensional array must match the size of the
// range.
const formulas = [
  ['=SUM(B2:B4)', '=SUM(C2:C4)', '=SUM(D2:D4)'],
  ['=AVERAGE(B2:B4)', '=AVERAGE(C2:C4)', '=AVERAGE(D2:D4)'],
];

const cell = sheet.getRange('B5:D6');
cell.setFormulas(formulas);

Parameter

Nama	Jenis	Deskripsi
`formulas`	`String[][]`	Array string dua dimensi dari formula.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFormulasR1C1(formulas)`

Menetapkan petak persegi panjang formula (harus cocok dengan dimensi rentang ini). Formula yang diberikan harus dalam notasi R1C1.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// This creates formulas for a row of sums, followed by a row of averages.
const sumOfRowsAbove = '=SUM(R[-3]C[0]:R[-1]C[0])';
const averageOfRowsAbove = '=AVERAGE(R[-4]C[0]:R[-2]C[0])';

// The size of the two-dimensional array must match the size of the range.
const formulas = [
  [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove],
  [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove],
];

const cell = sheet.getRange('B5:D6');
// This sets the formula to be the sum of the 3 rows above B5.
cell.setFormulasR1C1(formulas);

Parameter

Nama	Jenis	Deskripsi
`formulas`	`String[][]`	Array formula dua dimensi dalam format R1C1.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setHorizontalAlignment(alignment)`

Tetapkan perataan horizontal (kiri ke kanan) untuk rentang yang diberikan (kiri/tengah/kanan).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setHorizontalAlignment('center');

Parameter

Nama	Jenis	Deskripsi
`alignment`	`String`	Perataan, baik `'left'`, `'center'`, maupun `'normal'`; nilai `null` mereset perataan.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setHorizontalAlignments(alignments)`

Menetapkan petak persegi panjang perataan horizontal. lihat setHorizontalAlignment(alignment)

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const horizontalAlignments = [['left', 'right', 'center']];

const range = sheet.getRange('B2:D2');
range.setHorizontalAlignments(horizontalAlignments);

Parameter

Nama	Jenis	Deskripsi
`alignments`	`Object[][]`	Array perataan dua dimensi, baik `'left'`, `'center'`, maupun `'normal'`; nilai `null` mereset perataan.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Lihat juga

setHorizontalAlignment(alignment)

`setNote(note)`

Menetapkan catatan ke nilai yang diberikan.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setNote('This is a note');

Parameter

Nama	Jenis	Deskripsi
`note`	`String`	Nilai catatan yang akan ditetapkan untuk rentang; nilai `null` akan menghapus catatan.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setNotes(notes)`

Menetapkan petak persegi panjang catatan (harus cocok dengan dimensi rentang ini).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const notes = [
  ['it goes', 'like this', 'the fourth, the fifth'],
  ['the minor fall', 'and the', 'major lift'],
];

const cell = sheet.getRange('B2:D3');
cell.setNotes(notes);

Parameter

Nama	Jenis	Deskripsi
`notes`	`Object[][]`	Array catatan dua dimensi; nilai `null` menghapus catatan.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Lihat juga

setNote(note)

`setNumberFormat(numberFormat)`

Menetapkan format angka atau tanggal ke string pemformatan yang diberikan. Pola format yang diterima dijelaskan dalam dokumentasi Sheets API.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
// Always show 3 decimal points
cell.setNumberFormat('0.000');

Parameter

Nama	Jenis	Deskripsi
`numberFormat`	`String`	String format angka.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setNumberFormats(numberFormats)`

Menetapkan petak persegi panjang format angka atau tanggal (harus cocok dengan dimensi rentang ini). Nilainya adalah string pola format seperti yang dijelaskan dalam dokumentasi Sheets API.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const formats = [['0.000', '0,000,000', '$0.00']];

const range = sheet.getRange('B2:D2');
range.setNumberFormats(formats);

Parameter

Nama	Jenis	Deskripsi
`numberFormats`	`Object[][]`	Array dua dimensi format angka.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRichTextValue(value)`

Menetapkan nilai Teks Kaya untuk sel dalam rentang.

// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello"
// bolded.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const richText = SpreadsheetApp.newRichTextValue()
                     .setText('Hello world')
                     .setTextStyle(0, 5, bold)
                     .build();
range.setRichTextValue(richText);

Parameter

Nama	Jenis	Deskripsi
`value`	`RichTextValue`	Nilai Rich Text yang diinginkan.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRichTextValues(values)`

Menetapkan petak persegi panjang nilai Rich Text.

// Sets the cells in range A1:A2 to have Rich Text values.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:A2');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const italic = SpreadsheetApp.newTextStyle().setItalic(true).build();
const richTextA1 = SpreadsheetApp.newRichTextValue()
                       .setText('This cell is bold')
                       .setTextStyle(bold)
                       .build();
const richTextA2 = SpreadsheetApp.newRichTextValue()
                       .setText('bold words, italic words')
                       .setTextStyle(0, 11, bold)
                       .setTextStyle(12, 24, italic)
                       .build();
range.setRichTextValues([[richTextA1], [richTextA2]]);

Parameter

Nama	Jenis	Deskripsi
`values`	`RichTextValue[][]`	Nilai Rich Text yang diinginkan.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setShowHyperlink(showHyperlink)`

Menetapkan apakah rentang harus menampilkan hyperlink atau tidak.

// Opens the spreadsheet file by its URL. If you created your script from within
// a Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet()
// instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc123456/edit',
);

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A30 and sets its hyperlink value.
const range = sheet.getRange('A30');
range.setValue('https://www.example.com');

// Sets cell A30 to show hyperlinks.
range.setShowHyperlink(true);

Parameter

Nama	Jenis	Deskripsi
`showHyperlink`	`Boolean`	Apakah akan menampilkan hyperlink atau tidak.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setTextDirection(direction)`

Menetapkan arah teks untuk sel dalam rentang. Jika arah yang ditentukan adalah null, arah akan disimpulkan, lalu ditetapkan.

// Sets right-to-left text direction for the range.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B5:C6');
range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

Parameter

Nama	Jenis	Deskripsi
`direction`	`TextDirection`	Arah teks yang diinginkan; jika `null`, arah akan disimpulkan sebelum setelan.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setTextDirections(directions)`

Menetapkan petak persegi panjang arah teks. Jika arah yang ditentukan adalah null, arah akan disimpulkan, lalu ditetapkan.

// Copies all of the text directions from range A1:B2 over to range C5:D6.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setTextRotations(range1.getTextDirections());

Parameter

Nama	Jenis	Deskripsi
`directions`	`TextDirection[][]`	Arah teks yang diinginkan; jika arah yang ditentukan adalah `null`, arah tersebut akan disimpulkan sebelum disetel.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setTextRotation(degrees)`

Menetapkan setelan rotasi teks untuk sel dalam rentang. Input sesuai dengan sudut antara orientasi teks standar dan orientasi yang diinginkan. Input nol menunjukkan bahwa teks disetel ke orientasi standar.

Untuk arah teks kiri ke kanan, sudut positif berada dalam arah berlawanan arah jarum jam, sedangkan untuk kanan ke kiri, sudut berada dalam arah searah jarum jam.

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setTextRotation(45);

Parameter

Nama	Jenis	Deskripsi
`degrees`	`Integer`	Sudut yang diinginkan antara orientasi standar dan orientasi yang diinginkan. Untuk teks dari kiri ke kanan, sudut positif berada di arah berlawanan arah jarum jam.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setTextRotation(rotation)`

Menetapkan setelan rotasi teks untuk sel dalam rentang.

// Sets all cell's in range B2:D4 to have the same text rotation settings as
// cell A1.
const sheet = SpreadsheetApp.getActiveSheet();

const rotation = sheet.getRange('A1').getTextRotation();

sheet.getRange('B2:D4').setTextRotation(rotation);

Parameter

Nama	Jenis	Deskripsi
`rotation`	`TextRotation`	Setelan rotasi teks yang diinginkan.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setTextRotations(rotations)`

Menetapkan petak persegi panjang rotasi teks.

// Copies all of the text rotations from range A1:B2 over to range C5:D6.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setTextRotations(range1.getTextRotations());

Parameter

Nama	Jenis	Deskripsi
`rotations`	`TextRotation[][]`	Setelan rotasi teks yang diinginkan.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setTextStyle(style)`

Menetapkan gaya teks untuk sel dalam rentang.

// Sets the cells in range C5:D6 to have underlined size 15 font.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('C5:D6');
const style =
    SpreadsheetApp.newTextStyle().setFontSize(15).setUnderline(true).build();
range.setTextStyle(style);

Parameter

Nama	Jenis	Deskripsi
`style`	`TextStyle`	Gaya teks yang diinginkan.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setTextStyles(styles)`

Menetapkan petak persegi panjang gaya teks.

// Sets text styles for cells in range A1:B2
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B2');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const otherStyle = SpreadsheetApp.newTextStyle()
                       .setBold(true)
                       .setUnderline(true)
                       .setItalic(true)
                       .setForegroundColor('#335522')
                       .setFontSize(44)
                       .build();
range.setTextStyles([
  [bold, otherStyle],
  [otherStyle, bold],
]);

Parameter

Nama	Jenis	Deskripsi
`styles`	`TextStyle[][]`	Gaya teks yang diinginkan.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setValue(value)`

Menetapkan nilai rentang. Nilai dapat berupa numerik, string, boolean, atau tanggal. Jika dimulai dengan '=', nilai tersebut akan ditafsirkan sebagai formula.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setValue(100);

Parameter

Nama	Jenis	Deskripsi
`value`	`Object`	Nilai untuk rentang.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setValues(values)`

Menetapkan petak nilai persegi panjang (harus cocok dengan dimensi rentang ini). Jika nilai dimulai dengan =, nilai tersebut akan ditafsirkan sebagai formula.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const values = [['2.000', '1,000,000', '$2.99']];

const range = sheet.getRange('B2:D2');
range.setValues(values);

Parameter

Nama	Jenis	Deskripsi
`values`	`Object[][]`	Array nilai dua dimensi.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setVerticalAlignment(alignment)`

Tetapkan perataan vertikal (atas ke bawah) untuk rentang yang diberikan (atas/tengah/bawah).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setVerticalAlignment('middle');

Parameter

Nama	Jenis	Deskripsi
`alignment`	`String`	Perataan, baik `'top'`, `'middle'`, maupun `'bottom'`; nilai `null` mereset perataan.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setVerticalAlignments(alignments)`

Menetapkan petak persegi panjang dari perataan vertikal (harus cocok dengan dimensi rentang ini).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const alignments = [['top', 'middle', 'bottom']];

const range = sheet.getRange('B2:D2');
range.setVerticalAlignments(alignments);

Parameter

Nama	Jenis	Deskripsi
`alignments`	`Object[][]`	Array perataan dua dimensi, baik `'top'`, `'middle'` maupun `'bottom'`; nilai `null` mereset perataan.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Lihat juga

setVerticalAlignment(alignment)

`setVerticalText(isVertical)`

Menetapkan apakah akan menumpuk teks untuk sel dalam rentang atau tidak. Jika teks ditumpuk secara vertikal, setelan rotasi teks derajat akan diabaikan.

// Sets all cell's in range B2:D4 to have vertically stacked text.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setVerticalText(true);

Parameter

Nama	Jenis	Deskripsi
`isVertical`	`Boolean`	Apakah akan menumpuk teks atau tidak.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setWrap(isWrapEnabled)`

Menetapkan penggabungan sel dari rentang yang diberikan.

Sel dengan penggabungan yang diaktifkan (default) akan diubah ukurannya untuk menampilkan konten lengkapnya. Sel dengan penggabungan dinonaktifkan akan ditampilkan sebanyak mungkin di sel tanpa mengubah ukuran atau berjalan ke beberapa baris.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const cell = sheet.getRange('B2');
cell.setWrap(true);

Parameter

Nama	Jenis	Deskripsi
`isWrapEnabled`	`Boolean`	Apakah akan menggabungkan teks atau tidak.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setWrapStrategies(strategies)`

Menetapkan petak persegi panjang strategi penggabungan.

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setWrapStrategies(range1.getWrapStrategies());

Parameter

Nama	Jenis	Deskripsi
`strategies`	`WrapStrategy[][]`	Strategi penggabungan yang diinginkan.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setWrapStrategy(strategy)`

Menetapkan strategi penggabungan teks untuk sel dalam rentang.

// Sets all cells in range B2:D4 to use the clip wrap strategy.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Parameter

Nama	Jenis	Deskripsi
`strategy`	`WrapStrategy`	Strategi penggabungan yang diinginkan.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setWraps(isWrapEnabled)`

Menetapkan petak persegi panjang kebijakan penggabungan kata (harus cocok dengan dimensi rentang ini). Sel dengan penggabungan yang diaktifkan (default) akan diubah ukurannya untuk menampilkan konten lengkapnya. Sel dengan penggabungan dinonaktifkan akan ditampilkan sebanyak mungkin di sel tanpa mengubah ukuran atau berjalan ke beberapa baris.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
const wraps = [[true, true, false]];

const range = sheet.getRange('B2:D2');
range.setWraps(wraps);

Parameter

Nama	Jenis	Deskripsi
`isWrapEnabled`	`Object[][]`	Array dua dimensi dari variabel penggabungan yang menentukan apakah akan menggabungkan teks dalam sel atau tidak.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Lihat juga

setWrap(isWrapEnabled)

`shiftColumnGroupDepth(delta)`

Mengubah kedalaman pengelompokan kolom rentang dengan jumlah yang ditentukan.

Hal ini akan membuat, mengubah, atau menghapus grup yang berpotongan dengan rentang. Untuk delta positif, grup dibuat dan/atau diubah; untuk delta negatif, grup dihancurkan dan/atau diubah.

Hal ini tidak berpengaruh saat mengurangi kedalaman grup di bawah nol atau di atas delapan.

Jika column group control position adalah BEFORE, hal ini akan menampilkan error saat mencoba menggeser kedalaman baris pertama.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getActiveRange();

// The column grouping depth is increased by 1.
range.shiftColumnGroupDepth(1);

// The column grouping depth is decreased by 1.
range.shiftColumnGroupDepth(-1);

Parameter

Nama	Jenis	Deskripsi
`delta`	`Integer`	Jumlah yang akan digunakan untuk mengubah kedalaman grup kolom dari rentang ini.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Menampilkan

Error — saat mencoba mengubah kedalaman kolom pertama saat posisi kontrolnya adalah GroupControlTogglePosition.BEFORE

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`shiftRowGroupDepth(delta)`

Mengubah kedalaman pengelompokan baris rentang dengan jumlah yang ditentukan.

Hal ini akan membuat, mengubah, atau menghapus grup yang berpotongan dengan rentang. Untuk delta positif, grup dibuat dan/atau diubah; untuk delta negatif, grup dihancurkan dan/atau diubah.

Hal ini tidak berpengaruh saat mengurangi kedalaman grup di bawah nol atau di atas delapan.

Jika row group control position adalah BEFORE, hal ini akan menampilkan error saat mencoba menggeser kedalaman baris pertama.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getActiveRange();

// The row grouping depth is increased by 1.
range.shiftRowGroupDepth(1);

// The row grouping depth is decreased by 1.
range.shiftRowGroupDepth(-1);

Parameter

Nama	Jenis	Deskripsi
`delta`	`Integer`	Jumlah yang akan digunakan untuk mengubah kedalaman grup baris rentang ini.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Menampilkan

Error — saat mencoba menggeser kedalaman baris pertama saat posisi kontrol adalah GroupControlTogglePosition.BEFORE

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`sort(sortSpecObj)`

Menyortir sel dalam rentang yang diberikan, menurut kolom dan urutan yang ditentukan.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('A1:C7');

// Sorts by the values in the first column (A)
range.sort(1);

// Sorts by the values in the second column (B)
range.sort(2);

// Sorts descending by column B
range.sort({column: 2, ascending: false});

// Sorts descending by column B, then ascending by column A
// Note the use of an array
range.sort([
  {column: 2, ascending: false},
  {column: 1, ascending: true},
]);

// For rows that are sorted in ascending order, the "ascending" parameter is
// optional, and just an integer with the column can be used instead. Note that
// in general, keeping the sort specification consistent results in more
// readable code. You can express the earlier sort as:
range.sort([{column: 2, ascending: false}, 1]);

// Alternatively, if you want all columns to be in ascending order, you can use
// the following (this makes column 2 ascending)
range.sort([2, 1]);
// ... which is equivalent to
range.sort([
  {column: 2, ascending: true},
  {column: 1, ascending: true},
]);

Parameter

Nama	Jenis	Deskripsi
`sortSpecObj`	`Object`	Kolom yang akan diurutkan.

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`splitTextToColumns()`

Memisahkan kolom teks menjadi beberapa kolom berdasarkan pemisah yang terdeteksi secara otomatis.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one,one,one      |                 |                 |
// 2 |two,two,two      |                 |                 |
// 3 |three,three,three|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns();

// Result after splitting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`splitTextToColumns(delimiter)`

Memisahkan kolom teks menjadi beberapa kolom menggunakan string yang ditentukan sebagai pembatas kustom.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one#one#one      |                 |                 |
// 2 |two#two#two      |                 |                 |
// 3 |three#three#three|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns('#');

// Result after splitting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parameter

Nama	Jenis	Deskripsi
`delimiter`	`String`	Pembatas kustom yang akan digunakan untuk pemisahan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`splitTextToColumns(delimiter)`

Memisahkan kolom teks menjadi beberapa kolom berdasarkan pemisah yang ditentukan.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one;one;one      |                 |                 |
// 2 |two;two;two      |                 |                 |
// 3 |three;three;three|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after splitting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parameter

Nama	Jenis	Deskripsi
`delimiter`	`TextToColumnsDelimiter`	Pemisah preset untuk pemisahan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`trimWhitespace()`

Memangkas spasi kosong (seperti spasi, tab, atau baris baru) di setiap sel dalam rentang ini. Menghapus semua spasi kosong dari awal dan akhir teks setiap sel, serta mengurangi suburutan karakter spasi kosong yang tersisa menjadi satu spasi.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('A1:A4');
range.activate();
range.setValues([
  ' preceding space',
  'following space ',
  'two  middle  spaces',
  '   =SUM(1,2)',
]);

range.trimWhitespace();

const values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces',
// '=SUM(1,2)']

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`uncheck()`

Mengubah status kotak centang dalam rentang menjadi “tidak dicentang”. Mengabaikan sel dalam rentang yang saat ini tidak berisi nilai dicentang atau tidak dicentang yang dikonfigurasi.

// Changes the state of cells which currently contain either the checked or
// unchecked value configured in the range A1:B10 to 'unchecked'.
const range = SpreadsheetApp.getActive().getRange('A1:B10');
range.uncheck();

Pulang pergi

Range — Rentang ini, untuk pembuatan rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Metode yang tidak digunakan lagi

`getFontColor()`

Tidak digunakan lagi. Diganti dengan getFontColorObject()

Menampilkan warna font sel di sudut kiri atas rentang, dalam notasi CSS (seperti '#ffffff' atau 'white').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getFontColor());

Pulang pergi

String — Warna font dalam notasi CSS (seperti '#ffffff' atau 'white').

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFontColors()`

Tidak digunakan lagi. Diganti dengan getFontColorObjects()

Menampilkan warna font sel dalam rentang dalam notasi CSS (seperti '#ffffff' atau 'white').

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

const results = range.getFontColors();

for (const i in results) {
  for (const j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Pulang pergi

String[][] — Array dua dimensi warna font yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets