Class Range

ช่วง

เข้าถึงและแก้ไขช่วงของสเปรดชีต ช่วงอาจเป็นเซลล์เดียวในแผ่นงาน หรือกลุ่มเซลล์ที่อยู่ติดกันในแผ่นงาน

วิธีการ

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
activate()Rangeตั้งค่าช่วงที่ระบุเป็น active range โดยใช้เซลล์ด้านบนซ้ายในช่วงเป็น current cell
activateAsCurrentCell()Rangeตั้งค่าเซลล์ที่ระบุเป็น current cell
addDeveloperMetadata(key)Rangeเพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่มีคีย์ที่ระบุลงในช่วง
addDeveloperMetadata(key, visibility)Rangeเพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์โดยใช้คีย์ที่ระบุและระดับการเข้าถึง
addDeveloperMetadata(key, value)Rangeเพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ด้วยคีย์และค่าที่ระบุในช่วง
addDeveloperMetadata(key, value, visibility)Rangeเพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ด้วยคีย์ ค่า และการเข้าถึงที่ระบุไปยังช่วง
applyColumnBanding()Bandingใช้ธีมเริ่มต้นของแถบสีกับช่วง
applyColumnBanding(bandingTheme)Bandingใช้ธีมแถบคอลัมน์ที่ระบุกับช่วง
applyColumnBanding(bandingTheme, showHeader, showFooter)Bandingใช้ธีมแถบสีที่ระบุในคอลัมน์กับช่วงการตั้งค่าส่วนหัวและส่วนท้ายที่ระบุ
applyRowBanding()Bandingใช้ธีมแถบสีในแถวเริ่มต้นกับช่วงดังกล่าว
applyRowBanding(bandingTheme)Bandingใช้ธีมแถบสีที่ระบุในแถวกับช่วง
applyRowBanding(bandingTheme, showHeader, showFooter)Bandingใช้ธีมแถบสีที่ระบุในแถวกับการตั้งค่าส่วนหัวและส่วนท้ายที่ระบุ
autoFill(destination, series)voidจะเติมข้อมูลใน destinationRange ตามข้อมูลในช่วงนี้
autoFillToNeighbor(series)voidคํานวณช่วงเพื่อเติมข้อมูลใหม่ตามเซลล์ใกล้เคียงและเติมเต็มช่วงใหม่ด้วยค่าใหม่ตามข้อมูลที่อยู่ในช่วงนี้
breakApart()Rangeแบ่งเซลล์แบบหลายคอลัมน์ในช่วงให้เป็นเซลล์เดียวอีกครั้ง
canEdit()Booleanระบุว่าผู้ใช้มีสิทธิ์ในการแก้ไขทุกเซลล์ในช่วงหรือไม่
check()Rangeเปลี่ยนสถานะของช่องทําเครื่องหมายในช่วงเป็น "เลือกแล้ว"
clear()Rangeล้างช่วงของเนื้อหาและรูปแบบ
clear(options)Rangeล้างช่วงของเนื้อหา รูปแบบ กฎการตรวจสอบข้อมูล และ/หรือความคิดเห็น ตามที่ระบุไว้ในตัวเลือกขั้นสูงที่กําหนดไว้
clearContent()Rangeล้างเนื้อหาของช่วงทิ้งไป ทําให้การจัดรูปแบบยังคงอยู่
clearDataValidations()Rangeล้างกฎการตรวจสอบข้อมูลของช่วง
clearFormat()Rangeล้างการจัดรูปแบบสําหรับช่วงนี้
clearNote()Rangeล้างบันทึกในเซลล์ที่ระบุ
collapseGroups()Rangeยุบกลุ่มทั้งหมดที่อยู่ภายในช่วงทั้งหมด
copyFormatToRange(gridId, column, columnEnd, row, rowEnd)voidคัดลอกการจัดรูปแบบช่วงลงในตําแหน่งที่ระบุ
copyFormatToRange(sheet, column, columnEnd, row, rowEnd)voidคัดลอกการจัดรูปแบบช่วงลงในตําแหน่งที่ระบุ
copyTo(destination)voidคัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงของเซลล์อื่น
copyTo(destination, copyPasteType, transposed)voidคัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงของเซลล์อื่น
copyTo(destination, options)voidคัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงของเซลล์อื่น
copyValuesToRange(gridId, column, columnEnd, row, rowEnd)voidคัดลอกเนื้อหาของช่วงไปยังตําแหน่งที่กําหนด
copyValuesToRange(sheet, column, columnEnd, row, rowEnd)voidคัดลอกเนื้อหาของช่วงไปยังตําแหน่งที่กําหนด
createDataSourcePivotTable(dataSource)DataSourcePivotTableสร้างตาราง Pivot ของแหล่งข้อมูลที่ว่างเปล่าจากแหล่งข้อมูลซึ่งมีการเชื่อมโยงที่เซลล์แรกในช่วงนี้
createDataSourceTable(dataSource)DataSourceTableสร้างตารางแหล่งข้อมูลที่ว่างเปล่าจากแหล่งข้อมูลซึ่งตรึงอยู่ที่เซลล์แรกในช่วงนี้
createDeveloperMetadataFinder()DeveloperMetadataFinderแสดงผล DeveloperMetadataFinderApi เพื่อค้นหาข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ภายในขอบเขตของช่วงนี้
createFilter()Filterสร้างตัวกรองและนําไปใช้กับช่วงที่ระบุในชีต
createPivotTable(sourceData)PivotTableสร้างตาราง Pivot จากจุดยึด sourceData ที่ระบุที่เซลล์แรกในช่วงนี้
createTextFinder(findText)TextFinderสร้างเครื่องมือค้นหาข้อความสําหรับช่วงดังกล่าวซึ่งค้นหาและแทนที่ข้อความในช่วงนี้ได้
deleteCells(shiftDimension)voidลบช่วงเซลล์นี้
expandGroups()Rangeขยายกลุ่มที่ยุบซึ่งมีช่วงหรือตัวควบคุมการสลับที่ตัดกับช่วงนี้
getA1Notation()Stringส่งคืนคําอธิบายสตริงของช่วง ในรูปแบบ A1
getBackground()Stringแสดงสีพื้นหลังของเซลล์ด้านบนซ้ายในช่วง (เช่น '#ffffff')
getBackgroundObject()Colorแสดงสีพื้นหลังของเซลล์ด้านบนซ้ายในช่วง
getBackgroundObjects()Color[][]แสดงผลสีพื้นหลังของเซลล์ในช่วง
getBackgrounds()String[][]แสดงผลสีพื้นหลังของเซลล์ในช่วง (เช่น '#ffffff')
getBandings()Banding[]ส่งคืนแถบทั้งหมดที่ใช้กับเซลล์ในช่วงนี้
getCell(row, column)Rangeแสดงผลเซลล์ที่ระบุในช่วง
getColumn()Integerแสดงผลตําแหน่งคอลัมน์เริ่มต้นของช่วงนี้
getDataRegion()Rangeแสดงผลสําเนาของช่วงที่ขยายในสี่หลัก Directions เพื่อครอบคลุมเซลล์ที่อยู่ติดกันทั้งหมดพร้อมด้วยข้อมูล
getDataRegion(dimension)Rangeแสดงผลสําเนาของช่วงที่ขยาย Direction.UP และ Direction.DOWN หากมิติข้อมูลที่ระบุคือ Dimension.ROWS หรือ Direction.NEXT และ Direction.PREVIOUS หากขนาดเป็น Dimension.COLUMNS
getDataSourceFormula()DataSourceFormulaแสดงผล DataSourceFormula สําหรับเซลล์แรกในช่วง หรือ null หากเซลล์ไม่มีสูตรแหล่งข้อมูล
getDataSourceFormulas()DataSourceFormula[]แสดงผล DataSourceFormula สําหรับเซลล์ในช่วง
getDataSourcePivotTables()DataSourcePivotTable[]รับตาราง Pivot ของแหล่งข้อมูลทั้งหมดซ้อนทับกับช่วง
getDataSourceTables()DataSourceTable[]รับตารางแหล่งข้อมูลทั้งหมดที่ซ้อนทับกับช่วง
getDataSourceUrl()Stringแสดงผล URL สําหรับข้อมูลในช่วงนี้ ซึ่งสามารถใช้สร้างแผนภูมิและคําค้นหาได้
getDataTable()DataTableส่งคืนข้อมูลภายในออบเจ็กต์นี้เป็น DataTable
getDataTable(firstRowIsHeader)DataTableส่งคืนข้อมูลในช่วงนี้เป็นตารางข้อมูล
getDataValidation()DataValidationแสดงกฎการตรวจสอบข้อมูลสําหรับเซลล์ด้านบนซ้ายในช่วง
getDataValidations()DataValidation[][]แสดงกฎการตรวจสอบข้อมูลของเซลล์ทั้งหมดในช่วง
getDeveloperMetadata()DeveloperMetadata[]รับข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับช่วงนี้
getDisplayValue()Stringแสดงผลค่าที่ปรากฏของเซลล์ด้านบนซ้ายในช่วง
getDisplayValues()String[][]แสดงผลตารางกริดแบบสี่เหลี่ยมผืนผ้าของค่าสําหรับช่วงนี้
getFilter()Filterแสดงผลตัวกรองในแผ่นงานที่ช่วงนี้แสดงผล หรือ null หากไม่มีตัวกรองในแผ่นงาน
getFontColorObject()Colorแสดงผลสีแบบอักษรของเซลล์ที่มุมซ้ายบนของช่วง
getFontColorObjects()Color[][]แสดงผลสีแบบอักษรของเซลล์ในช่วง
getFontFamilies()String[][]แสดงผลชุดแบบอักษรของเซลล์ในช่วง
getFontFamily()Stringแสดงผลชุดแบบอักษรของเซลล์ที่มุมบนซ้ายของช่วง
getFontLine()Stringรับรูปแบบเส้นของเซลล์ที่มุมบนซ้ายของช่วง ('underline', 'line-through' หรือ 'none')
getFontLines()String[][]รับรูปแบบเส้นของเซลล์ในช่วง ('underline', 'line-through' หรือ 'none')
getFontSize()Integerแสดงขนาดแบบอักษรในจุดจุดของเซลล์ที่มุมบนซ้ายของช่วง
getFontSizes()Integer[][]แสดงผลขนาดแบบอักษรของเซลล์ในช่วง
getFontStyle()Stringแสดงผลรูปแบบตัวอักษร ('italic' หรือ 'normal') ของเซลล์ในมุมซ้ายบนของช่วง
getFontStyles()String[][]แสดงผลรูปแบบตัวอักษรของเซลล์ในช่วง
getFontWeight()Stringแสดงผลน้ําหนักแบบอักษร (ปกติ/ตัวหนา) ของเซลล์ที่มุมซ้ายบนของช่วง
getFontWeights()String[][]แสดงผลน้ําหนักแบบอักษรของเซลล์ในช่วง
getFormula()Stringแสดงผลสูตร (รูปแบบ A1) สําหรับเซลล์ด้านบนซ้ายของช่วง หรือสตริงว่าง หากเซลล์ว่างเปล่าและไม่มีสูตร
getFormulaR1C1()Stringแสดงผลสูตร (รูปแบบ R1C1) สําหรับเซลล์ที่ระบุ หรือแสดงผล null หากไม่มีเซลล์
getFormulas()String[][]แสดงผลสูตร (ค่า A1) สําหรับเซลล์ในช่วง
getFormulasR1C1()String[][]แสดงผลสูตร (รูปแบบ R1C1) สําหรับเซลล์ในช่วง
getGridId()Integerแสดงผลรหัสตารางกริดของชีตระดับบนสุดของช่วง
getHeight()Integerแสดงผลความสูงของช่วง
getHorizontalAlignment()Stringจะแสดงการจัดข้อความแนวนอน (ซ้าย/กลาง/ขวา) ของเซลล์ในมุมซ้ายบนของช่วง
getHorizontalAlignments()String[][]แสดงการจัดแนวแนวนอนของเซลล์ในช่วง
getLastColumn()Integerแสดงตําแหน่งของคอลัมน์ปิดท้าย
getLastRow()Integerแสดงผลตําแหน่งแถวสุดท้าย
getMergedRanges()Range[]แสดงผลอาร์เรย์ของออบเจ็กต์ Range ที่แสดงเซลล์ที่ผสานแล้วที่อยู่ภายในช่วงปัจจุบันหรือมีอย่างน้อย 1 เซลล์ในช่วงปัจจุบัน
getNextDataCell(direction)Rangeเริ่มต้นจากเซลล์ในคอลัมน์และแถวแรกของช่วง แสดงผลเซลล์ถัดไปในทิศทางที่กําหนดซึ่งเป็นขอบของช่วงเซลล์ที่ต่อเนื่องซึ่งมีข้อมูลอยู่ในเซลล์ หรือเซลล์ที่ขอบของสเปรดชีตในทิศทางนั้น
getNote()Stringแสดงผลบันทึกที่เชื่อมโยงกับช่วงที่ระบุ
getNotes()String[][]แสดงผลบันทึกที่เชื่อมโยงกับเซลล์ในช่วง
getNumColumns()Integerแสดงผลจํานวนคอลัมน์ในช่วงนี้
getNumRows()Integerแสดงผลจํานวนแถวในช่วงนี้
getNumberFormat()Stringรับการจัดรูปแบบตัวเลขหรือวันที่ของเซลล์ด้านบนซ้ายของช่วงที่ระบุ
getNumberFormats()String[][]แสดงผลจํานวนตัวเลขหรือวันที่ของเซลล์ในช่วง
getRichTextValue()RichTextValueแสดงผลค่า Rich Text สําหรับเซลล์ด้านบนซ้ายของช่วง หรือ null ถ้าค่าของเซลล์ไม่ใช่ข้อความ
getRichTextValues()RichTextValue[][]แสดงผลค่า Rich Text สําหรับเซลล์ในช่วงนั้น
getRow()Integerแสดงผลตําแหน่งแถวสําหรับช่วงนี้
getRowIndex()Integerแสดงผลตําแหน่งแถวสําหรับช่วงนี้
getSheet()Sheetแสดงผลแผ่นงานที่อยู่ในช่วงนี้
getTextDirection()TextDirectionแสดงผลทิศทางข้อความสําหรับเซลล์ซ้ายบนของช่วง
getTextDirections()TextDirection[][]แสดงผลเส้นทางข้อความสําหรับเซลล์ในช่วง
getTextRotation()TextRotationแสดงผลการตั้งค่าการหมุนข้อความสําหรับเซลล์ซ้ายบนของช่วง
getTextRotations()TextRotation[][]แสดงผลการตั้งค่าการหมุนเวียนโฆษณาสําหรับเซลล์ในช่วง
getTextStyle()TextStyleแสดงผลรูปแบบข้อความสําหรับเซลล์ซ้ายบนของช่วง
getTextStyles()TextStyle[][]แสดงผลรูปแบบข้อความสําหรับเซลล์ในช่วง
getValue()Objectแสดงผลค่าของเซลล์ด้านบนซ้ายในช่วง
getValues()Object[][]แสดงผลตารางกริดแบบสี่เหลี่ยมผืนผ้าของค่าสําหรับช่วงนี้
getVerticalAlignment()Stringจะแสดงการจัดข้อความในแนวตั้ง (ด้านบน/ตรงกลาง/ด้านล่าง) ของเซลล์ที่มุมซ้ายบนของช่วง
getVerticalAlignments()String[][]แสดงการจัดแนวแนวตั้งของเซลล์ในช่วง
getWidth()Integerแสดงผลความกว้างของช่วงในคอลัมน์
getWrap()Booleanจะแสดงผลว่ามีการตัดข้อความในเซลล์หรือไม่
getWrapStrategies()WrapStrategy[][]แสดงกลยุทธ์การตัดข้อความสําหรับเซลล์ในช่วง
getWrapStrategy()WrapStrategyแสดงผลกลยุทธ์การตัดข้อความสําหรับเซลล์ซ้ายบนของช่วง
getWraps()Boolean[][]จะแสดงผลว่ามีการตัดข้อความในเซลล์หรือไม่
insertCells(shiftDimension)Rangeแทรกเซลล์ที่ว่างในช่วงนี้
insertCheckboxes()Rangeแทรกช่องทําเครื่องหมายลงในแต่ละเซลล์ในช่วง ซึ่งกําหนดค่าด้วย true สําหรับทําเครื่องหมาย และ false เพื่อยกเลิกการเลือก
insertCheckboxes(checkedValue)Rangeแทรกช่องทําเครื่องหมายลงในแต่ละเซลล์ในช่วง ซึ่งกําหนดค่าด้วยค่าที่กําหนดเองสําหรับทําเครื่องหมาย และสตริงว่างสําหรับยกเลิกการเลือก
insertCheckboxes(checkedValue, uncheckedValue)Rangeแทรกช่องทําเครื่องหมายลงในแต่ละเซลล์ในช่วง ซึ่งกําหนดค่าด้วยค่าที่กําหนดเองสําหรับสถานะที่เลือกและไม่ได้เลือกไว้
isBlank()Booleanแสดงผล true หากช่วงดังกล่าวว่างเปล่า
isChecked()Booleanแสดงผลว่าเซลล์ทั้งหมดในช่วงมีสถานะช่องทําเครื่องหมายเป็น "เลือกแล้ว"
isEndColumnBounded()Booleanกําหนดว่าจุดสิ้นสุดของช่วงดังกล่าวเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่งหรือไม่
isEndRowBounded()Booleanกําหนดว่าจุดสิ้นสุดของช่วงดังกล่าวเชื่อมโยงกับแถวใดแถวหนึ่งหรือไม่
isPartOfMerge()Booleanแสดงผล true หากเซลล์ในช่วงปัจจุบันซ้อนทับกับเซลล์ที่ผสานกัน
isStartColumnBounded()Booleanกําหนดจุดเริ่มต้นของช่วงที่จะผูกกับคอลัมน์ใดคอลัมน์หนึ่งหรือไม่
isStartRowBounded()Booleanกําหนดจุดเริ่มต้นของช่วงที่จะผูกกับแถวใดแถวหนึ่งหรือไม่
merge()Rangeผสานเซลล์ในช่วงดังกล่าวเข้าด้วยกันเป็นบล็อกเดียว
mergeAcross()Rangeผสานเซลล์ในช่วงข้ามคอลัมน์ของช่วง
mergeVertically()Rangeผสานเซลล์ในช่วงเข้าด้วยกัน
moveTo(target)voidตัดและวาง (ทั้งรูปแบบและค่า) จากช่วงนี้ไปยังช่วงเป้าหมาย
offset(rowOffset, columnOffset)Rangeแสดงผลช่วงใหม่ที่มีออฟเซ็ตจากช่วงนี้ตามจํานวนแถวและคอลัมน์ที่ระบุ (ซึ่งอาจเป็นลบได้)
offset(rowOffset, columnOffset, numRows)Rangeแสดงผลช่วงใหม่ซึ่งสัมพันธ์กับช่วงปัจจุบัน ซึ่งจุดซ้ายบนจะออฟเซ็ตจากช่วงปัจจุบันด้วยแถวและคอลัมน์ที่กําหนด และตามความสูงที่กําหนดในเซลล์
offset(rowOffset, columnOffset, numRows, numColumns)Rangeแสดงผลช่วงใหม่ซึ่งสัมพันธ์กับช่วงปัจจุบัน ซึ่งจุดซ้ายบนจะออฟเซ็ตจากช่วงปัจจุบันด้วยแถวและคอลัมน์ที่กําหนด และมีความกว้างและความสูงที่กําหนดในเซลล์
protect()Protectionสร้างออบเจ็กต์ที่ป้องกันไม่ให้แก้ไขช่วงได้ ยกเว้นผู้ใช้ที่มีสิทธิ์
randomize()Rangeสุ่มลําดับของแถวในช่วงที่กําหนด
removeCheckboxes()Rangeนําช่องทําเครื่องหมายทั้งหมดออกจากช่วง
removeDuplicates()Rangeลบแถวที่อยู่ในช่วงนี้ที่มีค่าซึ่งซ้ํากับค่าในแถวก่อนหน้า
removeDuplicates(columnsToCompare)Rangeลบแถวที่อยู่ในช่วงนี้ที่มีค่าในคอลัมน์ที่ระบุ ซึ่งซ้ํากับค่าของแถวก่อนหน้า
setBackground(color)Rangeตั้งค่าสีพื้นหลังของเซลล์ทั้งหมดในช่วงในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white')
setBackgroundObject(color)Rangeตั้งค่าสีพื้นหลังของเซลล์ทั้งหมดในช่วง
setBackgroundObjects(color)Rangeตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าสําหรับสีพื้นหลัง (ต้องตรงกับขนาดของช่วงนี้)
setBackgroundRGB(red, green, blue)Rangeตั้งค่าพื้นหลังเป็นสีที่ระบุโดยใช้ค่า RGB (จํานวนเต็มระหว่าง 0 ถึง 255)
setBackgrounds(color)Rangeตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าสําหรับสีพื้นหลัง (ต้องตรงกับขนาดของช่วงนี้)
setBorder(top, left, bottom, right, vertical, horizontal)Rangeตั้งค่าคุณสมบัติเส้นขอบ
setBorder(top, left, bottom, right, vertical, horizontal, color, style)Rangeตั้งค่าคุณสมบัติเส้นขอบด้วยสีและ/หรือรูปแบบ
setDataValidation(rule)Rangeตั้งกฎการตรวจสอบข้อมูล 1 กฎสําหรับเซลล์ทั้งหมดในช่วง
setDataValidations(rules)Rangeตั้งกฎการตรวจสอบข้อมูลของเซลล์ทั้งหมดในช่วง
setFontColor(color)Rangeตั้งค่าสีแบบอักษรในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white')
setFontColorObject(color)Rangeตั้งค่าสีแบบอักษรของช่วงที่ระบุ
setFontColorObjects(colors)Rangeตั้งค่าตารางสีสี่เหลี่ยมผืนผ้าแบบสี่เหลี่ยม (ต้องตรงกับขนาดของช่วงนี้)
setFontColors(colors)Rangeตั้งค่าตารางสีสี่เหลี่ยมผืนผ้าแบบสี่เหลี่ยม (ต้องตรงกับขนาดของช่วงนี้)
setFontFamilies(fontFamilies)Rangeตั้งค่าตารางกริดรูปสี่เหลี่ยมผืนผ้าของชุดแบบอักษร (ต้องตรงกับขนาดในช่วงนี้)
setFontFamily(fontFamily)Rangeตั้งค่าแบบอักษร เช่น "Arial" หรือ "Helvetica"
setFontLine(fontLine)Rangeกําหนดรูปแบบแบบอักษรของช่วงที่ระบุ ('underline', 'line-through' หรือ 'none')
setFontLines(fontLines)Rangeตั้งค่าตารางแบบสี่เหลี่ยมผืนผ้าของรูปแบบเส้น (ต้องตรงกับขนาดในช่วงนี้)
setFontSize(size)Rangeตั้งค่าขนาดแบบอักษร โดยขนาดคือขนาดของจุดที่จะใช้
setFontSizes(sizes)Rangeตั้งค่าตารางกริดของรูปสี่เหลี่ยมผืนผ้าขนาดตัวอักษร (ต้องตรงกับขนาดของช่วงนี้)
setFontStyle(fontStyle)Rangeกําหนดรูปแบบแบบอักษรให้กับช่วงที่ระบุ ('italic' หรือ 'normal')
setFontStyles(fontStyles)Rangeตั้งค่าตารางแบบสี่เหลี่ยมผืนผ้าของรูปแบบตัวอักษร (ต้องตรงกับขนาดในช่วงนี้)
setFontWeight(fontWeight)Rangeตั้งค่าน้ําหนักแบบอักษรสําหรับช่วงที่ระบุ (ปกติ/ตัวหนา)
setFontWeights(fontWeights)Rangeตั้งค่าตารางสี่เหลี่ยมของน้ําหนักแบบอักษร (ต้องตรงกับขนาดในช่วงนี้)
setFormula(formula)Rangeอัปเดตสูตรของช่วงนี้
setFormulaR1C1(formula)Rangeอัปเดตสูตรของช่วงนี้
setFormulas(formulas)Rangeตั้งค่าตารางสี่เหลี่ยมผืนผ้าของสูตร (ต้องตรงกับขนาดของช่วงนี้)
setFormulasR1C1(formulas)Rangeตั้งค่าตารางสี่เหลี่ยมผืนผ้าของสูตร (ต้องตรงกับขนาดของช่วงนี้)
setHorizontalAlignment(alignment)Rangeตั้งค่าการจัดข้อความแนวนอน (ซ้ายไปขวา) ของช่วงที่ระบุ (ซ้าย/ตรงกลาง/ขวา)
setHorizontalAlignments(alignments)Rangeตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าสําหรับการปรับแนวในแนวนอน
setNote(note)Rangeตั้งค่าโน้ตให้กับค่าที่ระบุ
setNotes(notes)Rangeตั้งค่าตารางโน้ตสี่เหลี่ยม (ต้องตรงกับขนาดของช่วงนี้)
setNumberFormat(numberFormat)Rangeตั้งค่ารูปแบบตัวเลขหรือวันที่เป็นสตริงการจัดรูปแบบที่ระบุ
setNumberFormats(numberFormats)Rangeตั้งค่าตารางแบบสี่เหลี่ยมผืนผ้าของรูปแบบตัวเลขหรือวันที่ (ต้องตรงกับมิติข้อมูลของช่วงนี้)
setRichTextValue(value)Rangeตั้งค่า Rich Text สําหรับเซลล์ในช่วงนั้น
setRichTextValues(values)Rangeตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าสําหรับค่า Rich Text
setShowHyperlink(showHyperlink)Rangeตั้งค่าว่าช่วงนี้ควรแสดงไฮเปอร์ลิงก์หรือไม่
setTextDirection(direction)Rangeตั้งค่าทิศทางข้อความสําหรับเซลล์ในช่วง
setTextDirections(directions)Rangeตั้งค่าตารางสี่เหลี่ยมของเส้นทางข้อความ
setTextRotation(degrees)Rangeกําหนดการตั้งค่าการหมุนข้อความสําหรับเซลล์ในช่วงนั้น
setTextRotation(rotation)Rangeกําหนดการตั้งค่าการหมุนข้อความสําหรับเซลล์ในช่วงนั้น
setTextRotations(rotations)Rangeตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าสําหรับการหมุนข้อความ
setTextStyle(style)Rangeกําหนดรูปแบบข้อความให้กับเซลล์ในช่วงข้อความ
setTextStyles(styles)Rangeตั้งค่าตารางแบบสี่เหลี่ยมผืนผ้าของรูปแบบข้อความ
setValue(value)Rangeตั้งค่าของช่วง
setValues(values)Rangeตั้งค่าตารางค่าสี่เหลี่ยมผืนผ้า (ต้องตรงกับมิติข้อมูลของช่วงนี้)
setVerticalAlignment(alignment)Rangeตั้งค่าจัดข้อความแนวตั้ง (บน/ล่าง) ของช่วงที่ระบุ (ด้านบน/ตรงกลาง/ด้านล่าง)
setVerticalAlignments(alignments)Rangeตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าสําหรับการจัดข้อความแนวตั้ง (ต้องตรงกับมิติข้อมูลของช่วงนี้)
setVerticalText(isVertical)Rangeตั้งค่าว่าจะซ้อนข้อความของเซลล์ในช่วงหรือไม่
setWrap(isWrapEnabled)Rangeตั้งค่าการตัดเซลล์ของช่วงที่ระบุ
setWrapStrategies(strategies)Rangeตั้งค่าตารางกริดของกลยุทธ์การรวม
setWrapStrategy(strategy)Rangeตั้งค่ากลยุทธ์การตัดข้อความสําหรับเซลล์ในช่วง
setWraps(isWrapEnabled)Rangeตั้งค่านโยบายการตัดคําแบบตารางสี่เหลี่ยม (ต้องตรงกับมิติข้อมูลของช่วงนี้)
shiftColumnGroupDepth(delta)Rangeเปลี่ยนความลึกในการจัดกลุ่มคอลัมน์ของช่วงตามจํานวนที่ระบุ
shiftRowGroupDepth(delta)Rangeเปลี่ยนความลึกในการจัดกลุ่มแถวของช่วงตามจํานวนที่ระบุ
sort(sortSpecObj)Rangeจัดเรียงเซลล์ในช่วงที่กําหนด ตามคอลัมน์และลําดับที่ระบุ
splitTextToColumns()voidแบ่งคอลัมน์ข้อความออกเป็นหลายคอลัมน์โดยพิจารณาจากตัวคั่นที่ตรวจพบโดยอัตโนมัติ
splitTextToColumns(delimiter)voidแบ่งคอลัมน์ข้อความออกเป็นหลายคอลัมน์โดยใช้สตริงที่ระบุเป็นตัวคั่นที่กําหนดเอง
splitTextToColumns(delimiter)voidแบ่งคอลัมน์ข้อความออกเป็นหลายคอลัมน์โดยพิจารณาจากตัวคั่นที่กําหนด
trimWhitespace()Rangeตัดการเว้นวรรค (เช่น เว้นวรรค แท็บ หรือบรรทัดใหม่) ในทุกเซลล์ในช่วงนี้
uncheck()Rangeเปลี่ยนสถานะของช่องทําเครื่องหมายที่อยู่ในช่วงเป็น "ไม่เลือก"

เอกสารโดยละเอียด

activate()

ตั้งค่าช่วงที่ระบุเป็น active range โดยใช้เซลล์ด้านบนซ้ายในช่วงเป็น current cell

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

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

ขากลับ

Range — ช่วงนี้สําหรับเชน


activateAsCurrentCell()

ตั้งค่าเซลล์ที่ระบุเป็น current cell

หากเซลล์ที่ระบุอยู่ในช่วงที่มีอยู่ ช่วงนั้นจะกลายเป็นช่วงที่มีการใช้งานด้วยเซลล์เป็นเซลล์ปัจจุบัน

หากเซลล์ที่ระบุไม่อยู่ในช่วงใดๆ ที่มีอยู่ ระบบจะนําการเลือกที่มีอยู่ออก และเซลล์นั้นกลายเป็นเซลล์ปัจจุบันและช่วงที่มีการใช้งาน

หมายเหตุ: Range ที่ระบุต้องมีเซลล์เดียว ไม่เช่นนั้นจะยกเว้นข้อยกเว้น

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

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

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

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

addDeveloperMetadata(key)

เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่มีคีย์ที่ระบุลงในช่วง

// 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());

พารามิเตอร์

ชื่อTypeคำอธิบาย
keyStringคีย์สําหรับข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ใหม่

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

addDeveloperMetadata(key, visibility)

เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์โดยใช้คีย์ที่ระบุและระดับการเข้าถึง

// 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());

พารามิเตอร์

ชื่อTypeคำอธิบาย
keyStringคีย์สําหรับข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ใหม่
visibilityDeveloperMetadataVisibilityระดับการเข้าถึงข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ใหม่

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

addDeveloperMetadata(key, value)

เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ด้วยคีย์และค่าที่ระบุในช่วง

// 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' 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());

พารามิเตอร์

ชื่อTypeคำอธิบาย
keyStringคีย์สําหรับข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ใหม่
valueStringค่าข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ใหม่

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

addDeveloperMetadata(key, value, visibility)

เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ด้วยคีย์ ค่า และการเข้าถึงที่ระบุไปยังช่วง

// 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());

พารามิเตอร์

ชื่อTypeคำอธิบาย
keyStringคีย์สําหรับข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ใหม่
valueStringค่าข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ใหม่
visibilityDeveloperMetadataVisibilityระดับการเข้าถึงข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ใหม่

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

applyColumnBanding()

ใช้ธีมเริ่มต้นของแถบสีกับช่วง โดยค่าเริ่มต้น แถบสีมีส่วนหัวและไม่มีสีส่วนท้าย

// 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());

ขากลับ

Banding — วงใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

applyColumnBanding(bandingTheme)

ใช้ธีมแถบคอลัมน์ที่ระบุกับช่วง โดยค่าเริ่มต้น แถบสีมีส่วนหัวและจะไม่มีส่วนท้าย

// 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());

พารามิเตอร์

ชื่อTypeคำอธิบาย
bandingThemeBandingThemeธีมสีที่จะนําไปใช้กับคอลัมน์ในช่วงนั้นๆ

ขากลับ

Banding — วงใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

applyColumnBanding(bandingTheme, showHeader, showFooter)

ใช้ธีมแถบสีที่ระบุในคอลัมน์กับช่วงการตั้งค่าส่วนหัวและส่วนท้ายที่ระบุ

// 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());

พารามิเตอร์

ชื่อTypeคำอธิบาย
bandingThemeBandingThemeธีมสีที่จะนําไปใช้กับคอลัมน์ในช่วงนั้นๆ
showHeaderBooleanหากเป็น true ระบบจะใช้สีส่วนหัวของธีมสีที่คอลัมน์แรก
showFooterBooleanหากเป็น true ระบบจะใช้สีส่วนท้ายของธีมสีที่คอลัมน์สุดท้าย

ขากลับ

Banding — วงใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

applyRowBanding()

ใช้ธีมแถบสีในแถวเริ่มต้นกับช่วงดังกล่าว โดยค่าเริ่มต้น แถบสีมีส่วนหัวและไม่มีสีส่วนท้าย

ขากลับ

Banding — วงใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

applyRowBanding(bandingTheme)

ใช้ธีมแถบสีที่ระบุในแถวกับช่วง โดยค่าเริ่มต้น แถบสีมีส่วนหัวและไม่มีสีส่วนท้าย

พารามิเตอร์

ชื่อTypeคำอธิบาย
bandingThemeBandingThemeธีมสีที่จะใช้กับแถวในช่วง

ขากลับ

Banding — วงใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

applyRowBanding(bandingTheme, showHeader, showFooter)

ใช้ธีมแถบสีที่ระบุในแถวกับการตั้งค่าส่วนหัวและส่วนท้ายที่ระบุ

พารามิเตอร์

ชื่อTypeคำอธิบาย
bandingThemeBandingThemeธีมสีที่จะใช้กับแถวในช่วง
showHeaderBooleanหากเป็น true ระบบจะใช้สีส่วนหัวของธีมสีในแถวแรก
showFooterBooleanหากเป็น true ระบบจะใช้สีส่วนท้ายของธีมสีในแถวสุดท้าย

ขากลับ

Banding — วงใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

autoFill(destination, series)

จะเติมข้อมูลใน destinationRange ตามข้อมูลในช่วงนี้ ค่าใหม่จะกําหนดโดยประเภท series ที่ระบุด้วย ช่วงปลายทางต้องประกอบด้วยช่วงนี้และขยายไปในทิศทางเดียวเท่านั้น ตัวอย่างเช่น ค่า A1:A20 ต่อไปนี้จะเพิ่มตัวเลขขึ้นโดยอ้างอิงจากค่าปัจจุบันใน A1:A4

var sheet = SpreadsheetApp.getActiveSheet();

// Has values [1, 2, 3, 4].
var sourceRange = sheet.getRange("A1:A4");
// The range to fill with values.
var 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);

พารามิเตอร์

ชื่อTypeคำอธิบาย
destinationRangeช่วงที่จะป้อนค่าโดยอัตโนมัติ ช่วงปลายทางควรมีช่วงนี้และขยายเพียงทิศทางเดียว (ขึ้น ลง ซ้าย หรือขวา)
seriesAutoFillSeriesประเภทของซีรี่ส์ AutoFill ที่ควรใช้เพื่อคํานวณค่าใหม่ ผลของชุดนี้จะแตกต่างกันไปตามประเภทและปริมาณข้อมูลต้นฉบับ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

autoFillToNeighbor(series)

คํานวณช่วงเพื่อเติมข้อมูลใหม่ตามเซลล์ใกล้เคียงและเติมเต็มช่วงใหม่ด้วยค่าใหม่ตามข้อมูลที่อยู่ในช่วงนี้ ค่าใหม่เหล่านี้กําหนดโดยประเภท series ที่ระบุด้วย

ช่วงปลายทางที่คํานวณจะพิจารณาข้อมูลโดยรอบเพื่อกําหนดว่าควรแทรกค่าใหม่ที่ใด กล่าวคือ ถ้ามีข้อมูลทางด้านซ้ายหรือขวาของคอลัมน์ที่กําลังป้อนข้อมูลโดยอัตโนมัติ ค่าใหม่จะขยายไปถึงข้อมูลที่อยู่ติดกันเท่านั้น

เช่น ถ้า A1:A20 เต็มไปด้วยชุดตัวเลขที่มากขึ้น และระบบจะเรียกใช้วิธีนี้ในช่วง B1:B4 ที่มีชุดวันที่ ระบบจะแทรกค่าใหม่เป็น B5:B20 เท่านั้น ด้วยวิธีนี้ ค่าใหม่เหล่านี้จะ "ติด" กับเซลล์ที่มีค่าในคอลัมน์ A

var sheet = SpreadsheetApp.getActiveSheet();

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

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
seriesAutoFillSeriesประเภทของซีรี่ส์ AutoFill ที่ควรใช้เพื่อคํานวณค่าใหม่ ผลของชุดนี้จะแตกต่างกันไปตามประเภทและปริมาณข้อมูลต้นฉบับ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

breakApart()

แบ่งเซลล์แบบหลายคอลัมน์ในช่วงให้เป็นเซลล์เดียวอีกครั้ง

การเรียกใช้ฟังก์ชันนี้ในช่วงจะเท่ากับการเลือกช่วงและคลิก รูปแบบ -> รวม -> เลิกผสาน

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

canEdit()

ระบุว่าผู้ใช้มีสิทธิ์ในการแก้ไขทุกเซลล์ในช่วงหรือไม่ เจ้าของสเปรดชีตสามารถแก้ไขช่วงและแผ่นงานที่มีการป้องกันได้เสมอ

ขากลับ

Booleantrue หากผู้ใช้มีสิทธิ์แก้ไขทุกเซลล์ในช่วง มิเช่นนั้นให้ false

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

check()

เปลี่ยนสถานะของช่องทําเครื่องหมายในช่วงเป็น "เลือกแล้ว" ละเว้นเซลล์ในช่วงที่ขณะนี้ยังไม่ได้กําหนดค่าที่เลือกหรือไม่ได้เลือกไว้

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

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

clear()

ล้างช่วงของเนื้อหาและรูปแบบ

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

var range = sheet.getRange("A1:D10");
range.clear();

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

clear(options)

ล้างช่วงของเนื้อหา รูปแบบ กฎการตรวจสอบข้อมูล และ/หรือความคิดเห็น ตามที่ระบุไว้ในตัวเลือกขั้นสูงที่กําหนดไว้ โดยค่าเริ่มต้น ข้อมูลทั้งหมดจะถูกล้าง

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
optionsObjectออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูงดังที่แสดงด้านล่าง

พารามิเตอร์ขั้นสูง

ชื่อTypeคำอธิบาย
commentsOnlyBooleanล้างเฉพาะความคิดเห็นหรือไม่
contentsOnlyBooleanล้างเฉพาะเนื้อหาหรือไม่
formatOnlyBooleanกําหนดว่าจะล้างเฉพาะรูปแบบหรือไม่ โปรดทราบว่ารูปแบบการล้างข้อมูลจะล้างกฎการตรวจสอบข้อมูลด้วย
validationsOnlyBooleanล้างเฉพาะกฎการตรวจสอบข้อมูลหรือไม่
skipFilteredRowsBooleanดูว่าจะหลีกเลี่ยงการล้างแถวที่กรองหรือไม่

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

clearContent()

ล้างเนื้อหาของช่วงทิ้งไป ทําให้การจัดรูปแบบยังคงอยู่

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

var range = sheet.getRange("A1:D10");
range.clearContent();

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

clearDataValidations()

ล้างกฎการตรวจสอบข้อมูลของช่วง

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

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

clearFormat()

ล้างการจัดรูปแบบสําหรับช่วงนี้

การดําเนินการนี้จะล้างการจัดรูปแบบข้อความของเซลล์หรือช่วงในช่วงนั้น แต่จะไม่รีเซ็ตกฎการจัดรูปแบบตัวเลข

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

var range = sheet.getRange("A1:D10");
range.clearFormat();

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

clearNote()

ล้างบันทึกในเซลล์ที่ระบุ

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

var range = sheet.getRange("A1:D10");
range.clearNote();

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

collapseGroups()

ยุบกลุ่มทั้งหมดที่อยู่ภายในช่วงทั้งหมด ถ้าไม่มีกลุ่มใดภายในช่วงนั้นเลย ระบบจะยุบกลุ่มซึ่งลึกที่สุดที่อยู่ในช่วงบางส่วนออก

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

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

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

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

คัดลอกการจัดรูปแบบช่วงลงในตําแหน่งที่ระบุ หากปลายทางมีขนาดใหญ่กว่าหรือเล็กกว่าช่วงที่มา จะถือว่าแหล่งที่มาซ้ําหรือถูกตัด โปรดทราบว่าวิธีนี้จะคัดลอกเฉพาะการจัดรูปแบบเท่านั้น

สําหรับคําอธิบายโดยละเอียดของพารามิเตอร์ gridId โปรดดู getGridId()

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

var 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);

พารามิเตอร์

ชื่อTypeคำอธิบาย
gridIdIntegerรหัสที่ไม่ซ้ํากันของแผ่นงานภายในสเปรดชีต โดยไม่คํานึงถึงอันดับ
columnIntegerคอลัมน์แรกของช่วงเป้าหมาย
columnEndIntegerคอลัมน์สุดท้ายของช่วงเป้าหมาย
rowIntegerแถวเริ่มต้นของช่วงเป้าหมาย
rowEndIntegerแถวสุดท้ายของช่วงเป้าหมาย

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม


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

คัดลอกการจัดรูปแบบช่วงลงในตําแหน่งที่ระบุ หากปลายทางมีขนาดใหญ่กว่าหรือเล็กกว่าช่วงที่มา จะถือว่าแหล่งที่มาซ้ําหรือถูกตัด โปรดทราบว่าวิธีนี้จะคัดลอกเฉพาะการจัดรูปแบบเท่านั้น

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

var 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);

พารามิเตอร์

ชื่อTypeคำอธิบาย
sheetSheetชีตเป้าหมาย
columnIntegerคอลัมน์แรกของช่วงเป้าหมาย
columnEndIntegerคอลัมน์สุดท้ายของช่วงเป้าหมาย
rowIntegerแถวเริ่มต้นของช่วงเป้าหมาย
rowEndIntegerแถวสุดท้ายของช่วงเป้าหมาย

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

copyTo(destination)

คัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงของเซลล์อื่น ระบบจะคัดลอกทั้งค่าและการจัดรูปแบบ

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
destinationRangeช่วงปลายทางที่ต้องการคัดลอกไป โดยจะมีเฉพาะตําแหน่งของเซลล์ที่มุมบนซ้ายเท่านั้น

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

copyTo(destination, copyPasteType, transposed)

คัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงของเซลล์อื่น

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
destinationRangeช่วงปลายทางที่ต้องการคัดลอกไป โดยจะมีเฉพาะตําแหน่งของเซลล์ที่มุมบนซ้ายเท่านั้น
copyPasteTypeCopyPasteTypeประเภทที่ระบุวิธีวางเนื้อหาของช่วงในปลายทาง
transposedBooleanควรวางช่วงในการวางแนวที่สลับตําแหน่งหรือไม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

copyTo(destination, options)

คัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงของเซลล์อื่น โดยค่าเริ่มต้น ระบบจะคัดลอกทั้งค่าและการจัดรูปแบบ แต่สามารถแทนที่ได้โดยใช้อาร์กิวเมนต์ขั้นสูง

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
destinationRangeช่วงปลายทางที่ต้องการคัดลอกไป โดยจะมีเฉพาะตําแหน่งของเซลล์ที่มุมบนซ้ายเท่านั้น
optionsObjectออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูงดังที่แสดงด้านล่าง

พารามิเตอร์ขั้นสูง

ชื่อTypeคำอธิบาย
formatOnlyBooleanระบุว่าควรมีการคัดลอกเฉพาะรูปแบบเท่านั้น
contentsOnlyBooleanระบุว่าควรมีการคัดลอกเฉพาะเนื้อหาเท่านั้น

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

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

คัดลอกเนื้อหาของช่วงไปยังตําแหน่งที่กําหนด หากปลายทางมีขนาดใหญ่กว่าหรือเล็กกว่าช่วงที่มา จะถือว่าแหล่งที่มาซ้ําหรือถูกตัด

สําหรับคําอธิบายโดยละเอียดของพารามิเตอร์ gridId โปรดดู getGridId()

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

var 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);

พารามิเตอร์

ชื่อTypeคำอธิบาย
gridIdIntegerรหัสที่ไม่ซ้ํากันของแผ่นงานภายในสเปรดชีต โดยไม่คํานึงถึงอันดับ
columnIntegerคอลัมน์แรกของช่วงเป้าหมาย
columnEndIntegerคอลัมน์สุดท้ายของช่วงเป้าหมาย
rowIntegerแถวเริ่มต้นของช่วงเป้าหมาย
rowEndIntegerแถวสุดท้ายของช่วงเป้าหมาย

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม


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

คัดลอกเนื้อหาของช่วงไปยังตําแหน่งที่กําหนด หากปลายทางมีขนาดใหญ่กว่าหรือเล็กกว่าช่วงที่มา จะถือว่าแหล่งที่มาซ้ําหรือถูกตัด

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

var 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);

พารามิเตอร์

ชื่อTypeคำอธิบาย
sheetSheetชีตเป้าหมาย
columnIntegerคอลัมน์แรกของช่วงเป้าหมาย
columnEndIntegerคอลัมน์สุดท้ายของช่วงเป้าหมาย
rowIntegerแถวเริ่มต้นของช่วงเป้าหมาย
rowEndIntegerแถวสุดท้ายของช่วงเป้าหมาย

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

createDataSourcePivotTable(dataSource)

สร้างตาราง Pivot ของแหล่งข้อมูลที่ว่างเปล่าจากแหล่งข้อมูลซึ่งมีการเชื่อมโยงที่เซลล์แรกในช่วงนี้

ตัวอย่างนี้แสดงวิธีสร้างและกําหนดค่าตาราง Pivot ของแหล่งข้อมูลใหม่

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

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
dataSourceDataSourceแหล่งข้อมูลที่ใช้สร้างตาราง Pivot

ขากลับ

DataSourcePivotTable — ตาราง Pivot ของแหล่งข้อมูลที่สร้างใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

createDataSourceTable(dataSource)

สร้างตารางแหล่งข้อมูลที่ว่างเปล่าจากแหล่งข้อมูลซึ่งตรึงอยู่ที่เซลล์แรกในช่วงนี้

ตัวอย่างนี้แสดงวิธีสร้างและกําหนดค่าตารางแหล่งข้อมูลใหม่

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

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
dataSourceDataSourceแหล่งข้อมูลที่ใช้สร้างตาราง Pivot

ขากลับ

DataSourceTable — ตารางแหล่งข้อมูลที่สร้างใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

createDeveloperMetadataFinder()

แสดงผล DeveloperMetadataFinderApi เพื่อค้นหาข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ภายในขอบเขตของช่วงนี้ ข้อมูลเมตาจะอยู่ภายในขอบเขตของช่วงข้อมูลเฉพาะเมื่ออยู่ในช่วงดังกล่าวเท่านั้น ตัวอย่างเช่น ข้อมูลเมตาที่เชื่อมโยงกับแถว "3:3" ไม่ได้อยู่ในขอบเขตของช่วง "A1:D5" แต่อยู่ภายในขอบเขตของช่วง "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());

ขากลับ

DeveloperMetadataFinder — เครื่องมือค้นหาข้อมูลเมตาของนักพัฒนาซอฟต์แวร์เพื่อค้นหาข้อมูลเมตาในขอบเขตของช่วงนี้


createFilter()

สร้างตัวกรองและนําไปใช้กับช่วงที่ระบุในชีต คุณไม่สามารถสร้างตัวกรอง ในแผ่นงานได้มากกว่าหนึ่งรายการ หากต้องการเข้าถึงและแก้ไขตัวกรองหลังจากสร้างตัวกรอง ให้ใช้ getFilter() หรือ Sheet.getFilter()

let ss = SpreadsheetApp.getActiveSheet();
let 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() {
  let filter = range.getFilter();
  let criteria = SpreadsheetApp.newFilterCriteria()
    .whenCellNotEmpty()
    .build();
  filter.setColumnFilterCriteria(2, criteria);
}
ใช้วิธีนี้เพื่อสร้างตัวกรองสําหรับชีต Grid รายการ ซึ่งเป็นชีตประเภทเริ่มต้น แผ่นงานตารางกริดคือแผ่นงานที่ไม่ได้เชื่อมต่อกับฐานข้อมูล หากต้องการสร้างตัวกรองประเภทอื่นๆ โปรดดูหัวข้อต่อไปนี้

ขากลับ

Filter — ตัวกรองใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

createPivotTable(sourceData)

สร้างตาราง Pivot จากจุดยึด sourceData ที่ระบุที่เซลล์แรกในช่วงนี้

// 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());

พารามิเตอร์

ชื่อTypeคำอธิบาย
sourceDataRangeข้อมูลที่จะสร้างตาราง Pivot จากตาราง

ขากลับ

PivotTablePivotTable ที่สร้างใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

createTextFinder(findText)

สร้างเครื่องมือค้นหาข้อความสําหรับช่วงดังกล่าวซึ่งค้นหาและแทนที่ข้อความในช่วงนี้ได้

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

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

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

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
findTextStringข้อความที่จะค้นหา

ขากลับ

TextFinderTextFinder ของช่วง


deleteCells(shiftDimension)

ลบช่วงเซลล์นี้ ข้อมูลที่มีอยู่ในแผ่นงานตามขนาดที่ระบุจะเลื่อนไปอยู่ที่ช่วงที่ถูกลบ

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

var range = sheet.getRange("A1:D10");
range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);

พารามิเตอร์

ชื่อTypeคำอธิบาย
shiftDimensionDimensionมิติข้อมูลที่ใช้ย้ายข้อมูลที่มีอยู่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

expandGroups()

ขยายกลุ่มที่ยุบซึ่งมีช่วงหรือตัวควบคุมการสลับที่ตัดกับช่วงนี้ ตําแหน่งสลับการควบคุมคือดัชนีที่มีการสลับปุ่มควบคุมไว้ ก่อนหรือหลังกลุ่มโดยตรง ทั้งนี้ขึ้นอยู่กับการตั้งค่า หากมีกลุ่มมากกว่า 1 กลุ่มในตําแหน่งเดียวกัน ระบบจะขยายกลุ่มระดับตื้นที่สุด

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

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

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getA1Notation()

ส่งคืนคําอธิบายสตริงของช่วง ในรูปแบบ A1

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

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

ขากลับ

String — คําอธิบายสตริงของช่วงในรูปแบบ A1

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getBackground()

แสดงสีพื้นหลังของเซลล์ด้านบนซ้ายในช่วง (เช่น '#ffffff')

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

var cell = sheet.getRange("B5");
Logger.log(cell.getBackground());

ขากลับ

String — รหัสสีของพื้นหลัง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getBackgroundObject()

แสดงสีพื้นหลังของเซลล์ด้านบนซ้ายในช่วง

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

var cell = sheet.getRange("B5");
Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());

ขากลับ

Color — สีพื้นหลังของเซลล์ด้านบนซ้ายในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getBackgroundObjects()

แสดงผลสีพื้นหลังของเซลล์ในช่วง

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

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

ขากลับ

Color[][] — อาร์เรย์ 2 มิติของสีพื้นหลัง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getBackgrounds()

แสดงผลสีพื้นหลังของเซลล์ในช่วง (เช่น '#ffffff')

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

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

ขากลับ

String[][] — อาร์เรย์สองสีของรหัสสีของพื้นหลัง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getBandings()

ส่งคืนแถบทั้งหมดที่ใช้กับเซลล์ในช่วงนี้

// 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 (let banding of bandings) {
  console.log(banding.getSecondRowColor());
}

ขากลับ

Banding[] — แถบทั้งหมดที่ใช้กับเซลล์ในช่วงนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getCell(row, column)

แสดงผลเซลล์ที่ระบุในช่วง

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

var 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
var cell = range.getCell(1, 1);
Logger.log(cell.getValue());

พารามิเตอร์

ชื่อTypeคำอธิบาย
rowIntegerแถวของเซลล์ที่สัมพันธ์กับช่วง
columnIntegerคอลัมน์ของเซลล์ที่สัมพันธ์กับช่วง

ขากลับ

Range — ช่วงที่มีเซลล์เดียวในพิกัดที่ระบุ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getColumn()

แสดงผลตําแหน่งคอลัมน์เริ่มต้นของช่วงนี้

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

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

ขากลับ

Integer — ตําแหน่งคอลัมน์เริ่มต้นของช่วงในสเปรดชีต

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDataRegion()

แสดงผลสําเนาของช่วงที่ขยายในสี่หลัก Directions เพื่อครอบคลุมเซลล์ที่อยู่ติดกันทั้งหมดพร้อมด้วยข้อมูล ถ้าช่วงนั้นถูกล้อมรอบด้วยเซลล์ว่างที่ไม่รวมในเส้นทแยงมุม ช่วงจะถูกส่งคืน ซึ่งคล้ายกับการเลือกช่วงและ พิมพ์ Ctrl+A ในตัวแก้ไข

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var 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());

ขากลับ

Range — เขตข้อมูลหรือช่วงของสเปรดชีตทั้งหมด

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDataRegion(dimension)

แสดงผลสําเนาของช่วงที่ขยาย Direction.UP และ Direction.DOWN หากมิติข้อมูลที่ระบุคือ Dimension.ROWS หรือ Direction.NEXT และ Direction.PREVIOUS หากขนาดเป็น Dimension.COLUMNS การขยายช่วงจะขึ้นอยู่กับการตรวจหาข้อมูลที่อยู่ในช่วงที่เป็นตาราง ช่วงที่ขยายครอบคลุมเซลล์ทั้งหมดที่ติดกันซึ่งมีข้อมูลในเซลล์เหล่านั้นตามมิติข้อมูลที่ระบุ รวมถึงขอบเขตของตาราง ถ้าช่วงดั้งเดิมรายล้อมไปด้วยเซลล์ว่างตามมิติข้อมูลที่ระบุ ระบบจะแสดงผลช่วงดังกล่าวเอง วิธีการนี้คล้ายกับการเลือกช่วงและพิมพ์ Ctrl+Space สําหรับคอลัมน์ หรือ Shift+Space สําหรับแถวในเครื่องมือแก้ไข

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var 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());

พารามิเตอร์

ชื่อTypeคำอธิบาย
dimensionDimensionมิติข้อมูลที่จะขยายช่วง

ขากลับ

Range — เขตข้อมูลของช่วงหรือช่วงที่ครอบคลุมแต่ละคอลัมน์หรือแต่ละแถวโดยแยกตามช่วงต้นฉบับ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDataSourceFormula()

แสดงผล DataSourceFormula สําหรับเซลล์แรกในช่วง หรือ null หากเซลล์ไม่มีสูตรแหล่งข้อมูล

ขากลับ

DataSourceFormulaDataSourceFormula ของเซลล์

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDataSourceFormulas()

แสดงผล DataSourceFormula สําหรับเซลล์ในช่วง

ขากลับ

DataSourceFormula[] — อาร์เรย์ของ DataSourceFormula

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDataSourcePivotTables()

รับตาราง Pivot ของแหล่งข้อมูลทั้งหมดซ้อนทับกับช่วง

ขากลับ

DataSourcePivotTable[] — รายการตาราง Pivot ของแหล่งข้อมูล

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDataSourceTables()

รับตารางแหล่งข้อมูลทั้งหมดที่ซ้อนทับกับช่วง

ขากลับ

DataSourceTable[] — รายการตารางแหล่งข้อมูล

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDataSourceUrl()

แสดงผล URL สําหรับข้อมูลในช่วงนี้ ซึ่งสามารถใช้สร้างแผนภูมิและคําค้นหาได้

โค้ด

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

  var 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>

ขากลับ

String — URL สําหรับช่วงนี้เป็นแหล่งข้อมูลที่ส่งต่อไปยัง API อื่นๆ ได้ เช่น แผนภูมิ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDataTable()

ส่งคืนข้อมูลภายในออบเจ็กต์นี้เป็น DataTable

ขากลับ

DataTable — ข้อมูลที่เป็นตารางข้อมูล


getDataTable(firstRowIsHeader)

ส่งคืนข้อมูลในช่วงนี้เป็นตารางข้อมูล

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

// Calling this method with "true" sets the first line to be the title of the axes
var 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.
var chart = Charts.newBarChart()
    .setDataTable(datatable)
    .setOption("title", "Your Title Here")
    .build();

พารามิเตอร์

ชื่อTypeคำอธิบาย
firstRowIsHeaderBooleanกําหนดแถวแรกเป็นส่วนหัวหรือไม่

ขากลับ

DataTable — ข้อมูลที่เป็นตารางข้อมูล

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDataValidation()

แสดงกฎการตรวจสอบข้อมูลสําหรับเซลล์ด้านบนซ้ายในช่วง หากยังไม่ได้ตั้งค่าการตรวจสอบข้อมูล เซลล์นี้จะส่งคืนค่า null

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var 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.')
}

ขากลับ

DataValidation — กฎการตรวจสอบข้อมูลสําหรับเซลล์ด้านบนซ้ายในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDataValidations()

แสดงกฎการตรวจสอบข้อมูลของเซลล์ทั้งหมดในช่วง หากยังไม่ได้ตั้งค่าการตรวจสอบข้อมูล ในเซลล์ที่ระบุ เมธอดนี้จะส่งคืน null สําหรับตําแหน่งของเซลล์นั้นในอาร์เรย์

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

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

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var 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);

ขากลับ

DataValidation[][] — อาร์เรย์ 2 มิติของกฎการตรวจสอบข้อมูลที่เชื่อมโยงกับเซลล์ในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDeveloperMetadata()

รับข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับช่วงนี้

ขากลับ

DeveloperMetadata[] — ข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับช่วงนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDisplayValue()

แสดงผลค่าที่ปรากฏของเซลล์ด้านบนซ้ายในช่วง ค่านี้คือ String ค่าที่แสดงจะคํานึงถึงการจัดรูปแบบวันที่ เวลา และสกุลเงิน รวมถึงรูปแบบที่ใช้โดยอัตโนมัติตามการตั้งค่าภาษาของสเปรดชีต ส่วนเซลล์ว่างจะแสดงสตริงว่าง

ขากลับ

String — ค่าที่แสดงในเซลล์นี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDisplayValues()

แสดงผลตารางกริดแบบสี่เหลี่ยมผืนผ้าของค่าสําหรับช่วงนี้

แสดงผลอาร์เรย์ 2 มิติของค่าที่แสดง จัดทําดัชนีตามแถว จากนั้นตามคอลัมน์ ค่าคือออบเจ็กต์ String ค่าที่แสดงจะพิจารณาวันที่ เวลา และรูปแบบสกุลเงิน รวมถึงรูปแบบที่การตั้งค่าภาษาของสเปรดชีตใช้โดยอัตโนมัติ เซลล์ว่างจะแสดงเป็นสตริงว่างเปล่าในอาร์เรย์ โปรดทราบว่าในขณะที่ดัชนีช่วงเริ่มต้นที่ 1, 1 อาร์เรย์ JavaScript จะได้รับการจัดทําดัชนีจาก [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.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues();
Logger.log(values[0][0]);

ขากลับ

String[][] — อาร์เรย์ของค่าสองมิติ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getFilter()

แสดงผลตัวกรองในแผ่นงานที่ช่วงนี้แสดงผล หรือ null หากไม่มีตัวกรองในแผ่นงาน

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

ขากลับ

Filter — ตัวกรอง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getFontColorObject()

แสดงผลสีแบบอักษรของเซลล์ที่มุมซ้ายบนของช่วง

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

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

ขากลับ

Color — สีแบบอักษรของเซลล์ด้านบนซ้ายในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getFontColorObjects()

แสดงผลสีแบบอักษรของเซลล์ในช่วง

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

var results = range.getFontColorObjects();

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

ขากลับ

Color[][] — อาร์เรย์ของสีแบบอักษร 2 มิติที่เชื่อมโยงกับเซลล์ในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getFontFamilies()

แสดงผลชุดแบบอักษรของเซลล์ในช่วง

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

var results = range.getFontFamilies();

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

ขากลับ

String[][] — อาร์เรย์สองมิติของชุดแบบอักษรที่เชื่อมโยงกับเซลล์ในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getFontFamily()

แสดงผลชุดแบบอักษรของเซลล์ที่มุมบนซ้ายของช่วง

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

Logger.log(range.getFontFamily());

ขากลับ

String — แบบอักษรของเซลล์

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getFontLine()

รับรูปแบบเส้นของเซลล์ที่มุมบนซ้ายของช่วง ('underline', 'line-through' หรือ 'none')

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

Logger.log(range.getFontLine());

ขากลับ

String — บรรทัดแบบอักษร

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getFontLines()

รับรูปแบบเส้นของเซลล์ในช่วง ('underline', 'line-through' หรือ 'none')

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

var results = range.getFontLines();

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

ขากลับ

String[][] — อาร์เรย์สองบรรทัดของแบบอักษรที่เชื่อมโยงกับเซลล์ในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getFontSize()

แสดงขนาดแบบอักษรในจุดจุดของเซลล์ที่มุมบนซ้ายของช่วง

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

Logger.log(range.getFontSize());

ขากลับ

Integer — ขนาดแบบอักษรในจุด

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getFontSizes()

แสดงผลขนาดแบบอักษรของเซลล์ในช่วง

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

var results = range.getFontSizes();

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

ขากลับ

Integer[][] — อาร์เรย์แบบ 2 มิติของขนาดแบบอักษรของข้อความที่เชื่อมโยงกับเซลล์ในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getFontStyle()

แสดงผลรูปแบบตัวอักษร ('italic' หรือ 'normal') ของเซลล์ในมุมซ้ายบนของช่วง

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

Logger.log(range.getFontStyle());

ขากลับ

String — รูปแบบตัวอักษรของข้อความในเซลล์

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getFontStyles()

แสดงผลรูปแบบตัวอักษรของเซลล์ในช่วง

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

var results = range.getFontStyles();

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

ขากลับ

String[][] — อาร์เรย์แบบ 2 มิติของรูปแบบตัวอักษรของข้อความที่เชื่อมโยงกับเซลล์ในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getFontWeight()

แสดงผลน้ําหนักแบบอักษร (ปกติ/ตัวหนา) ของเซลล์ที่มุมซ้ายบนของช่วง

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

Logger.log(range.getFontWeight());

ขากลับ

String — น้ําหนักแบบอักษรของข้อความในเซลล์

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getFontWeights()

แสดงผลน้ําหนักแบบอักษรของเซลล์ในช่วง

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

var results = range.getFontWeights();

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

ขากลับ

String[][] — อาร์เรย์แบบสองมิติของน้ําหนักแบบอักษรของข้อความที่เกี่ยวข้องกับเซลล์ในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getFormula()

แสดงผลสูตร (รูปแบบ A1) สําหรับเซลล์ด้านบนซ้ายของช่วง หรือสตริงว่าง หากเซลล์ว่างเปล่าและไม่มีสูตร

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

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

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

ขากลับ

String — สูตรสําหรับเซลล์

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getFormulaR1C1()

แสดงผลสูตร (รูปแบบ R1C1) สําหรับเซลล์ที่ระบุ หรือแสดงผล null หากไม่มีเซลล์

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

var range = sheet.getRange("B5");
var formula = range.getFormulaR1C1();
Logger.log(formula);

ขากลับ

String — สูตรในรูปแบบ R1C1

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getFormulas()

แสดงผลสูตร (ค่า A1) สําหรับเซลล์ในช่วง รายการในอาร์เรย์ 2 มิติคือสตริงว่างสําหรับเซลล์ที่ไม่มีสูตร

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

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

ขากลับ

String[][] — อาร์เรย์ของมิติข้อมูล 2 มิติในรูปแบบสตริง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getFormulasR1C1()

แสดงผลสูตร (รูปแบบ R1C1) สําหรับเซลล์ในช่วง รายการในอาร์เรย์ 2 มิติคือ null สําหรับเซลล์ที่ไม่มีสูตร

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

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

ขากลับ

String[][] — อาร์เรย์ของสูตร 2 มิติในรูปแบบ R1C1

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getGridId()

แสดงผลรหัสตารางกริดของชีตระดับบนสุดของช่วง รหัสเป็นค่า int แบบสุ่มที่ไม่เป็นลบ

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

Logger.log(range.getGridId());

ขากลับ

Integer — รหัสตารางกริดของชีตระดับบนสุด

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getHeight()

แสดงผลความสูงของช่วง

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

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

ขากลับ

Integer — ความสูงของช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getHorizontalAlignment()

จะแสดงการจัดข้อความแนวนอน (ซ้าย/กลาง/ขวา) ของเซลล์ในมุมซ้ายบนของช่วง

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

Logger.log(range.getHorizontalAlignment());

ขากลับ

String — การจัดแนวข้อความตามข้อความในเซลล์

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getHorizontalAlignments()

แสดงการจัดแนวแนวนอนของเซลล์ในช่วง

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

var results = range.getHorizontalAlignments();

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

ขากลับ

String[][] — อาร์เรย์แบบ 2 มิติของการจัดเรียงข้อความแนวนอนที่เชื่อมโยงกับเซลล์ในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getLastColumn()

แสดงตําแหน่งของคอลัมน์ปิดท้าย

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

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

ขากลับ

Integer — ตําแหน่งคอลัมน์สิ้นสุดช่วงในสเปรดชีต

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getLastRow()

แสดงผลตําแหน่งแถวสุดท้าย

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

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

ขากลับ

Integer — ตําแหน่งแถวสิ้นสุดของช่วงในสเปรดชีต

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getMergedRanges()

แสดงผลอาร์เรย์ของออบเจ็กต์ Range ที่แสดงเซลล์ที่ผสานแล้วที่อยู่ภายในช่วงปัจจุบันหรือมีอย่างน้อย 1 เซลล์ในช่วงปัจจุบัน

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

var range = sheet.getRange("A1:B3");

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

ขากลับ

Range[] — อาร์เรย์ของออบเจ็กต์ Range ที่แทนเซลล์ที่ผสานซ้อนกันในช่วง


getNextDataCell(direction)

เริ่มต้นจากเซลล์ในคอลัมน์และแถวแรกของช่วง แสดงผลเซลล์ถัดไปในทิศทางที่กําหนดซึ่งเป็นขอบของช่วงเซลล์ที่ต่อเนื่องซึ่งมีข้อมูลอยู่ในเซลล์ หรือเซลล์ที่ขอบของสเปรดชีตในทิศทางนั้น ซึ่งเทียบเท่ากับการพิมพ์ Ctrl+[arrow key] ในเครื่องมือแก้ไข

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

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
directionDirectionทิศทางไปยังเซลล์ Edge ของเขตข้อมูลถัดไป

ขากลับ

Range — เซลล์ขอบเขตข้อมูลหรือเซลล์ที่ขอบของสเปรดชีต

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getNote()

แสดงผลบันทึกที่เชื่อมโยงกับช่วงที่ระบุ

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

Logger.log(range.getNote());

ขากลับ

String — โน้ตที่เกี่ยวข้องกับเซลล์ที่ระบุ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getNotes()

แสดงผลบันทึกที่เชื่อมโยงกับเซลล์ในช่วง

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

var results = range.getNotes();

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

ขากลับ

String[][] — อาร์เรย์ของโน้ต 2 มิติที่เชื่อมโยงกับเซลล์ในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getNumColumns()

แสดงผลจํานวนคอลัมน์ในช่วงนี้

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

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumColumns());

ขากลับ

Integer — จํานวนคอลัมน์ในช่วงนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getNumRows()

แสดงผลจํานวนแถวในช่วงนี้

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

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumRows());

ขากลับ

Integer — จํานวนแถวในช่วงนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getNumberFormat()

รับการจัดรูปแบบตัวเลขหรือวันที่ของเซลล์ด้านบนซ้ายของช่วงที่ระบุ โปรดดูรูปแบบรูปแบบที่แสดงผลในเอกสารประกอบของ Sheets API

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

var cell = sheet.getRange("C4");
Logger.log(cell.getNumberFormat());

ขากลับ

String — รูปแบบตัวเลขของเซลล์ด้านบนซ้ายของช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getNumberFormats()

แสดงผลจํานวนตัวเลขหรือวันที่ของเซลล์ในช่วง โปรดดูคําอธิบายเกี่ยวกับรูปแบบที่แสดงผลได้ในเอกสารประกอบของ Sheets API

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

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

ขากลับ

String[][] — อาร์เรย์แบบ 2 มิติของรูปแบบตัวเลข

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getRichTextValue()

แสดงผลค่า Rich Text สําหรับเซลล์ด้านบนซ้ายของช่วง หรือ null ถ้าค่าของเซลล์ไม่ใช่ข้อความ

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

ขากลับ

RichTextValue — ค่า Rich Text ของเซลล์ซ้ายบนของช่วง หรือ null หากค่าของเซลล์ไม่ใช่ข้อความ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getRichTextValues()

แสดงผลค่า Rich Text สําหรับเซลล์ในช่วงนั้น

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

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

ขากลับ

RichTextValue[][] — อาร์เรย์ 2 มิติของค่า Rich Text

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getRow()

แสดงผลตําแหน่งแถวสําหรับช่วงนี้ เหมือนกับ getRowIndex()

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

var range = sheet.getRange("B2");
Logger.log(range.getRow());

ขากลับ

Integer — ตําแหน่งแถวของช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getRowIndex()

แสดงผลตําแหน่งแถวสําหรับช่วงนี้ เหมือนกับ getRow()

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

var range = sheet.getRange("B2");
Logger.log(range.getRowIndex());

ขากลับ

Integer — ตําแหน่งแถวของช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม


getSheet()

แสดงผลแผ่นงานที่อยู่ในช่วงนี้

ขากลับ

Sheet — แผ่นงานที่อยู่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getTextDirection()

แสดงผลทิศทางข้อความสําหรับเซลล์ซ้ายบนของช่วง แสดงผล null หากระบบกําหนดทิศทางข้อความเซลล์ด้วยการตรวจหาอัตโนมัติ

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

ขากลับ

TextDirection — ทิศทางข้อความของเซลล์ซ้ายบนสุดในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getTextDirections()

แสดงผลเส้นทางข้อความสําหรับเซลล์ในช่วง ข้อมูลในอาร์เรย์ 2 มิติมีค่าเป็น null สําหรับเซลล์ที่ใช้การตรวจหาอัตโนมัติ

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

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

ขากลับ

TextDirection[][] — อาร์เรย์ของข้อความแบบ 2 มิติ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getTextRotation()

แสดงผลการตั้งค่าการหมุนข้อความสําหรับเซลล์ซ้ายบนของช่วง

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

var cell = sheet.getRange("A1");
Logger.log(cell.getTextRotation());

ขากลับ

TextRotation — การตั้งค่าการหมุนเวียนโฆษณา

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getTextRotations()

แสดงผลการตั้งค่าการหมุนเวียนโฆษณาสําหรับเซลล์ในช่วง

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

var results = range.getTextRotations();

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

ขากลับ

TextRotation[][] — อาร์เรย์แบบ 2 มิติของการหมุนข้อความที่เชื่อมโยงกับเซลล์ในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getTextStyle()

แสดงผลรูปแบบข้อความสําหรับเซลล์ซ้ายบนของช่วง

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

ขากลับ

TextStyle — รูปแบบข้อความของเซลล์ซ้ายบนสุดในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getTextStyles()

แสดงผลรูปแบบข้อความสําหรับเซลล์ในช่วง

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

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

ขากลับ

TextStyle[][] — อาร์เรย์ของลักษณะข้อความ 2 มิติ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getValue()

แสดงผลค่าของเซลล์ด้านบนซ้ายในช่วง ค่าอาจเป็นประเภท Number, Boolean, Date หรือ String ขึ้นอยู่กับค่าของเซลล์ เซลล์จะ ส่งคืนสตริงที่ว่างเปล่า

ขากลับ

Object — ค่าในเซลล์นี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getValues()

แสดงผลตารางกริดแบบสี่เหลี่ยมผืนผ้าของค่าสําหรับช่วงนี้

แสดงผลอาร์เรย์ของมิติข้อมูล 2 มิติที่จัดทําดัชนีตามแถว จากนั้นแยกตามคอลัมน์ ค่าอาจเป็นประเภท Number, Boolean, Date หรือ String ทั้งนี้ขึ้นอยู่กับค่าของเซลล์ เซลล์ว่างจะแสดงเป็นสตริงว่างเปล่าในอาร์เรย์ จําไว้ว่า ขณะที่ดัชนีช่วงเริ่มต้นที่ 1, 1 อาร์เรย์ JavaScript จะได้รับการจัดทําดัชนีจาก [0][0]

// The code below gets the values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues();
Logger.log(values[0][0]);
ในเว็บแอป ค่า Date ไม่ใช่พารามิเตอร์ทางกฎหมาย getValues() จะไม่สามารถส่งคืนข้อมูลไปยังเว็บแอป หากช่วงดังกล่าวมีเซลล์ที่มีค่า Date ให้แปลงค่าที่ดึงมาจากชีตทั้งหมดเป็น JavaScript พื้นฐานที่รองรับ เช่น Number, Boolean หรือ String

ขากลับ

Object[][] — อาร์เรย์ของค่าสองมิติ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getVerticalAlignment()

จะแสดงการจัดข้อความในแนวตั้ง (ด้านบน/ตรงกลาง/ด้านล่าง) ของเซลล์ที่มุมซ้ายบนของช่วง

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

Logger.log(range.getVerticalAlignment());

ขากลับ

String — การจัดแนวข้อความในแนวตั้ง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getVerticalAlignments()

แสดงการจัดแนวแนวตั้งของเซลล์ในช่วง

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

var results = range.getVerticalAlignments();

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

ขากลับ

String[][] — อาร์เรย์สองมิติของการจัดข้อความแนวตั้งที่เกี่ยวข้องกับเซลล์ในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getWidth()

แสดงผลความกว้างของช่วงในคอลัมน์

ขากลับ

Integer — จํานวนคอลัมน์ในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getWrap()

จะแสดงผลว่ามีการตัดข้อความในเซลล์หรือไม่ หากต้องการกลยุทธ์การรวมที่ละเอียดยิ่งขึ้น ให้ใช้ getWrapStrategy()

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

Logger.log(range.getWrap());

ขากลับ

Boolean — ข้อความในเซลล์นี้รวมหรือไม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getWrapStrategies()

แสดงกลยุทธ์การตัดข้อความสําหรับเซลล์ในช่วง

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

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

ขากลับ

WrapStrategy[][] — อาร์เรย์ 2 มิติของกลยุทธ์การตัดข้อความ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getWrapStrategy()

แสดงผลกลยุทธ์การตัดข้อความสําหรับเซลล์ซ้ายบนของช่วง

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

ขากลับ

WrapStrategy — กลยุทธ์การตัดข้อความของเซลล์ซ้ายบนสุดในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getWraps()

จะแสดงผลว่ามีการตัดข้อความในเซลล์หรือไม่ หากต้องการกลยุทธ์การรวมที่ละเอียดยิ่งขึ้น ให้ใช้ getWrapStrategies()

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

var results = range.getVerticalAlignments();

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

ขากลับ

Boolean[][] — อาร์เรย์สองมิติของการจัดข้อความแนวตั้งที่เกี่ยวข้องกับเซลล์ในช่วง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

insertCells(shiftDimension)

แทรกเซลล์ที่ว่างในช่วงนี้ เซลล์ใหม่จะคงการจัดรูปแบบปัจจุบันในเซลล์ที่ช่วงนี้ใช้อยู่ ข้อมูลที่มีอยู่ในแผ่นงานตามขนาดที่ระบุจะ ถูกตัดออกจากช่วงที่แทรกไว้

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

var range = sheet.getRange("A1:D10");
range.insertCells(SpreadsheetApp.Dimension.COLUMNS);

พารามิเตอร์

ชื่อTypeคำอธิบาย
shiftDimensionDimensionมิติข้อมูลที่ใช้ย้ายข้อมูลที่มีอยู่

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

insertCheckboxes()

แทรกช่องทําเครื่องหมายลงในแต่ละเซลล์ในช่วง ซึ่งกําหนดค่าด้วย true สําหรับทําเครื่องหมาย และ false เพื่อยกเลิกการเลือก ตั้งค่าของเซลล์ทั้งหมดในช่วงเป็น false

var 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();

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

insertCheckboxes(checkedValue)

แทรกช่องทําเครื่องหมายลงในแต่ละเซลล์ในช่วง ซึ่งกําหนดค่าด้วยค่าที่กําหนดเองสําหรับทําเครื่องหมาย และสตริงว่างสําหรับยกเลิกการเลือก ตั้งค่าแต่ละเซลล์ในช่วงเป็นสตริงว่าง

var 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');

พารามิเตอร์

ชื่อTypeคำอธิบาย
checkedValueObjectค่าที่เลือกสําหรับการตรวจสอบข้อมูลช่องทําเครื่องหมาย

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

insertCheckboxes(checkedValue, uncheckedValue)

แทรกช่องทําเครื่องหมายลงในแต่ละเซลล์ในช่วง ซึ่งกําหนดค่าด้วยค่าที่กําหนดเองสําหรับสถานะที่เลือกและไม่ได้เลือกไว้ ตั้งค่าของแต่ละเซลล์ในช่วงเป็นค่าที่ไม่ได้เลือกไว้

var 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');

พารามิเตอร์

ชื่อTypeคำอธิบาย
checkedValueObjectค่าที่เลือกสําหรับการตรวจสอบข้อมูลช่องทําเครื่องหมาย
uncheckedValueObjectค่าที่ไม่ได้เลือกไว้สําหรับการตรวจสอบความถูกต้องของข้อมูลในช่องทําเครื่องหมาย

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

isBlank()

แสดงผล true หากช่วงดังกล่าวว่างเปล่า

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

Logger.log(range.isBlank());

ขากลับ

Booleantrue หากไม่มีช่วง ให้เว้นว่างไว้ false

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

isChecked()

แสดงผลว่าเซลล์ทั้งหมดในช่วงมีสถานะช่องทําเครื่องหมายเป็น "เลือกแล้ว" แสดงผล null หากมีการเลือกบางเซลล์โดยไม่ทําเครื่องหมายส่วนที่เหลือ หรือบางเซลล์ไม่มีการตรวจสอบข้อมูลช่องทําเครื่องหมาย

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

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

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

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

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

ขากลับ

Booleantrue ถ้ายกเลิกการเลือกทุกเซลล์ในช่วง false ยกเลิกการเลือกเซลล์ทั้งหมดในนั้น หรือ null ถ้ายกเลิกการเลือกเซลล์ใด หรือไม่มีการตรวจสอบความถูกต้องของช่องทําเครื่องหมาย

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

isEndColumnBounded()

กําหนดว่าจุดสิ้นสุดของช่วงดังกล่าวเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่งหรือไม่ เช่น สําหรับช่วง A1:B10 หรือ B:B ที่ผูกกับคอลัมน์ที่ท้ายช่วง วิธีนี้จะแสดงผลค่า true สําหรับช่วง 3:7 หรือ A1:5 ที่ผูกกับแถวใดแถวหนึ่งเมื่อสิ้นสุดช่วงดังกล่าว เมธอดนี้จะแสดงผล false

ขากลับ

Booleantrue ถ้าจุดสิ้นสุดของช่วงเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่ง false มิฉะนั้น

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

isEndRowBounded()

กําหนดว่าจุดสิ้นสุดของช่วงดังกล่าวเชื่อมโยงกับแถวใดแถวหนึ่งหรือไม่ เช่น สําหรับช่วง A1:B10 หรือ 3:7 ซึ่งผูกกับแถวหลังช่วงดังกล่าว เมธอดนี้จะแสดงค่า true สําหรับช่วง B:B หรือ A1:C ที่ผูกกับคอลัมน์ใดคอลัมน์หนึ่งเมื่อสิ้นสุดช่วงดังกล่าว เมธอดนี้จะแสดงผล false

ขากลับ

Booleantrue ถ้าจุดสิ้นสุดของช่วงเชื่อมโยงกับแถวใดแถวหนึ่ง false หรือในกรณีอื่น

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

isPartOfMerge()

แสดงผล true หากเซลล์ในช่วงปัจจุบันซ้อนทับกับเซลล์ที่ผสานกัน

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

var range = sheet.getRange("A1:B3");

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

ขากลับ

Booleantrue หากช่วงซ้อนทับกับเซลล์ที่ผสาน มิเช่นนั้น จะแสดงผล false


isStartColumnBounded()

กําหนดจุดเริ่มต้นของช่วงที่จะผูกกับคอลัมน์ใดคอลัมน์หนึ่งหรือไม่ เช่น สําหรับช่วง A1:B10 หรือ B:B ซึ่งผูกกับคอลัมน์ที่จุดเริ่มต้นของช่วง เมธอดนี้จะแสดงค่า true สําหรับช่วง 3:7 ซึ่งผูกกับแถวที่จุดเริ่มต้นของช่วงเท่านั้น เมธอดนี้จะแสดงค่า false

ขากลับ

Booleantrue หากจุดเริ่มต้นของช่วงเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่ง false มิฉะนั้นจะเป็นเช่นนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

isStartRowBounded()

กําหนดจุดเริ่มต้นของช่วงที่จะผูกกับแถวใดแถวหนึ่งหรือไม่ ตัวอย่างเช่น สําหรับช่วง A1:B10 หรือ 3:7 ซึ่งผูกกับแถวที่จุดเริ่มต้นของช่วง เมธอดนี้จะแสดงค่า true สําหรับช่วง B:B ที่เชื่อมโยงกับคอลัมน์เฉพาะที่จุดเริ่มต้นของช่วง เมธอดนี้จะแสดงค่า false

ขากลับ

Booleantrue หากจุดเริ่มต้นของช่วงเชื่อมโยงกับแถวใดแถวหนึ่ง false หรือในกรณีอื่น

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

merge()

ผสานเซลล์ในช่วงดังกล่าวเข้าด้วยกันเป็นบล็อกเดียว

var sheet = SpreadsheetApp.getActiveSheet();

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

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

mergeAcross()

ผสานเซลล์ในช่วงข้ามคอลัมน์ของช่วง

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

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

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

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

mergeVertically()

ผสานเซลล์ในช่วงเข้าด้วยกัน

var 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();

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

moveTo(target)

ตัดและวาง (ทั้งรูปแบบและค่า) จากช่วงนี้ไปยังช่วงเป้าหมาย

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
targetRangeช่วงเป้าหมายที่ต้องการคัดลอกช่วงนี้ โดยให้มีเฉพาะตําแหน่งของเซลล์ด้านบนซ้ายเท่านั้น

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

offset(rowOffset, columnOffset)

แสดงผลช่วงใหม่ที่มีออฟเซ็ตจากช่วงนี้ตามจํานวนแถวและคอลัมน์ที่ระบุ (ซึ่งอาจเป็นลบได้) ช่วงใหม่มีขนาดเดียวกันกับช่วงเดิม

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

var cell = sheet.getRange("A1");

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
rowOffsetIntegerจํานวนแถวจากเซลล์ด้านบนซ้ายของช่วง ค่าลบหมายถึงแถวขึ้นจากเซลล์ด้านบนซ้ายของช่วง
columnOffsetIntegerจํานวนคอลัมน์จากเซลล์ซ้ายด้านบนของช่วง ค่าลบแสดงคอลัมน์ซ้ายจากเซลล์ซ้ายสุดของช่วง

ขากลับ

Range — ช่วงนี้สําหรับเชน


offset(rowOffset, columnOffset, numRows)

แสดงผลช่วงใหม่ซึ่งสัมพันธ์กับช่วงปัจจุบัน ซึ่งจุดซ้ายบนจะออฟเซ็ตจากช่วงปัจจุบันด้วยแถวและคอลัมน์ที่กําหนด และตามความสูงที่กําหนดในเซลล์

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

var cell = sheet.getRange("A1");

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
rowOffsetIntegerจํานวนแถวจากเซลล์ด้านบนซ้ายของช่วง ค่าลบหมายถึงแถวขึ้นจากเซลล์ด้านบนซ้ายของช่วง
columnOffsetIntegerจํานวนคอลัมน์จากเซลล์ซ้ายด้านบนของช่วง ค่าลบแสดงคอลัมน์ซ้ายจากเซลล์ซ้ายสุดของช่วง
numRowsIntegerความสูงของแถวของช่วงใหม่

ขากลับ

Range — ช่วงนี้สําหรับเชน


offset(rowOffset, columnOffset, numRows, numColumns)

แสดงผลช่วงใหม่ซึ่งสัมพันธ์กับช่วงปัจจุบัน ซึ่งจุดซ้ายบนจะออฟเซ็ตจากช่วงปัจจุบันด้วยแถวและคอลัมน์ที่กําหนด และมีความกว้างและความสูงที่กําหนดในเซลล์

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

var cell = sheet.getRange("A1");

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
rowOffsetIntegerจํานวนแถวจากเซลล์ด้านบนซ้ายของช่วง ค่าลบหมายถึงแถวขึ้นจากเซลล์ด้านบนซ้ายของช่วง
columnOffsetIntegerจํานวนคอลัมน์จากเซลล์ซ้ายด้านบนของช่วง ค่าลบแสดงคอลัมน์ซ้ายจากเซลล์ซ้ายสุดของช่วง
numRowsIntegerความสูงของแถวของช่วงใหม่
numColumnsIntegerความกว้างในคอลัมน์ของช่วงใหม่

ขากลับ

Range — ช่วงนี้สําหรับเชน


protect()

สร้างออบเจ็กต์ที่ป้องกันไม่ให้แก้ไขช่วงได้ ยกเว้นผู้ใช้ที่มีสิทธิ์ จนกว่าสคริปต์จะเปลี่ยนรายการเครื่องมือแก้ไขสําหรับช่วงดังกล่าว (โดยเรียก Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses) หรือตั้งค่าใหม่ให้กับ Protection.setDomainEdit(editable)) สิทธิ์จะสะท้อนถึงสเปรดชีตเหล่านั้นโดยตรง ซึ่งหมายความว่าช่วงดังกล่าวจะไม่มีการป้องกัน หากช่วงดังกล่าวได้รับการปกป้องแล้ว วิธีนี้จะสร้างช่วงที่มีการป้องกันใหม่ซึ่งซ้อนทับกับช่วงที่มีอยู่ ถ้าเซลล์ได้รับการป้องกันโดยช่วงที่มีการป้องกันหลายช่วง ถ้ามีช่วงใดช่วงหนึ่งทําให้ผู้ใช้แก้ไขเซลล์ไม่ได้ แสดงว่าผู้ใช้รายนั้นไม่อนุญาตให้แก้ไขเซลล์นั้น

// Protect range A1:B10, then remove all other users from the list of editors.
var ss = SpreadsheetApp.getActive();
var range = ss.getRange('A1:B10');
var 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.
var me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

ขากลับ

Protection — ออบเจ็กต์ที่แสดงการตั้งค่าการป้องกัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

randomize()

สุ่มลําดับของแถวในช่วงที่กําหนด

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

// Randomizes the range
range.randomize();

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

removeCheckboxes()

นําช่องทําเครื่องหมายทั้งหมดออกจากช่วง ล้างการตรวจสอบข้อมูลของแต่ละเซลล์และล้างค่าของเซลล์นั้นด้วย หากเซลล์มีค่าที่เลือกหรือไม่ได้ทําเครื่องหมาย

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

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

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

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

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

removeDuplicates()

ลบแถวที่อยู่ในช่วงนี้ที่มีค่าซึ่งซ้ํากับค่าในแถวก่อนหน้า แถวที่มีค่าเหมือนกัน แต่มีตัวอักษรพิมพ์เล็กพิมพ์ใหญ่ การจัดรูปแบบ หรือสูตรต่างกันจะถือว่าเป็นรายการที่ซ้ํากัน เมธอดนี้จะนําแถวที่ซ้ํากันที่ซ่อนอยู่ออกจากมุมมองด้วย (เช่น เพราะตัวกรอง) เนื้อหาที่อยู่นอกช่วงนี้จะไม่ถูกนําออก

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

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

ขากลับ

Range — ช่วงที่เป็นผลลัพธ์หลังจากนํารายการที่ซ้ํากันออกแล้ว ระบบจะลดขนาดช่วงลง 1 แถวสําหรับทุกแถวที่นําออก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

removeDuplicates(columnsToCompare)

ลบแถวที่อยู่ในช่วงนี้ที่มีค่าในคอลัมน์ที่ระบุ ซึ่งซ้ํากับค่าของแถวก่อนหน้า แถวที่มีค่าเหมือนกัน แต่มีตัวอักษรพิมพ์เล็กพิมพ์ใหญ่ การจัดรูปแบบ หรือสูตรต่างกันจะถือว่าเป็นรายการที่ซ้ํากัน วิธีนี้จะลบแถวที่ซ้ํากันซึ่งซ่อนจากมุมมองด้วย (เช่น เนื่องจากการใช้ตัวกรอง) เนื้อหาที่อยู่นอกช่วงนี้จะไม่ถูกนําออก

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var 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]);

พารามิเตอร์

ชื่อTypeคำอธิบาย
columnsToCompareInteger[]คอลัมน์ที่จะวิเคราะห์เพื่อหาค่าที่ซ้ํากัน หากไม่มีการระบุคอลัมน์ ระบบจะวิเคราะห์คอลัมน์ทั้งหมดเพื่อหารายการซ้ํา

ขากลับ

Range — ช่วงที่เป็นผลลัพธ์หลังจากนํารายการที่ซ้ํากันออกแล้ว ระบบจะลดขนาดช่วงลง 1 แถวสําหรับทุกแถวที่นําออก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setBackground(color)

ตั้งค่าสีพื้นหลังของเซลล์ทั้งหมดในช่วงในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white')

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

var range = sheet.getRange("B2:D5");
range.setBackground("red");

พารามิเตอร์

ชื่อTypeคำอธิบาย
colorStringรหัสสีในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white') ส่วนค่า null จะรีเซ็ตสี

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setBackgroundObject(color)

ตั้งค่าสีพื้นหลังของเซลล์ทั้งหมดในช่วง

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

var range = sheet.getRange("B2:D5");
range.setBackgroundObject(bgColor);

พารามิเตอร์

ชื่อTypeคำอธิบาย
colorColorสีพื้นหลังที่ตั้งค่า ค่า null จะรีเซ็ตสีพื้นหลัง

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setBackgroundObjects(color)

ตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าสําหรับสีพื้นหลัง (ต้องตรงกับขนาดของช่วงนี้)

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

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setBackgroundObjects(colors);

พารามิเตอร์

ชื่อTypeคำอธิบาย
colorColor[][]ชุดสี 2 มิติ ค่า null รีเซ็ตสี

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setBackgroundRGB(red, green, blue)

ตั้งค่าพื้นหลังเป็นสีที่ระบุโดยใช้ค่า RGB (จํานวนเต็มระหว่าง 0 ถึง 255)

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

var cell = sheet.getRange("B2");

// Sets the background to white
cell.setBackgroundRGB(255, 255, 255);

// Sets the background to red
cell.setBackgroundRGB(255, 0, 0);

พารามิเตอร์

ชื่อTypeคำอธิบาย
redIntegerค่าสีแดงในรูปแบบ RGB
greenIntegerค่าสีเขียวในรูปแบบ RGB
blueIntegerค่าสีน้ําเงินในรูปแบบ RGB

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setBackgrounds(color)

ตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าสําหรับสีพื้นหลัง (ต้องตรงกับขนาดของช่วงนี้) สีจะอยู่ในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white')

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

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setBackgrounds(colors);

พารามิเตอร์

ชื่อTypeคำอธิบาย
colorString[][]อาร์เรย์ของสีแบบ 2 มิติในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white') ค่า null จะรีเซ็ตสี

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setBorder(top, left, bottom, right, vertical, horizontal)

ตั้งค่าคุณสมบัติเส้นขอบ ค่าที่ถูกต้องคือ true (เปิด), false (ปิด) และ null (ไม่มีการเปลี่ยนแปลง)

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

var 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);

พารามิเตอร์

ชื่อTypeคำอธิบาย
topBooleantrue สําหรับเส้นขอบ false ไม่มีเลย null ไม่มีการเปลี่ยนแปลง
leftBooleantrue สําหรับเส้นขอบ false ไม่มีเลย null ไม่มีการเปลี่ยนแปลง
bottomBooleantrue สําหรับเส้นขอบ false ไม่มีเลย null ไม่มีการเปลี่ยนแปลง
rightBooleantrue สําหรับเส้นขอบ false ไม่มีเลย null ไม่มีการเปลี่ยนแปลง
verticalBooleantrue สําหรับขอบเขตประเภทธุรกิจภายใน false สําหรับค่า null สําหรับไม่มีการเปลี่ยนแปลง
horizontalBooleantrue สําหรับเส้นขอบแนวนอนภายใน ไม่มี false สําหรับ null ไม่มีการเปลี่ยนแปลง

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setBorder(top, left, bottom, right, vertical, horizontal, color, style)

ตั้งค่าคุณสมบัติเส้นขอบด้วยสีและ/หรือรูปแบบ ค่าที่ถูกต้องคือ true (เปิด), false (ปิด) และ null (ไม่มีการเปลี่ยนแปลง) สําหรับสี ให้ใช้ "สี" ในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white')

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

var 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);

พารามิเตอร์

ชื่อTypeคำอธิบาย
topBooleantrue สําหรับเส้นขอบ false ไม่มีเลย null ไม่มีการเปลี่ยนแปลง
leftBooleantrue สําหรับเส้นขอบ false ไม่มีเลย null ไม่มีการเปลี่ยนแปลง
bottomBooleantrue สําหรับเส้นขอบ false ไม่มีเลย null ไม่มีการเปลี่ยนแปลง
rightBooleantrue สําหรับเส้นขอบ false ไม่มีเลย null ไม่มีการเปลี่ยนแปลง
verticalBooleantrue สําหรับขอบเขตประเภทธุรกิจภายใน false สําหรับค่า null สําหรับไม่มีการเปลี่ยนแปลง
horizontalBooleantrue สําหรับเส้นขอบแนวนอนภายใน ไม่มี false สําหรับ null ไม่มีการเปลี่ยนแปลง
colorStringสีในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white') null สําหรับสีเริ่มต้น (สีดํา)
styleBorderStyleรูปแบบสําหรับเส้นขอบ, null สําหรับรูปแบบเริ่มต้น (ทึบ)

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setDataValidation(rule)

ตั้งกฎการตรวจสอบข้อมูล 1 กฎสําหรับเซลล์ทั้งหมดในช่วง

// Set the data validation rule for cell A1 to require a value from B1:B10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อTypeคำอธิบาย
ruleDataValidationกฎการตรวจสอบข้อมูลที่จะกําหนดค่า หรือ null เพื่อนําการตรวจสอบข้อมูลออก

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setDataValidations(rules)

ตั้งกฎการตรวจสอบข้อมูลของเซลล์ทั้งหมดในช่วง วิธีนี้ใช้การตรวจสอบข้อมูลอาร์เรย์ 2 มิติโดยจัดทําดัชนีตามแถวและตามด้วยคอลัมน์ ขนาดอาร์เรย์ต้องสอดคล้องกับ มิติข้อมูลช่วง

// Set the data validation rules for Sheet1!A1:B5 to require a value from Sheet2!A1:A10.
var destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
var sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
var rules = destinationRange.getDataValidations();
for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    rules[i][j] = rule;
  }
}
destinationRange.setDataValidations(rules);

พารามิเตอร์

ชื่อTypeคำอธิบาย
rulesDataValidation[][]อาร์เรย์ 2 มิติของกฎการตรวจสอบข้อมูลที่จะตั้งค่า ค่า null จะนําการตรวจสอบข้อมูลออก

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFontColor(color)

ตั้งค่าสีแบบอักษรในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white')

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

var cell = sheet.getRange("B2");
cell.setFontColor("red");

พารามิเตอร์

ชื่อTypeคำอธิบาย
colorStringสีแบบอักษรในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white') ค่า null จะรีเซ็ตสี

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFontColorObject(color)

ตั้งค่าสีแบบอักษรของช่วงที่ระบุ

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();

var cell = sheet.getRange("B2");
cell.setFontColor(color);

พารามิเตอร์

ชื่อTypeคำอธิบาย
colorColorสีแบบอักษรที่ตั้งค่า ค่า null จะรีเซ็ตสี

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFontColorObjects(colors)

ตั้งค่าตารางสีสี่เหลี่ยมผืนผ้าแบบสี่เหลี่ยม (ต้องตรงกับขนาดของช่วงนี้)

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

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setFontColorObjects(colors);

พารามิเตอร์

ชื่อTypeคำอธิบาย
colorsColor[][]อาร์เรย์ของสี 2 มิติ ค่า null รีเซ็ตสีแบบอักษร

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFontColors(colors)

ตั้งค่าตารางสีสี่เหลี่ยมผืนผ้าแบบสี่เหลี่ยม (ต้องตรงกับขนาดของช่วงนี้) สีจะอยู่ในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white')

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

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setFontColors(colors);

พารามิเตอร์

ชื่อTypeคำอธิบาย
colorsObject[][]อาร์เรย์ของสีแบบ 2 มิติในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white') ค่า null จะรีเซ็ตสี

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFontFamilies(fontFamilies)

ตั้งค่าตารางกริดรูปสี่เหลี่ยมผืนผ้าของชุดแบบอักษร (ต้องตรงกับขนาดในช่วงนี้) ตัวอย่างของชุดแบบอักษรได้แก่ "Arial" หรือ "Helvetica"

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

var fonts = [
  ["Arial", "Helvetica", "Verdana"],
  ["Courier New", "Arial", "Helvetica]
];

var cell = sheet.getRange("B2:D3");
cell.setFontFamilies(fonts);

พารามิเตอร์

ชื่อTypeคำอธิบาย
fontFamiliesObject[][]อาร์เรย์แบบ 2 มิติของชุดแบบอักษร ค่า null จะรีเซ็ตชุดแบบอักษร

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFontFamily(fontFamily)

ตั้งค่าแบบอักษร เช่น "Arial" หรือ "Helvetica"

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

var cell = sheet.getRange("B2");
cell.setFontFamily("Helvetica");

พารามิเตอร์

ชื่อTypeคำอธิบาย
fontFamilyStringชุดแบบอักษรที่จะตั้งค่า ค่า null จะรีเซ็ตชุดแบบอักษร

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFontLine(fontLine)

กําหนดรูปแบบแบบอักษรของช่วงที่ระบุ ('underline', 'line-through' หรือ 'none')

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

var cell = sheet.getRange("B2");
cell.setFontLine("line-through");

พารามิเตอร์

ชื่อTypeคำอธิบาย
fontLineStringรูปแบบของแบบอักษรคือ 'underline', 'line-through' หรือ 'none' ค่า null จะรีเซ็ตรูปแบบบรรทัดแบบอักษร

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFontLines(fontLines)

ตั้งค่าตารางแบบสี่เหลี่ยมผืนผ้าของรูปแบบเส้น (ต้องตรงกับขนาดในช่วงนี้)

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

// The size of the two-dimensional array must match the size of the range.
var fontLines = [
  ["underline", "line-through", "none"]
];

var range = sheet.getRange("B2:D2");
range.setFontLines(fontLines);

พารามิเตอร์

ชื่อTypeคำอธิบาย
fontLinesObject[][]อาร์เรย์แบบ 2 มิติของรูปแบบเส้นแบบอักษร ('underline', 'line-through' หรือ 'none') ค่า null จะรีเซ็ตรูปแบบเส้นแบบอักษร

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFontSize(size)

ตั้งค่าขนาดแบบอักษร โดยขนาดคือขนาดของจุดที่จะใช้

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

var cell = sheet.getRange("B2");
cell.setFontSize(20);

พารามิเตอร์

ชื่อTypeคำอธิบาย
sizeIntegerขนาดแบบอักษรในจุด

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFontSizes(sizes)

ตั้งค่าตารางกริดของรูปสี่เหลี่ยมผืนผ้าขนาดตัวอักษร (ต้องตรงกับขนาดของช่วงนี้) ขนาดแสดงเป็นจุด

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

// The size of the two-dimensional array must match the size of the range.
var fontSizes = [
  [16, 20, 24]
];

var range = sheet.getRange("B2:D2");
range.setFontSizes(fontSizes);

พารามิเตอร์

ชื่อTypeคำอธิบาย
sizesObject[][]อาร์เรย์ของขนาด 2 มิติ

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFontStyle(fontStyle)

กําหนดรูปแบบแบบอักษรให้กับช่วงที่ระบุ ('italic' หรือ 'normal')

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

var cell = sheet.getRange("B2");
cell.setFontStyle("italic");

พารามิเตอร์

ชื่อTypeคำอธิบาย
fontStyleStringรูปแบบอักษร 'italic' หรือ 'normal' ค่า null จะรีเซ็ตรูปแบบตัวอักษร

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFontStyles(fontStyles)

ตั้งค่าตารางแบบสี่เหลี่ยมผืนผ้าของรูปแบบตัวอักษร (ต้องตรงกับขนาดในช่วงนี้)

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

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  ["italic", "normal"]
];

var range = sheet.getRange("B2:C2");
range.setFontStyles(fontStyles);

พารามิเตอร์

ชื่อTypeคำอธิบาย
fontStylesObject[][]อาร์เรย์แบบ 2 มิติของรูปแบบตัวอักษร 'italic' หรือ 'normal' ค่า null จะรีเซ็ตรูปแบบตัวอักษร

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFontWeight(fontWeight)

ตั้งค่าน้ําหนักแบบอักษรสําหรับช่วงที่ระบุ (ปกติ/ตัวหนา)

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

var cell = sheet.getRange("B2");
cell.setFontWeight("bold");

พารามิเตอร์

ชื่อTypeคำอธิบาย
fontWeightStringน้ําหนักแบบอักษรของ 'bold' หรือ 'normal' ค่า null จะรีเซ็ตน้ําหนักของแบบอักษร

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFontWeights(fontWeights)

ตั้งค่าตารางสี่เหลี่ยมของน้ําหนักแบบอักษร (ต้องตรงกับขนาดในช่วงนี้) ตัวอย่างของน้ําหนักแบบอักษร คือ "ตัวหนา"

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

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  [ "bold", "bold", "normal" ]
];

var range = sheet.getRange("B2:D2");
range.setFontWeights(fontStyles);

พารามิเตอร์

ชื่อTypeคำอธิบาย
fontWeightsObject[][]อาร์เรย์ 2 มิติของน้ําหนักแบบอักษร ไม่ว่าจะเป็นค่า 'bold' หรือ 'normal' แต่ค่า null จะรีเซ็ตน้ําหนักของแบบอักษร

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFormula(formula)

อัปเดตสูตรของช่วงนี้ สูตรที่ระบุต้องอยู่ในรูปแบบ A1

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

var cell = sheet.getRange("B5");
cell.setFormula("=SUM(B3:B4)");

พารามิเตอร์

ชื่อTypeคำอธิบาย
formulaStringสตริงที่แสดงสูตรที่จะต้องตั้งค่าสําหรับเซลล์

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFormulaR1C1(formula)

อัปเดตสูตรของช่วงนี้ สูตรที่ระบุต้องอยู่ในรูปแบบ R1C1

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

var 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])");

พารามิเตอร์

ชื่อTypeคำอธิบาย
formulaStringสูตรสตริง

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFormulas(formulas)

ตั้งค่าตารางสี่เหลี่ยมผืนผ้าของสูตร (ต้องตรงกับขนาดของช่วงนี้) สูตรที่ระบุต้องอยู่ในเครื่องหมาย A1 เมธอดนี้ใช้อาร์เรย์ของสูตรสองมิติที่จัดทําดัชนีตามแถว ตามด้วยคอลัมน์ มิติข้อมูลอาร์เรย์ต้องสอดคล้องกับมิติข้อมูลของช่วง

var ss = SpreadsheetApp.getActiveSpreadsheet();
var 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.
var formulas = [
  ["=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"],
  ["=AVERAGE(B2:B4)", "=AVERAGE(C2:C4)", "=AVERAGE(D2:D4)"]
];

var cell = sheet.getRange("B5:D6");
cell.setFormulas(formulas);

พารามิเตอร์

ชื่อTypeคำอธิบาย
formulasString[][]อาร์เรย์สตริงแบบ 2 มิติของสูตร

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFormulasR1C1(formulas)

ตั้งค่าตารางสี่เหลี่ยมผืนผ้าของสูตร (ต้องตรงกับขนาดของช่วงนี้) สูตรที่ระบุต้องอยู่ในเครื่องหมาย R1C1

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

// This creates formulas for a row of sums, followed by a row of averages.
var sumOfRowsAbove = "=SUM(R[-3]C[0]:R[-1]C[0])";
var averageOfRowsAbove = "=AVERAGE(R[-4]C[0]:R[-2]C[0])";

// The size of the two-dimensional array must match the size of the range.
var formulas = [
  [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove],
  [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove]
];

var cell = sheet.getRange("B5:D6");
// This sets the formula to be the sum of the 3 rows above B5.
cell.setFormulasR1C1(formulas);

พารามิเตอร์

ชื่อTypeคำอธิบาย
formulasString[][]อาร์เรย์ 2 มิติของสูตรในรูปแบบ R1C1

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setHorizontalAlignment(alignment)

ตั้งค่าการจัดข้อความแนวนอน (ซ้ายไปขวา) ของช่วงที่ระบุ (ซ้าย/ตรงกลาง/ขวา)

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

var cell = sheet.getRange("B2");
cell.setHorizontalAlignment("center");

พารามิเตอร์

ชื่อTypeคำอธิบาย
alignmentStringการปรับแนวอาจเป็น 'left', 'center' หรือ 'normal' ส่วนค่า null จะรีเซ็ตการปรับแนว

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setHorizontalAlignments(alignments)

ตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าสําหรับการวางแนวแนวนอน ดู setHorizontalAlignment(alignment)

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

// The size of the two-dimensional array must match the size of the range.
var horizontalAlignments = [
  [ "left", "right", "center" ]
];

var range = sheet.getRange("B2:D2");
range.setHorizontalAlignments(horizontalAlignments);

พารามิเตอร์

ชื่อTypeคำอธิบาย
alignmentsObject[][]อาร์เรย์การปรับแนวแบบ 2 มิติ ได้แก่ 'left', 'center' หรือ 'normal' ค่า null จะรีเซ็ตการปรับแนว

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม


setNote(note)

ตั้งค่าโน้ตให้กับค่าที่ระบุ

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

var cell = sheet.getRange("B2");
cell.setNote("This is a note");

พารามิเตอร์

ชื่อTypeคำอธิบาย
noteStringค่าหมายเหตุที่จะตั้งสําหรับช่วง ค่า null นําโน้ตออก

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setNotes(notes)

ตั้งค่าตารางโน้ตสี่เหลี่ยม (ต้องตรงกับขนาดของช่วงนี้)

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

// The size of the two-dimensional array must match the size of the range.
var notes = [
  ["it goes", "like this", "the fourth, the fifth"],
  ["the minor fall", "and the", "major lift"]
];

var cell = sheet.getRange("B2:D3");
cell.setNotes(notes)

พารามิเตอร์

ชื่อTypeคำอธิบาย
notesObject[][]อาร์เรย์ของโน้ต 2 มิติ ค่า null จะนําโน้ตออก

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม


setNumberFormat(numberFormat)

ตั้งค่ารูปแบบตัวเลขหรือวันที่เป็นสตริงการจัดรูปแบบที่ระบุ ดูรูปแบบที่ยอมรับได้ในเอกสารประกอบของ Sheets API

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

var cell = sheet.getRange("B2");
// Always show 3 decimal points
cell.setNumberFormat("0.000");

พารามิเตอร์

ชื่อTypeคำอธิบาย
numberFormatStringสตริงรูปแบบตัวเลข

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setNumberFormats(numberFormats)

ตั้งค่าตารางแบบสี่เหลี่ยมผืนผ้าของรูปแบบตัวเลขหรือวันที่ (ต้องตรงกับมิติข้อมูลของช่วงนี้) ค่าคือสตริงรูปแบบซึ่งอธิบายไว้ใน เอกสารประกอบของ Sheets API

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

// The size of the two-dimensional array must match the size of the range.
var formats = [
  [ "0.000", "0,000,000", "$0.00" ]
];

var range = sheet.getRange("B2:D2");
range.setNumberFormats(formats);

พารามิเตอร์

ชื่อTypeคำอธิบาย
numberFormatsObject[][]อาร์เรย์แบบ 2 มิติของรูปแบบตัวเลข

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setRichTextValue(value)

ตั้งค่า Rich Text สําหรับเซลล์ในช่วงนั้น

// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello" bolded.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var richText = SpreadsheetApp.newRichTextValue()
    .setText("Hello world")
    .setTextStyle(0, 5, bold)
    .build();
range.setRichTextValue(richText);

พารามิเตอร์

ชื่อTypeคำอธิบาย
valueRichTextValueค่า Rich Text ที่ต้องการ

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setRichTextValues(values)

ตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าสําหรับค่า Rich Text

// Sets the cells in range A1:A2 to have Rich Text values.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:A2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var italic = SpreadsheetApp.newTextStyle()
    .setItalic(true)
    .build();
var richTextA1 = SpreadsheetApp.newRichTextValue()
    .setText("This cell is bold")
    .setTextStyle(bold)
    .build();
var richTextA2 = SpreadsheetApp.newRichTextValue()
    .setText("bold words, italic words")
    .setTextStyle(0, 11, bold)
    .setTextStyle(12, 24, italic)
    .build();
range.setRichTextValues([[richTextA1], [richTextA2]]);

พารามิเตอร์

ชื่อTypeคำอธิบาย
valuesRichTextValue[][]ค่า Rich Text ที่ต้องการ

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ตั้งค่าว่าช่วงนี้ควรแสดงไฮเปอร์ลิงก์หรือไม่

พารามิเตอร์

ชื่อTypeคำอธิบาย
showHyperlinkBooleanแสดงไฮเปอร์ลิงก์หรือไม่

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setTextDirection(direction)

ตั้งค่าทิศทางข้อความสําหรับเซลล์ในช่วง หากเส้นทางที่ระบุคือ null เส้นทางจะมีการสรุปแล้วจึงกําหนด

// Sets right-to-left text direction for the range.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

พารามิเตอร์

ชื่อTypeคำอธิบาย
directionTextDirectionทิศทางข้อความที่ต้องการ หาก null อนุมานเส้นทางก่อนการตั้งค่า

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setTextDirections(directions)

ตั้งค่าตารางสี่เหลี่ยมของเส้นทางข้อความ หากทิศทางที่ระบุคือ null ระบบจะอนุมาน ทิศทาง จากนั้นตั้งค่า

// Copies all of the text directions from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextDirections());

พารามิเตอร์

ชื่อTypeคำอธิบาย
directionsTextDirection[][]เส้นทางข้อความที่ต้องการ หากเส้นทางที่ระบุคือ null ระบบจะอนุมานก่อนที่จะตั้งค่า

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setTextRotation(degrees)

กําหนดการตั้งค่าการหมุนข้อความสําหรับเซลล์ในช่วงนั้น อินพุตจะสอดคล้องกับมุมระหว่างการวางแนวข้อความมาตรฐานกับการวางแนวที่ต้องการ อินพุตของ 0 บ่งบอกว่า ข้อความได้รับการตั้งค่าให้วางอยู่ในแนวมาตรฐาน

สําหรับทิศทางข้อความจากซ้ายไปขวา มุมบวกจะอยู่ในทิศทางทวนเข็มนาฬิกา ส่วนมุมขวาไปซ้ายจะอยู่ในทิศทางตามเข็มนาฬิกา

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setTextRotation(45);

พารามิเตอร์

ชื่อTypeคำอธิบาย
degreesIntegerมุมที่ต้องการระหว่างการวางแนวมาตรฐานและการวางแนวที่ต้องการ สําหรับข้อความซ้ายไปขวา มุมบวกจะอยู่ในทิศทางทวนเข็มนาฬิกา

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setTextRotation(rotation)

กําหนดการตั้งค่าการหมุนข้อความสําหรับเซลล์ในช่วงนั้น

// Sets all cell's in range B2:D4 to have the same text rotation settings as cell A1.
var sheet = SpreadsheetApp.getActiveSheet();

var rotation = sheet.getRange("A1").getTextRotation();

sheet.getRange("B2:D4").setTextRotation(rotation);

พารามิเตอร์

ชื่อTypeคำอธิบาย
rotationTextRotationการตั้งค่าการหมุนข้อความที่ต้องการ

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setTextRotations(rotations)

ตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าสําหรับการหมุนข้อความ

// Copies all of the text rotations from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextRotations());

พารามิเตอร์

ชื่อTypeคำอธิบาย
rotationsTextRotation[][]การตั้งค่าการหมุนข้อความที่ต้องการ

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setTextStyle(style)

กําหนดรูปแบบข้อความให้กับเซลล์ในช่วงข้อความ

// Sets the cells in range C5:D6 to have underlined size 15 font.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("C5:D6");
var style = SpreadsheetApp.newTextStyle()
    .setFontSize(15)
    .setUnderline(true)
    .build();
range.setTextStyle(style);

พารามิเตอร์

ชื่อTypeคำอธิบาย
styleTextStyleรูปแบบข้อความที่ต้องการ

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setTextStyles(styles)

ตั้งค่าตารางแบบสี่เหลี่ยมผืนผ้าของรูปแบบข้อความ

// Sets text styles for cells in range A1:B2
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var otherStyle = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .setUnderline(true)
    .setItalic(true)
    .setForegroundColor("#335522")
    .setFontSize(44)
    .build();
range.setTextStyles([[bold, otherStyle], [otherStyle, bold]]);

พารามิเตอร์

ชื่อTypeคำอธิบาย
stylesTextStyle[][]รูปแบบข้อความที่ต้องการ

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setValue(value)

ตั้งค่าของช่วง ค่าสามารถเป็นตัวเลข สตริง บูลีน หรือวันที่ หากบรรทัดนั้นขึ้นต้นด้วย '=' ระบบจะตีความว่าเป็นสูตร

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

var cell = sheet.getRange("B2");
cell.setValue(100);

พารามิเตอร์

ชื่อTypeคำอธิบาย
valueObjectค่าของช่วง

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setValues(values)

ตั้งค่าตารางค่าสี่เหลี่ยมผืนผ้า (ต้องตรงกับมิติข้อมูลของช่วงนี้)

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

// The size of the two-dimensional array must match the size of the range.
var values = [
  [ "2.000", "1,000,000", "$2.99" ]
];

var range = sheet.getRange("B2:D2");
range.setValues(values);

พารามิเตอร์

ชื่อTypeคำอธิบาย
valuesObject[][]อาร์เรย์ของมิติข้อมูล 2 มิติ

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setVerticalAlignment(alignment)

ตั้งค่าจัดข้อความแนวตั้ง (บน/ล่าง) ของช่วงที่ระบุ (ด้านบน/ตรงกลาง/ด้านล่าง)

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

var cell = sheet.getRange("B2");
cell.setVerticalAlignment("middle");

พารามิเตอร์

ชื่อTypeคำอธิบาย
alignmentStringการปรับแนวอาจเป็น 'top', 'middle' หรือ 'bottom' ส่วนค่า null จะรีเซ็ตการปรับแนว

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setVerticalAlignments(alignments)

ตั้งค่าตารางกริดแบบสี่เหลี่ยมผืนผ้าสําหรับการจัดข้อความแนวตั้ง (ต้องตรงกับมิติข้อมูลของช่วงนี้)

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

// The size of the two-dimensional array must match the size of the range.
var alignments = [
  [ "top", "middle", "bottom" ]
];

var range = sheet.getRange("B2:D2");
range.setVerticalAlignments(alignments);

พารามิเตอร์

ชื่อTypeคำอธิบาย
alignmentsObject[][]อาร์เรย์การปรับแนว 2 มิติ ได้แก่ 'top', 'middle' หรือ 'bottom' ค่า null จะรีเซ็ตการปรับแนว

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม


setVerticalText(isVertical)

ตั้งค่าว่าจะซ้อนข้อความของเซลล์ในช่วงหรือไม่ ถ้าข้อความเรียงซ้อนกัน การตั้งค่าการหมุนข้อความองศาจะถูกละเว้น

// Sets all cell's in range B2:D4 to have vertically stacked text.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setVerticalText(true);

พารามิเตอร์

ชื่อTypeคำอธิบาย
isVerticalBooleanจะซ้อนข้อความหรือไม่

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setWrap(isWrapEnabled)

ตั้งค่าการตัดเซลล์ของช่วงที่ระบุ

ปรับขนาดเซลล์ที่เปิดใช้การรวม (ค่าเริ่มต้น) เพื่อแสดงเนื้อหาทั้งหมด เซลล์ที่มีการปิด Wrapper ไว้ให้มากที่สุดในเซลล์โดยไม่มีการปรับขนาดหรือเรียกใช้ไปยังบรรทัดหลายบรรทัด

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

var cell = sheet.getRange("B2");
cell.setWrap(true);

พารามิเตอร์

ชื่อTypeคำอธิบาย
isWrapEnabledBooleanรวมข้อความหรือไม่รวมข้อความ

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setWrapStrategies(strategies)

ตั้งค่าตารางกริดของกลยุทธ์การรวม

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setWrapStrategies(range1.getWrapStrategies());

พารามิเตอร์

ชื่อTypeคำอธิบาย
strategiesWrapStrategy[][]กลยุทธ์การรวมที่ต้องการ

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setWrapStrategy(strategy)

ตั้งค่ากลยุทธ์การตัดข้อความสําหรับเซลล์ในช่วง

// Sets all cells in range B2:D4 to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

พารามิเตอร์

ชื่อTypeคำอธิบาย
strategyWrapStrategyกลยุทธ์การรวมที่ต้องการ

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setWraps(isWrapEnabled)

ตั้งค่านโยบายการตัดคําแบบตารางสี่เหลี่ยม (ต้องตรงกับมิติข้อมูลของช่วงนี้) เซลล์ที่เปิดใช้ การตัดรอบ (ค่าเริ่มต้น) เพื่อแสดงเนื้อหาทั้งหมด เซลล์ที่ปิดการรวมไว้จะแสดงในเซลล์มากที่สุดเท่าที่จะทําได้โดยไม่มีการปรับขนาดหรือขยายไปยังหลายบรรทัด

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

// The size of the two-dimensional array must match the size of the range.
var wraps = [
  [ true, true, false ]
];

var range = sheet.getRange("B2:D2");
range.setWraps(wraps);

พารามิเตอร์

ชื่อTypeคำอธิบาย
isWrapEnabledObject[][]อาร์เรย์ 2 มิติของตัวแปรการรวมที่ใช้พิจารณาว่าจะใส่ข้อความในเซลล์หรือไม่

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม


shiftColumnGroupDepth(delta)

เปลี่ยนความลึกในการจัดกลุ่มคอลัมน์ของช่วงตามจํานวนที่ระบุ

ซึ่งจะส่งผลกระทบกับการสร้าง แก้ไข หรือลบกลุ่มที่ตัดกับช่วงนี้ สําหรับเดลต้าเชิงบวก ระบบจะสร้างกลุ่มและ/หรือแก้ไขกลุ่มเดลต้า ระบบจะทําลายและ/หรือแก้ไขกลุ่มเดลต้า

การดําเนินการนี้จะไม่มีผลเมื่อลดความลึกของกลุ่มลงต่ํากว่า 0 หรือมากกว่า 8

หาก column group control position คือ BEFORE จะทําให้เกิดข้อผิดพลาดขณะพยายามเปลี่ยนความลึกของแถวแรก

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var 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);

พารามิเตอร์

ชื่อTypeคำอธิบาย
deltaIntegerจํานวนเพื่อเปลี่ยนความลึกของกลุ่มคอลัมน์ของช่วงนี้

ขากลับ

Range — ช่วงนี้สําหรับเชน

ผ้าคลุม

Error — เมื่อพยายามเปลี่ยนความลึกของคอลัมน์แรกเมื่อตําแหน่งการควบคุมคือ GroupControlTogglePosition.BEFORE

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

shiftRowGroupDepth(delta)

เปลี่ยนความลึกในการจัดกลุ่มแถวของช่วงตามจํานวนที่ระบุ

ซึ่งจะส่งผลกระทบกับการสร้าง แก้ไข หรือลบกลุ่มที่ตัดกับช่วงนี้ สําหรับเดลต้าเชิงบวก ระบบจะสร้างกลุ่มและ/หรือแก้ไขกลุ่มเดลต้า ระบบจะทําลายและ/หรือแก้ไขกลุ่มเดลต้า

การดําเนินการนี้จะไม่มีผลเมื่อลดความลึกของกลุ่มลงต่ํากว่า 0 หรือมากกว่า 8

หาก row group control position คือ BEFORE จะทําให้เกิดข้อผิดพลาดเมื่อพยายามปรับความลึกของแถวแรก

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var 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);

พารามิเตอร์

ชื่อTypeคำอธิบาย
deltaIntegerจํานวนเพื่อเปลี่ยนความลึกของกลุ่มแถวของช่วงนี้

ขากลับ

Range — ช่วงนี้สําหรับเชน

ผ้าคลุม

Error — เมื่อพยายามเปลี่ยนความลึกของแถวแรกเมื่อตําแหน่ง การควบคุมคือ GroupControlTogglePosition.BEFORE

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

sort(sortSpecObj)

จัดเรียงเซลล์ในช่วงที่กําหนด ตามคอลัมน์และลําดับที่ระบุ

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var 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}]);

พารามิเตอร์

ชื่อTypeคำอธิบาย
sortSpecObjObjectคอลัมน์ที่จัดเรียงตาม

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

splitTextToColumns()

แบ่งคอลัมน์ข้อความออกเป็นหลายคอลัมน์โดยพิจารณาจากตัวคั่นที่ตรวจพบโดยอัตโนมัติ

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one,one,one      |                 |                 |
// 2 |two,two,two      |                 |                 |
// 3 |three,three,three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns();

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

splitTextToColumns(delimiter)

แบ่งคอลัมน์ข้อความออกเป็นหลายคอลัมน์โดยใช้สตริงที่ระบุเป็นตัวคั่นที่กําหนดเอง

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one#one#one      |                 |                 |
// 2 |two#two#two      |                 |                 |
// 3 |three#three#three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns('#');

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

พารามิเตอร์

ชื่อTypeคำอธิบาย
delimiterStringตัวคั่นที่กําหนดเองที่จะแบ่งด้วย

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

splitTextToColumns(delimiter)

แบ่งคอลัมน์ข้อความออกเป็นหลายคอลัมน์โดยพิจารณาจากตัวคั่นที่กําหนด

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one;one;one      |                 |                 |
// 2 |two;two;two      |                 |                 |
// 3 |three;three;three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

พารามิเตอร์

ชื่อTypeคำอธิบาย
delimiterTextToColumnsDelimiterตัวคั่นที่กําหนดล่วงหน้าสําหรับการแยก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

trimWhitespace()

ตัดการเว้นวรรค (เช่น เว้นวรรค แท็บ หรือบรรทัดใหม่) ในทุกเซลล์ในช่วงนี้ ลบช่องว่างทั้งหมดออกจากจุดเริ่มต้นและจุดสิ้นสุดของข้อความของแต่ละเซลล์ และลดผลลัพธ์ย่อยของอักขระที่เป็นช่องว่างที่เหลือให้เหลือเพียงการเว้นวรรคเดียว

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:A4');
range.activate();
range.setValues(
    [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)'])

range.trimWhitespace();

var values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

uncheck()

เปลี่ยนสถานะของช่องทําเครื่องหมายในช่วงเป็น "ยกเลิกการเลือกแล้ว" ไม่ต้องสนใจเซลล์ในช่วงที่ไม่มีค่าที่เลือกหรือยกเลิกการเลือกอยู่

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

ขากลับ

Range — ช่วงนี้สําหรับเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องใช้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

เมธอดที่เลิกใช้งาน