เข้าถึงและแก้ไขช่วงของสเปรดชีต ช่วงอาจเป็นเซลล์เดียวในชีตหรือกลุ่มเซลล์ที่อยู่ติดกันในชีต
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
activate() | Range | ตั้งค่าช่วงที่ระบุเป็น active range โดยให้เซลล์ด้านซ้ายบนของช่วงเป็น current cell |
activate | Range | ตั้งค่าเซลล์ที่ระบุเป็น current cell |
add | Range | เพิ่มข้อมูลเมตาของนักพัฒนาแอปที่มีคีย์ที่ระบุลงในช่วง |
add | Range | เพิ่มข้อมูลเมตาของนักพัฒนาแอปที่มีคีย์และระดับการแชร์ที่ระบุลงในช่วง |
add | Range | เพิ่มข้อมูลเมตาของนักพัฒนาแอปที่มีคีย์และค่าที่ระบุลงในช่วง |
add | Range | เพิ่มข้อมูลเมตาของนักพัฒนาแอปที่มีคีย์ ค่า และการแชร์ที่กำหนดไว้ลงในช่วง |
apply | Banding | ใช้ธีมการแบ่งกลุ่มคอลัมน์เริ่มต้นกับช่วง |
apply | Banding | ใช้ธีมการแบ่งกลุ่มคอลัมน์ที่ระบุกับช่วง |
apply | Banding | ใช้ธีมการจัดกลุ่มคอลัมน์ที่ระบุกับช่วงที่มีการตั้งค่าส่วนหัวและส่วนท้ายที่ระบุ |
apply | Banding | ใช้ธีมแถวที่มีแถบสีเริ่มต้นกับช่วง |
apply | Banding | ใช้ธีมแถวที่มีแถบสีที่ระบุกับช่วง |
apply | Banding | ใช้ธีมแถวที่มีแถบระบุกับช่วงที่มีการตั้งค่าส่วนหัวและส่วนท้ายที่ระบุ |
auto | void | เติมข้อมูลใน destination โดยอิงตามข้อมูลในช่วงนี้ |
auto | void | คํานวณช่วงที่จะกรอกข้อมูลใหม่ตามเซลล์ใกล้เคียง และเติมค่าใหม่ลงในช่วงที่คำนวณโดยอัตโนมัติตามข้อมูลที่อยู่ในช่วงนี้ |
break | Range | แยกเซลล์หลายคอลัมน์ในช่วงออกเป็นเซลล์เดี่ยวอีกครั้ง |
can | Boolean | กำหนดว่าผู้ใช้มีสิทธิ์แก้ไขทุกเซลล์ในช่วงหรือไม่ |
check() | Range | เปลี่ยนสถานะของช่องทําเครื่องหมายในช่วงเป็น "เลือกแล้ว" |
clear() | Range | ล้างช่วงเนื้อหาและรูปแบบ |
clear(options) | Range | ล้างช่วงของเนื้อหา รูปแบบ กฎการตรวจสอบข้อมูล และ/หรือความคิดเห็นตามที่ระบุไว้ด้วยตัวเลือกขั้นสูงที่ระบุ |
clear | Range | ล้างเนื้อหาของช่วงโดยที่ยังคงการจัดรูปแบบไว้ |
clear | Range | ล้างกฎการตรวจสอบข้อมูลของช่วง |
clear | Range | ล้างการจัดรูปแบบของช่วงนี้ |
clear | Range | ล้างโน้ตในเซลล์ที่ระบุ |
collapse | Range | ยุบกลุ่มทั้งหมดที่อยู่ภายในช่วง |
copy | void | คัดลอกการจัดรูปแบบของช่วงไปยังตำแหน่งที่ระบุ |
copy | void | คัดลอกการจัดรูปแบบของช่วงไปยังตำแหน่งที่ระบุ |
copy | void | คัดลอกข้อมูลจากช่วงเซลล์หนึ่งไปยังอีกช่วงเซลล์หนึ่ง |
copy | void | คัดลอกข้อมูลจากช่วงเซลล์หนึ่งไปยังอีกช่วงเซลล์หนึ่ง |
copy | void | คัดลอกข้อมูลจากช่วงเซลล์หนึ่งไปยังอีกช่วงเซลล์หนึ่ง |
copy | void | คัดลอกเนื้อหาของช่วงไปยังตำแหน่งที่ระบุ |
copy | void | คัดลอกเนื้อหาของช่วงไปยังตำแหน่งที่ระบุ |
create | Data | สร้างตาราง Pivot ของแหล่งข้อมูลว่างจากแหล่งข้อมูลโดยยึดที่เซลล์แรกในช่วงนี้ |
create | Data | สร้างตารางแหล่งข้อมูลว่างเปล่าจากแหล่งข้อมูลโดยยึดที่เซลล์แรกในช่วงนี้ |
create | Developer | แสดงผล DeveloperMetadataFinderApi สำหรับการค้นหาข้อมูลเมตาของนักพัฒนาแอปภายในขอบเขตของช่วงนี้ |
create | Filter | สร้างตัวกรองและนำไปใช้กับช่วงที่ระบุในชีต |
create | Pivot | สร้างตาราง Pivot ว่างจาก source ที่ระบุซึ่งยึดอยู่ที่เซลล์แรกในช่วงนี้ |
create | Text | สร้างเครื่องมือค้นหาข้อความสำหรับช่วง ซึ่งสามารถค้นหาและแทนที่ข้อความในนี้ได้ |
delete | void | ลบช่วงของเซลล์นี้ |
expand | Range | ขยายกลุ่มที่ยุบอยู่ซึ่งมีช่วงหรือปุ่มสลับการควบคุมที่ตัดกับช่วงนี้ |
getA1Notation() | String | แสดงผลคำอธิบายสตริงของช่วงในรูปแบบ A1 |
get | String | ส่งกลับสีพื้นหลังของเซลล์ซ้ายบนสุดในช่วง (เช่น '#ffffff' ) |
get | Color | แสดงผลสีพื้นหลังของเซลล์ซ้ายบนในช่วง |
get | Color[][] | แสดงผลสีพื้นหลังของเซลล์ในช่วง |
get | String[][] | แสดงผลสีพื้นหลังของเซลล์ในช่วง (เช่น '#ffffff' ) |
get | Banding[] | แสดงผลแถบทั้งหมดที่ใช้กับเซลล์ใดก็ได้ในช่วงนี้ |
get | Range | แสดงผลเซลล์ที่ระบุภายในช่วง |
get | Integer | แสดงตำแหน่งคอลัมน์เริ่มต้นของช่วงนี้ |
get | Range | แสดงผลสําเนาของช่วงที่ขยายใน Direction หลัก 4 รายการเพื่อครอบคลุมเซลล์ที่อยู่ติดกันทั้งหมดที่มีข้อมูล |
get | Range | แสดงผลสําเนาของช่วงแบบขยาย Direction.UP และ Direction.DOWN หากมิติข้อมูลที่ระบุคือ Dimension.ROWS หรือ Direction.NEXT และ Direction.PREVIOUS หากมิติข้อมูลคือ Dimension.COLUMNS |
get | Data | แสดงผล Data สำหรับเซลล์แรกในช่วง หรือ null หากเซลล์ไม่มีสูตรแหล่งข้อมูล |
get | Data | แสดงผล Data สำหรับเซลล์ในช่วง |
get | Data | รับตาราง Pivot ของแหล่งข้อมูลทั้งหมดที่ตัดกับช่วง |
get | Data | รับตารางแหล่งข้อมูลทั้งหมดที่ตัดกับช่วง |
get | String | แสดงผล URL ของข้อมูลในช่วงนี้ ซึ่งสามารถใช้สร้างแผนภูมิและการค้นหา |
get | Data | แสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น DataTable |
get | Data | แสดงผลข้อมูลภายในช่วงนี้เป็น DataTable |
get | Data | แสดงผลกฎการตรวจสอบข้อมูลสําหรับเซลล์ซ้ายบนในช่วง |
get | Data | แสดงผลกฎการตรวจสอบข้อมูลสำหรับเซลล์ทั้งหมดในช่วง |
get | Developer | รับข้อมูลเมตาของนักพัฒนาแอปที่เชื่อมโยงกับช่วงนี้ |
get | String | แสดงผลค่าของเซลล์ซ้ายบนสุดในช่วง |
get | String[][] | แสดงผลตารางกริดสี่เหลี่ยมผืนผ้าของค่าสําหรับช่วงนี้ |
get | Filter | แสดงตัวกรองในชีตของช่วงที่เป็นของช่วงนี้ หรือ null หากไม่มีตัวกรองในชีต |
get | Color | แสดงสีแบบอักษรของเซลล์ที่มุมซ้ายบนของช่วง |
get | Color[][] | แสดงผลสีแบบอักษรของเซลล์ในช่วง |
get | String[][] | แสดงผลชุดแบบอักษรของเซลล์ในช่วง |
get | String | แสดงชุดแบบอักษรของเซลล์ที่มุมซ้ายบนของช่วง |
get | String | รับรูปแบบเส้นของเซลล์ที่มุมซ้ายบนของช่วง ('underline' ,
'line-through' หรือ 'none' ) |
get | String[][] | รับรูปแบบเส้นของเซลล์ในช่วง ('underline' , 'line-through' หรือ 'none' ) |
get | Integer | แสดงผลขนาดแบบอักษรเป็นขนาดจุดของเซลล์ที่มุมบนซ้ายของช่วง |
get | Integer[][] | แสดงผลขนาดแบบอักษรของเซลล์ในช่วง |
get | String | แสดงผลรูปแบบแบบอักษร ('italic' หรือ 'normal' ) ของเซลล์ที่มุมซ้ายบนของช่วง |
get | String[][] | แสดงผลสไตล์แบบอักษรของเซลล์ในช่วง |
get | String | ส่งกลับน้ำหนักแบบอักษร (ปกติ/หนา) ของเซลล์ที่มุมซ้ายบนของช่วง |
get | String[][] | แสดงผลน้ำหนักแบบอักษรของเซลล์ในช่วง |
get | String | แสดงผลสูตร (รูปแบบ A1) สำหรับเซลล์ซ้ายบนของช่วง หรือสตริงว่างหากเซลล์ว่างเปล่าหรือไม่มีสูตร |
get | String | แสดงผลสูตร (รูปแบบ R1C1) สําหรับเซลล์ที่ระบุ หรือ null หากไม่มี |
get | String[][] | แสดงผลสูตร (รูปแบบ A1) สำหรับเซลล์ในช่วง |
get | String[][] | แสดงผลสูตร (รูปแบบ R1C1) สำหรับเซลล์ในช่วง |
get | Integer | แสดงผลรหัสตารางกริดของชีตหลักของช่วง |
get | Integer | แสดงผลความสูงของช่วง |
get | String | ส่งกลับการจัดแนวข้อความแนวนอน (ซ้าย/กลาง/ขวา) ของเซลล์ที่มุมซ้ายบนของช่วง |
get | String[][] | แสดงผลการจัดแนวแนวนอนของเซลล์ในช่วง |
get | Integer | แสดงผลตําแหน่งคอลัมน์สิ้นสุด |
get | Integer | แสดงผลตําแหน่งของแถวสุดท้าย |
get | Range[] | แสดงผลอาร์เรย์ของออบเจ็กต์ Range ที่แสดงถึงเซลล์ที่ผสานซึ่งอยู่ภายในช่วงปัจจุบันทั้งหมด หรือมีเซลล์อย่างน้อย 1 เซลล์ในช่วงปัจจุบัน |
get | Range | เริ่มจากเซลล์ในคอลัมน์และแถวแรกของช่วง ให้แสดงผลเซลล์ถัดไปในทิศทางที่ระบุซึ่งเป็นขอบของช่วงเซลล์ที่อยู่ติดกันซึ่งมีข้อมูลอยู่ หรือเซลล์ที่ขอบของสเปรดชีตในทิศทางนั้น |
get | String | แสดงผลหมายเหตุที่เชื่อมโยงกับช่วงที่กำหนด |
get | String[][] | แสดงผลหมายเหตุที่เชื่อมโยงกับเซลล์ในช่วง |
get | Integer | แสดงผลจํานวนคอลัมน์ในช่วงนี้ |
get | Integer | แสดงผลจํานวนแถวในระยะนี้ |
get | String | รับการจัดรูปแบบตัวเลขหรือวันที่ของเซลล์ซ้ายบนของช่วงที่กำหนด |
get | String[][] | แสดงผลรูปแบบตัวเลขหรือวันที่ของเซลล์ในช่วงที่ระบุ |
get | Rich | แสดงผลค่า Rich Text สำหรับเซลล์ซ้ายบนสุดของช่วง หรือ null หากค่าของเซลล์ไม่ใช่ข้อความ |
get | Rich | แสดงผลค่าข้อความที่มีรูปแบบของเซลล์ในช่วง |
get | Integer | แสดงผลตําแหน่งแถวของช่วงนี้ |
get | Integer | แสดงผลตําแหน่งแถวของช่วงนี้ |
get | Sheet | แสดงผลชีตของช่วงที่เลือก |
get | Text | ส่งกลับทิศทางข้อความของเซลล์ซ้ายบนสุดของช่วง |
get | Text | แสดงผลทิศทางของข้อความสำหรับเซลล์ในช่วง |
get | Text | ส่งกลับการตั้งค่าการหมุนข้อความสําหรับเซลล์ซ้ายบนสุดของช่วง |
get | Text | แสดงผลการตั้งค่าการหมุนข้อความสําหรับเซลล์ในช่วง |
get | Text | ส่งกลับรูปแบบข้อความของเซลล์ซ้ายบนสุดของช่วง |
get | Text | แสดงผลสไตล์ข้อความของเซลล์ในช่วง |
get | Object | ส่งคืนค่าของเซลล์ซ้ายบนสุดในช่วง |
get | Object[][] | แสดงผลตารางกริดสี่เหลี่ยมผืนผ้าของค่าสําหรับช่วงนี้ |
get | String | ส่งกลับการจัดแนวแนวตั้ง (บน/กลาง/ล่าง) ของเซลล์ที่มุมซ้ายบนของช่วง |
get | String[][] | แสดงผลการจัดแนวแนวตั้งของเซลล์ในช่วง |
get | Integer | แสดงผลความกว้างของช่วงเป็นคอลัมน์ |
get | Boolean | แสดงผลว่าข้อความในเซลล์มีการตัดขึ้นบรรทัดใหม่หรือไม่ |
get | Wrap | แสดงผลกลยุทธ์การตัดข้อความของเซลล์ในช่วง |
get | Wrap | ส่งกลับกลยุทธ์การตัดข้อความของเซลล์ซ้ายบนสุดของช่วง |
get | Boolean[][] | แสดงผลว่าข้อความในเซลล์มีการตัดหรือไม่ |
insert | Range | แทรกเซลล์ว่างในช่วงนี้ |
insert | Range | แทรกช่องทำเครื่องหมายลงในเซลล์แต่ละเซลล์ในช่วงที่กำหนดค่าด้วย true สำหรับเลือก และ false สำหรับไม่ได้เลือก |
insert | Range | แทรกช่องทำเครื่องหมายลงในเซลล์แต่ละเซลล์ในช่วงที่กำหนดค่าด้วยค่าที่กำหนดเองสำหรับช่องที่เลือก และสตริงว่างสำหรับช่องที่ไม่ได้เลือก |
insert | Range | แทรกช่องทำเครื่องหมายลงในเซลล์แต่ละเซลล์ในช่วงที่กำหนดค่าด้วยค่าที่กำหนดเองสำหรับสถานะที่เลือกและไม่ได้เลือก |
is | Boolean | แสดงค่า true หากช่วงว่างเปล่าทั้งหมด |
is | Boolean | แสดงผลว่าเซลล์ทั้งหมดในช่วงมีสถานะช่องทำเครื่องหมายเป็น "เลือกแล้ว" หรือไม่ |
is | Boolean | กำหนดว่าปลายของช่วงเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่งหรือไม่ |
is | Boolean | กำหนดว่าช่วงสิ้นสุดเชื่อมโยงกับแถวใดแถวหนึ่งหรือไม่ |
is | Boolean | แสดงผล true หากเซลล์ในช่วงปัจจุบันทับซ้อนกับเซลล์ที่ผสาน |
is | Boolean | กำหนดว่าจุดเริ่มต้นของช่วงเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่งหรือไม่ |
is | Boolean | กำหนดว่าจุดเริ่มต้นของช่วงเชื่อมโยงกับแถวใดแถวหนึ่งหรือไม่ |
merge() | Range | ผสานเซลล์ในช่วงที่เลือกเข้าด้วยกันเป็นบล็อกเดียว |
merge | Range | ผสานเซลล์ในช่วงต่างๆ ของคอลัมน์ของช่วง |
merge | Range | ผสานเซลล์ในช่วงเข้าด้วยกัน |
move | void | ตัดและวาง (ทั้งรูปแบบและค่า) จากช่วงนี้ไปยังช่วงเป้าหมาย |
offset(rowOffset, columnOffset) | Range | แสดงผลช่วงใหม่ที่เลื่อนจากช่วงนี้ตามจำนวนแถวและคอลัมน์ที่ระบุ (ซึ่งอาจเป็นค่าลบได้) |
offset(rowOffset, columnOffset, numRows) | Range | แสดงผลช่วงใหม่ที่สัมพันธ์กับช่วงปัจจุบัน ซึ่งจุดด้านซ้ายบนมีการเลื่อนจากช่วงปัจจุบันตามแถวและคอลัมน์ที่ระบุ และมีเซลล์ที่มีความสูงที่ระบุ |
offset(rowOffset, columnOffset, numRows, numColumns) | Range | แสดงผลช่วงใหม่ที่สัมพันธ์กับช่วงปัจจุบัน ซึ่งจุดด้านซ้ายบนของออฟเซ็ตจากช่วงปัจจุบันตามแถวและคอลัมน์ที่ระบุ รวมถึงมีความสูงและความกว้างที่ระบุในเซลล์ |
protect() | Protection | สร้างออบเจ็กต์ที่สามารถป้องกันไม่ให้ผู้ใช้ที่ไม่ได้รับอนุญาตแก้ไขช่วงได้ |
randomize() | Range | สุ่มลําดับแถวในช่วงที่ระบุ |
remove | Range | นำช่องทำเครื่องหมายทั้งหมดออกจากช่วง |
remove | Range | นําแถวภายในช่วงนี้ซึ่งมีค่าที่ซ้ำกับค่าในแถวก่อนหน้าออก |
remove | Range | นําแถวภายในช่วงนี้ที่มีค่าในคอลัมน์ที่ระบุซึ่งซ้ำกันของค่าแถวก่อนหน้าออก |
set | Range | ตั้งค่าสีพื้นหลังของเซลล์ทั้งหมดในช่วงในรูปแบบการเขียน CSS (เช่น '#ffffff'
หรือ 'white' ) |
set | Range | ตั้งค่าสีพื้นหลังของเซลล์ทั้งหมดในช่วง |
set | Range | กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของสีพื้นหลัง (ต้องตรงกับมิติข้อมูลของช่วงนี้) |
set | Range | ตั้งค่าพื้นหลังเป็นสีที่ระบุโดยใช้ค่า RGB (จำนวนเต็มระหว่าง 0 ถึง 255) |
set | Range | กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของสีพื้นหลัง (ต้องตรงกับมิติข้อมูลของช่วงนี้) |
set | Range | ตั้งค่าพร็อพเพอร์ตี้เส้นขอบ |
set | Range | ตั้งค่าพร็อพเพอร์ตี้เส้นขอบด้วยสีและ/หรือสไตล์ |
set | Range | ตั้งค่ากฎการตรวจสอบข้อมูล 1 รายการสำหรับเซลล์ทั้งหมดในช่วง |
set | Range | ตั้งค่ากฎการตรวจสอบข้อมูลสำหรับเซลล์ทั้งหมดในช่วง |
set | Range | กำหนดสีแบบอักษรในเครื่องหมายนิพจน์ CSS (เช่น '#ffffff' หรือ 'white' ) |
set | Range | กำหนดสีแบบอักษรของช่วงที่กำหนด |
set | Range | ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของสีแบบอักษร (ต้องตรงกับมิติข้อมูลของช่วงนี้) |
set | Range | ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของสีแบบอักษร (ต้องตรงกับมิติข้อมูลของช่วงนี้) |
set | Range | ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของชุดแบบอักษร (ต้องตรงกับขนาดของช่วงนี้) |
set | Range | ตั้งค่าชุดแบบอักษร เช่น "Arial" หรือ "Helvetica" |
set | Range | ตั้งค่ารูปแบบเส้นของแบบอักษรของช่วงที่กำหนด ('underline' , 'line-through' หรือ
'none' ) |
set | Range | กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของรูปแบบเส้น (ต้องตรงกับมิติข้อมูลของช่วงนี้) |
set | Range | กำหนดขนาดแบบอักษร โดยขนาดจะเป็นขนาดจุดที่จะใช้ |
set | Range | กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของขนาดแบบอักษร (ต้องตรงกับมิติข้อมูลของช่วงนี้) |
set | Range | กำหนดรูปแบบแบบอักษรสำหรับช่วงที่กำหนด ('italic' หรือ 'normal' ) |
set | Range | กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของรูปแบบแบบอักษร (ต้องตรงกับขนาดของช่วงนี้) |
set | Range | กำหนดน้ำหนักแบบอักษรสำหรับช่วงที่กำหนด (ปกติ/หนา) |
set | Range | กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของน้ำหนักแบบอักษร (ต้องตรงกับขนาดของช่วงนี้) |
set | Range | อัปเดตสูตรสําหรับช่วงนี้ |
set | Range | อัปเดตสูตรสําหรับช่วงนี้ |
set | Range | ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของสูตร (ต้องตรงกับมิติข้อมูลของช่วงนี้) |
set | Range | ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของสูตร (ต้องตรงกับมิติข้อมูลของช่วงนี้) |
set | Range | ตั้งค่าการจัดแนวนอน (ซ้ายไปขวา) สำหรับช่วงที่กำหนด (ซ้าย/กลาง/ขวา) |
set | Range | ตั้งค่าตารางสี่เหลี่ยมผืนผ้าของการจัดแนวแนวนอน |
set | Range | ตั้งค่าหมายเหตุเป็นค่าที่ระบุ |
set | Range | ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของโน้ต (ต้องตรงกับขนาดของช่วงนี้) |
set | Range | กำหนดรูปแบบตัวเลขหรือวันที่เป็นสตริงการจัดรูปแบบที่ระบุ |
set | Range | กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของรูปแบบตัวเลขหรือวันที่ (ต้องตรงกับมิติข้อมูลของช่วงนี้) |
set | Range | กำหนดค่าข้อความที่มีรูปแบบสำหรับเซลล์ในช่วง |
set | Range | กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของค่าข้อความที่มีรูปแบบ |
set | Range | ตั้งค่าว่าช่วงควรแสดงไฮเปอร์ลิงก์หรือไม่ |
set | Range | ตั้งค่าทิศทางข้อความสำหรับเซลล์ในช่วง |
set | Range | ตั้งค่าตารางสี่เหลี่ยมผืนผ้าของทิศทางข้อความ |
set | Range | ตั้งค่าการหมุนข้อความสำหรับเซลล์ในช่วง |
set | Range | ตั้งค่าการหมุนข้อความสำหรับเซลล์ในช่วง |
set | Range | ตั้งค่าตารางสี่เหลี่ยมผืนผ้าของการหมุนข้อความ |
set | Range | กำหนดรูปแบบข้อความสำหรับเซลล์ในช่วงที่เลือก |
set | Range | ตั้งค่าตารางสี่เหลี่ยมผืนผ้าของรูปแบบข้อความ |
set | Range | ตั้งค่าของช่วง |
set | Range | ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของค่า (ต้องตรงกับมิติข้อมูลของช่วงนี้) |
set | Range | ตั้งค่าการจัดแนวแนวตั้ง (จากบนลงล่าง) สำหรับช่วงที่กำหนด (บน/กลาง/ล่าง) |
set | Range | กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของการจัดแนวแนวตั้ง (ต้องตรงกับขนาดของช่วงนี้) |
set | Range | ตั้งค่าว่าจะซ้อนข้อความของเซลล์ในช่วงที่เลือกหรือไม่ |
set | Range | กำหนดการตัดเซลล์ของช่วงที่ระบุ |
set | Range | ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของกลยุทธ์การตัด |
set | Range | ตั้งค่ากลยุทธ์การตัดข้อความของเซลล์ในช่วงที่เลือก |
set | Range | กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของนโยบายการขึ้นบรรทัดใหม่ (ต้องตรงกับขนาดของช่วงนี้) |
shift | Range | เปลี่ยนความลึกของการจัดกลุ่มคอลัมน์ของช่วงตามจำนวนที่ระบุ |
shift | Range | เปลี่ยนความลึกของการจัดกลุ่มแถวของช่วงตามจำนวนที่ระบุ |
sort(sortSpecObj) | Range | จัดเรียงเซลล์ในช่วงที่ระบุตามคอลัมน์และลำดับที่ระบุ |
split | void | แยกคอลัมน์ข้อความออกเป็นหลายคอลัมน์ตามตัวคั่นที่ตรวจพบโดยอัตโนมัติ |
split | void | แยกคอลัมน์ข้อความออกเป็นหลายคอลัมน์โดยใช้สตริงที่ระบุเป็นตัวคั่นที่กำหนดเอง |
split | void | แยกคอลัมน์ข้อความออกเป็นหลายคอลัมน์ตามตัวคั่นที่ระบุ |
trim | Range | ตัดการเว้นวรรค (เช่น เว้นวรรค แท็บ หรือบรรทัดใหม่) ในทุกเซลล์ของช่วงนี้ |
uncheck() | Range | เปลี่ยนสถานะของช่องทําเครื่องหมายในช่วงเป็น "ไม่ได้เลือก" |
เอกสารประกอบโดยละเอียด
activate()
ตั้งค่าช่วงที่ระบุเป็น active range
โดยให้เซลล์ด้านซ้ายบนของช่วงเป็น current cell
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const range = sheet.getRange('A1:D10'); range.activate(); const selection = sheet.getSelection(); // Current cell: A1 const currentCell = selection.getCurrentCell(); // Active Range: A1:D10 const activeRange = selection.getActiveRange();
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
activate As Current Cell()
ตั้งค่าเซลล์ที่ระบุเป็น current cell
หากเซลล์ที่ระบุอยู่ในช่วงที่มีอยู่ ช่วงที่ระบุนั้นจะกลายเป็นช่วงที่ใช้งานอยู่โดยมีเซลล์นั้นเป็นเซลล์ปัจจุบัน
หากเซลล์ที่ระบุไม่อยู่ในช่วงที่มีอยู่ ระบบจะนำการเลือกที่มีอยู่ออกและเซลล์ดังกล่าวจะกลายเป็นเซลล์ปัจจุบันและช่วงที่ใช้งานอยู่
หมายเหตุ: Range
ที่ระบุต้องประกอบด้วย 1 เซลล์ มิฉะนั้นระบบจะแสดงข้อยกเว้น
// Gets the first sheet of the spreadsheet. const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Gets the cell B5 and sets it as the active cell. const range = sheet.getRange('B5'); const currentCell = range.activateAsCurrentCell(); // Logs the activated cell. console.log(currentCell.getA1Notation());
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Developer Metadata(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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
key | String | คีย์สำหรับข้อมูลเมตาของนักพัฒนาแอปใหม่ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Developer Metadata(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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
key | String | คีย์สำหรับข้อมูลเมตาของนักพัฒนาแอปใหม่ |
visibility | Developer | ระดับการแชร์ข้อมูลเมตาของนักพัฒนาแอปใหม่ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Developer Metadata(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 of Sheet1. const range = sheet.getRange('2:2'); // Adds the key 'NAME' and sets the value to 'GOOGLE' for the metadata of row 2. range.addDeveloperMetadata('NAME', 'GOOGLE'); // Gets the metadata and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
key | String | คีย์สำหรับข้อมูลเมตาของนักพัฒนาแอปใหม่ |
value | String | ค่าสำหรับข้อมูลเมตาของนักพัฒนาแอปใหม่ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Developer Metadata(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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
key | String | คีย์สำหรับข้อมูลเมตาของนักพัฒนาแอปใหม่ |
value | String | ค่าสำหรับข้อมูลเมตาของนักพัฒนาแอปใหม่ |
visibility | Developer | ระดับการแชร์ข้อมูลเมตาของนักพัฒนาแอปใหม่ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
apply Column Banding()
ใช้ธีมการแบ่งกลุ่มคอลัมน์เริ่มต้นกับช่วง โดยค่าเริ่มต้น แถบมีสีส่วนหัวและไม่มีสีส่วนท้าย
// 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
apply Column Banding(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(), );
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
banding | Banding | ธีมสีที่จะใช้กับคอลัมน์ในช่วง |
รีเทิร์น
Banding
— การจัดกลุ่มใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
apply Column Banding(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(), );
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
banding | Banding | ธีมสีที่จะใช้กับคอลัมน์ในช่วง |
show | Boolean | หากเป็น true ระบบจะใช้สีส่วนหัวของธีมแถบกับคอลัมน์แรก |
show | Boolean | หากเป็น true ระบบจะใช้สีส่วนท้ายของธีมแถบกับคอลัมน์สุดท้าย |
รีเทิร์น
Banding
— การจัดกลุ่มใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
apply Row Banding()
ใช้ธีมแถวที่มีแถบสีเริ่มต้นกับช่วง โดยค่าเริ่มต้น แถบมีสีส่วนหัวและไม่มีสีส่วนท้าย
// Opens the spreadsheet by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies row banding to rows 1-30. range.applyRowBanding(); // Gets the hex color of the second banded row. const secondRowColor = range.getBandings()[0].getSecondRowColorObject().asRgbColor().asHexString(); // Logs the hex color to console. console.log(secondRowColor);
รีเทิร์น
Banding
— แถบสี
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
apply Row Banding(bandingTheme)
ใช้ธีมแถวที่มีแถบสีที่ระบุกับช่วง โดยค่าเริ่มต้น แถบมีสีส่วนหัวและไม่มีสีส่วนท้าย
// Opens the spreadsheet by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies the INDIGO row banding theme to rows 1-30. range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO); // Gets the hex color of the second banded row. const secondRowColor = range.getBandings()[0].getSecondRowColorObject().asRgbColor().asHexString(); // Logs the hex color to console. console.log(secondRowColor);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
banding | Banding | ธีมสีที่จะใช้กับแถวในช่วงที่เลือก |
รีเทิร์น
Banding
— การจัดกลุ่มใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
apply Row Banding(bandingTheme, showHeader, showFooter)
ใช้ธีมแถวที่มีแถบระบุกับช่วงที่มีการตั้งค่าส่วนหัวและส่วนท้ายที่ระบุ
// Opens the spreadsheet by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies the INDIGO row banding to rows 1-30 and // specifies to hide the header and show the footer. range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO, false, true);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
banding | Banding | ธีมสีที่จะใช้กับแถวในช่วงที่เลือก |
show | Boolean | หากเป็น true ระบบจะใช้สีส่วนหัวของธีมแถบกับแถวแรก |
show | Boolean | หากเป็น true ระบบจะใช้สีส่วนท้ายของธีมแถบกับแถวสุดท้าย |
รีเทิร์น
Banding
— การจัดกลุ่มใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
auto Fill(destination, series)
เติมข้อมูลใน destination
โดยอิงตามข้อมูลในช่วงนี้ ค่าใหม่จะกำหนดโดยประเภท series
ที่ระบุด้วย ช่วงปลายทางต้องมีช่วงนี้และขยายไปในทิศทางเดียวเท่านั้น ตัวอย่างเช่น คำสั่งต่อไปนี้จะเติม A1:A20
ด้วยตัวเลขที่เพิ่มขึ้นตามค่าปัจจุบันใน A1:A4
const sheet = SpreadsheetApp.getActiveSheet(); // Has values [1, 2, 3, 4]. const sourceRange = sheet.getRange('A1:A4'); // The range to fill with values. const destination = sheet.getRange('A1:A20'); // Inserts new values in A5:A20, continuing the pattern expressed in A1:A4 sourceRange.autoFill(destination, SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
destination | Range | ช่วงที่จะป้อนค่าโดยอัตโนมัติ ช่วงปลายทางควรมีช่วงนี้และขยายไปในทิศทางเดียวเท่านั้น (ขึ้น ลง ซ้าย หรือขวา) |
series | Auto | ประเภทชุดค่าผสมอัตโนมัติที่ควรใช้คํานวณค่าใหม่ ผลลัพธ์ของชุดนี้จะแตกต่างกันไปตามประเภทและจํานวนข้อมูลต้นทาง |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
auto Fill To Neighbor(series)
คํานวณช่วงที่จะกรอกข้อมูลใหม่ตามเซลล์ใกล้เคียง และเติมค่าใหม่ลงในช่วงที่คำนวณโดยอัตโนมัติตามข้อมูลที่อยู่ในช่วงนี้ ค่าใหม่เหล่านี้จะขึ้นอยู่กับประเภท series
ที่ระบุด้วย
ช่วงปลายทางที่คำนวณแล้วจะพิจารณาข้อมูลโดยรอบเพื่อกำหนดตําแหน่งที่จะแทรกค่าใหม่ หากมีข้อมูลทางด้านซ้ายหรือขวาของคอลัมน์ที่กรอกอัตโนมัติ ค่าใหม่จะขยายไปถึงข้อมูลที่อยู่ติดกันเท่านั้น
เช่น หาก A1:A20
เต็มไปด้วยชุดตัวเลขที่เพิ่มขึ้นและมีการเรียกใช้เมธอดนี้ในช่วงที่ B1:B4
ซึ่งมีชุดวันที่ ระบบจะแทรกค่าใหม่ลงใน B5:B20
เท่านั้น วิธีนี้จะทำให้ค่าใหม่เหล่านี้ "ติด" อยู่กับเซลล์ที่มีค่าในคอลัมน์ A
const sheet = SpreadsheetApp.getActiveSheet(); // A1:A20 has values [1, 2, 3, ... 20]. // B1:B4 has values [1/1/2017, 1/2/2017, ...] const sourceRange = sheet.getRange('B1:B4'); // Results in B5:B20 having values [1/5/2017, ... 1/20/2017] sourceRange.autoFillToNeighbor(SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
series | Auto | ประเภทชุดค่าผสมอัตโนมัติที่ควรใช้คํานวณค่าใหม่ ผลลัพธ์ของชุดนี้จะแตกต่างกันไปตามประเภทและจํานวนข้อมูลต้นทาง |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
break Apart()
แยกเซลล์หลายคอลัมน์ในช่วงออกเป็นเซลล์เดี่ยวอีกครั้ง
การเรียกใช้ฟังก์ชันนี้กับช่วงจะเหมือนกับการเลือกช่วงแล้วคลิกรูปแบบ > ผสานเซลล์ > เลิกผสาน
// Opens the spreadsheet by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:C6 on Sheet1. const range = sheet.getRange('A1:C6'); // Unmerges the range A1:C6 into individual cells. range.breakApart();
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
can Edit()
กำหนดว่าผู้ใช้มีสิทธิ์แก้ไขทุกเซลล์ในช่วงหรือไม่ เจ้าของสเปรดชีตจะแก้ไขช่วงและชีตที่มีการป้องกันได้เสมอ
// Opens the spreadsheet by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:C6 on Sheet1. const range = sheet.getRange('A1:C6'); // Logs whether the user has permission to edit every cell in the range. console.log(range.canEdit());
รีเทิร์น
Boolean
— true
หากผู้ใช้มีสิทธิ์แก้ไขทุกเซลล์ในช่วงนั้น 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'. const range = SpreadsheetApp.getActive().getRange('A1:B10'); range.check();
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
ล้างช่วงเนื้อหาและรูปแบบ
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const 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:G7 in the active sheet, but preserves the // format, data validation rules, and comments. SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 5).clear({ contentsOnly: true });
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
options | Object | ออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูงตามที่ระบุไว้ด้านล่าง |
พารามิเตอร์ขั้นสูง
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
comments | Boolean | ล้างเฉพาะความคิดเห็นหรือไม่ |
contents | Boolean | ล้างเฉพาะเนื้อหาหรือไม่ |
format | Boolean | ล้างเฉพาะการจัดรูปแบบหรือไม่ โปรดทราบว่าการล้างการจัดรูปแบบจะเป็นการล้างกฎการตรวจสอบข้อมูลด้วย |
validations | Boolean | ล้างเฉพาะกฎการตรวจสอบข้อมูลหรือไม่ |
skip | Boolean | กำหนดว่าจะหลีกเลี่ยงการล้างแถวที่กรองหรือไม่ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear Content()
ล้างเนื้อหาของช่วงโดยที่ยังคงการจัดรูปแบบไว้
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:D10'); range.clearContent();
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear Data Validations()
ล้างกฎการตรวจสอบข้อมูลของช่วง
// Clear the data validation rules for cells A1:B5. const range = SpreadsheetApp.getActive().getRange('A1:B5'); range.clearDataValidations();
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear Format()
ล้างการจัดรูปแบบของช่วงนี้
ซึ่งจะล้างการจัดรูปแบบข้อความของเซลล์หรือเซลล์ในแถบ แต่จะไม่รีเซ็ตกฎการจัดรูปแบบตัวเลข
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:D10'); range.clearFormat();
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear Note()
ล้างโน้ตในเซลล์ที่ระบุ
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:D10'); range.clearNote();
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapse Groups()
ยุบกลุ่มทั้งหมดที่อยู่ภายในช่วง หากไม่มีกลุ่มใดอยู่ในช่วงที่เลือกทั้งหมด ระบบจะยุบกลุ่มที่ขยายอยู่ลึกที่สุดซึ่งอยู่ในช่วงที่เลือกบางส่วน
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const 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
copy Format To Range(gridId, column, columnEnd, row, rowEnd)
คัดลอกการจัดรูปแบบของช่วงไปยังตำแหน่งที่ระบุ หากปลายทางมีขนาดใหญ่หรือเล็กกว่าช่วงของแหล่งที่มา ระบบจะซ้ำหรือตัดแหล่งที่มาตามความเหมาะสม โปรดทราบว่าวิธีนี้จะคัดลอกเฉพาะการจัดรูปแบบเท่านั้น
ดูคำอธิบายโดยละเอียดของพารามิเตอร์ gridId ได้ที่ get
const ss = SpreadsheetApp.getActiveSpreadsheet(); const source = ss.getSheets()[0]; const range = source.getRange('B2:D4'); // This copies the formatting in B2:D4 in the source sheet to // D4:F6 in the sheet with gridId 1555299895. Note that you can get the gridId // of a sheet by calling sheet.getSheetId() or range.getGridId(). range.copyFormatToRange(1555299895, 4, 6, 4, 6);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
grid | Integer | รหัสที่ไม่ซ้ำกันของชีตภายในสเปรดชีต โดยไม่คำนึงถึงตำแหน่ง |
column | Integer | คอลัมน์แรกของช่วงเป้าหมาย |
column | Integer | คอลัมน์สิ้นสุดของช่วงเป้าหมาย |
row | Integer | แถวเริ่มต้นของช่วงเป้าหมาย |
row | Integer | แถวสุดท้ายของช่วงเป้าหมาย |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
ดูเพิ่มเติม
copy Format To Range(sheet, column, columnEnd, row, rowEnd)
คัดลอกการจัดรูปแบบของช่วงไปยังตำแหน่งที่ระบุ หากปลายทางมีขนาดใหญ่หรือเล็กกว่าช่วงของแหล่งที่มา ระบบจะซ้ำหรือตัดแหล่งที่มาตามความเหมาะสม โปรดทราบว่าวิธีนี้จะคัดลอกเฉพาะการจัดรูปแบบเท่านั้น
const ss = SpreadsheetApp.getActiveSpreadsheet(); const source = ss.getSheets()[0]; const destination = ss.getSheets()[1]; const range = source.getRange('B2:D4'); // This copies the formatting in B2:D4 in the source sheet to // D4:F6 in the second sheet range.copyFormatToRange(destination, 4, 6, 4, 6);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
sheet | Sheet | ชีตเป้าหมาย |
column | Integer | คอลัมน์แรกของช่วงเป้าหมาย |
column | Integer | คอลัมน์สิ้นสุดของช่วงเป้าหมาย |
row | Integer | แถวเริ่มต้นของช่วงเป้าหมาย |
row | Integer | แถวสุดท้ายของช่วงเป้าหมาย |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copy To(destination)
คัดลอกข้อมูลจากช่วงเซลล์หนึ่งไปยังอีกช่วงเซลล์หนึ่ง ระบบจะคัดลอกทั้งค่าและการจัดรูปแบบ
// The code below copies the first 5 columns over to the 6th column. const sheet = SpreadsheetApp.getActiveSheet(); const rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5); rangeToCopy.copyTo(sheet.getRange(1, 6));
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
destination | Range | ช่วงปลายทางที่จะคัดลอกไป เฉพาะตําแหน่งเซลล์ซ้ายบนเท่านั้นที่เกี่ยวข้อง |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copy To(destination, copyPasteType, transposed)
คัดลอกข้อมูลจากช่วงเซลล์หนึ่งไปยังอีกช่วงเซลล์หนึ่ง
// The code below copies only the values of the first 5 columns over to the 6th // column. const sheet = SpreadsheetApp.getActiveSheet(); sheet.getRange('A:E').copyTo( sheet.getRange('F1'), SpreadsheetApp.CopyPasteType.PASTE_VALUES, false, );
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
destination | Range | ช่วงปลายทางที่จะคัดลอกไป เฉพาะตําแหน่งเซลล์ซ้ายบนเท่านั้นที่เกี่ยวข้อง |
copy | Copy | ประเภทที่ระบุวิธีวางเนื้อหาของช่วงไปยังปลายทาง |
transposed | Boolean | ควรวางช่วงในแนวตั้งที่เปลี่ยนรูปแบบหรือไม่ |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copy To(destination, options)
คัดลอกข้อมูลจากช่วงเซลล์หนึ่งไปยังอีกช่วงเซลล์หนึ่ง โดยค่าเริ่มต้น ระบบจะคัดลอกทั้งค่าและการจัดรูปแบบ แต่คุณลบล้างการดำเนินการนี้ได้โดยใช้อาร์กิวเมนต์ขั้นสูง
// The code below copies only the values of the first 5 columns over to the 6th // column. const sheet = SpreadsheetApp.getActiveSheet(); sheet.getRange('A:E').copyTo(sheet.getRange('F1'), {contentsOnly: true});
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
destination | Range | ช่วงปลายทางที่จะคัดลอกไป เฉพาะตําแหน่งเซลล์ซ้ายบนเท่านั้นที่เกี่ยวข้อง |
options | Object | ออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูงตามที่ระบุไว้ด้านล่าง |
พารามิเตอร์ขั้นสูง
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
format | Boolean | ระบุว่าควรคัดลอกเฉพาะรูปแบบ |
contents | Boolean | ระบุว่าควรคัดลอกเฉพาะเนื้อหา |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copy Values To Range(gridId, column, columnEnd, row, rowEnd)
คัดลอกเนื้อหาของช่วงไปยังตำแหน่งที่ระบุ หากปลายทางมีขนาดใหญ่หรือเล็กกว่าช่วงของแหล่งที่มา ระบบจะซ้ำหรือตัดแหล่งที่มาตามความเหมาะสม
ดูคำอธิบายโดยละเอียดของพารามิเตอร์ gridId ได้ที่ get
const ss = SpreadsheetApp.getActiveSpreadsheet(); const source = ss.getSheets()[0]; const range = source.getRange('B2:D4'); // This copies the data in B2:D4 in the source sheet to // D4:F6 in the sheet with gridId 0 range.copyValuesToRange(0, 4, 6, 4, 6);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
grid | Integer | รหัสที่ไม่ซ้ำกันของชีตภายในสเปรดชีต โดยไม่คำนึงถึงตำแหน่ง |
column | Integer | คอลัมน์แรกของช่วงเป้าหมาย |
column | Integer | คอลัมน์สิ้นสุดของช่วงเป้าหมาย |
row | Integer | แถวเริ่มต้นของช่วงเป้าหมาย |
row | Integer | แถวสุดท้ายของช่วงเป้าหมาย |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
ดูเพิ่มเติม
copy Values To Range(sheet, column, columnEnd, row, rowEnd)
คัดลอกเนื้อหาของช่วงไปยังตำแหน่งที่ระบุ หากปลายทางมีขนาดใหญ่หรือเล็กกว่าช่วงของแหล่งที่มา ระบบจะซ้ำหรือตัดแหล่งที่มาตามความเหมาะสม
const ss = SpreadsheetApp.getActiveSpreadsheet(); const source = ss.getSheets()[0]; const destination = ss.getSheets()[1]; const range = source.getRange('B2:D4'); // This copies the data in B2:D4 in the source sheet to // D4:F6 in the second sheet range.copyValuesToRange(destination, 4, 6, 4, 6);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
sheet | Sheet | ชีตเป้าหมาย |
column | Integer | คอลัมน์แรกของช่วงเป้าหมาย |
column | Integer | คอลัมน์สิ้นสุดของช่วงเป้าหมาย |
row | Integer | แถวเริ่มต้นของช่วงเป้าหมาย |
row | Integer | แถวสุดท้ายของช่วงเป้าหมาย |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
create Data Source Pivot Table(dataSource)
สร้างตาราง Pivot ของแหล่งข้อมูลว่างจากแหล่งข้อมูลโดยยึดที่เซลล์แรกในช่วงนี้
ตัวอย่างนี้แสดงวิธีสร้างและกําหนดค่าตาราง Pivot แหล่งข้อมูลใหม่
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); const anchorCell = spreadsheet.getSheets()[0].getRange('A1'); const dataSource = spreadsheet.getDataSources()[0]; const pivotTable = anchorCell.createDataSourcePivotTable(dataSource); pivotTable.addRowGroup('dataColumnA'); pivotTable.addColumnGroup('dataColumnB'); pivotTable.addPivotValue( 'dataColumnC', SpreadsheetApp.PivotTableSummarizeFunction.SUM, ); pivotTable.addFilter( 'dataColumnA', SpreadsheetApp.newFilterCriteria().whenTextStartsWith('A').build(), );
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
data | Data | แหล่งข้อมูลที่จะสร้างตาราง Pivot |
รีเทิร์น
Data
— ตาราง Pivot ของแหล่งข้อมูลที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
create Data Source Table(dataSource)
สร้างตารางแหล่งข้อมูลว่างเปล่าจากแหล่งข้อมูลโดยยึดที่เซลล์แรกในช่วงนี้
ตัวอย่างนี้แสดงวิธีสร้างและกําหนดค่าตารางแหล่งข้อมูลใหม่
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); const anchorCell = spreadsheet.getSheets()[0].getRange('A1'); const dataSource = spreadsheet.getDataSources()[0]; const dataSourceTable = anchorCell.createDataSourceTable(dataSource) .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC') .addSortSpec('dataColumnA', true) // ascending=true .addSortSpec('dataColumnB', false); // ascending=false
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
data | Data | แหล่งข้อมูลที่จะสร้างตาราง Pivot |
รีเทิร์น
Data
— ตารางแหล่งข้อมูลที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
create Developer Metadata Finder()
แสดงผล 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());
รีเทิร์น
Developer
— เครื่องมือค้นหาข้อมูลเมตาของนักพัฒนาแอปเพื่อค้นหาข้อมูลเมตาในขอบเขตของช่วงนี้
create Filter()
สร้างตัวกรองและนำไปใช้กับช่วงที่ระบุในชีต คุณสร้างตัวกรองในชีตได้ไม่เกิน 1 รายการ หากต้องการเข้าถึงและแก้ไขตัวกรองหลังจากสร้างแล้ว ให้ใช้ get
หรือ Sheet.getFilter()
const ss = SpreadsheetApp.getActiveSheet(); const range = ss.getRange('A1:C20'); // Creates a new filter and applies it to the range A1:C20 on the active sheet. function createFilter() { range.createFilter(); } // Gets the filter and applies criteria that only shows cells that aren't empty. function getFilterAddCriteria() { const filter = range.getFilter(); const criteria = SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build(); filter.setColumnFilterCriteria(2, criteria); }ใช้วิธีนี้เพื่อสร้างตัวกรองสำหรับชีต
Grid
ซึ่งเป็นชีตประเภทเริ่มต้น
ชีตตารางกริดคือชีตที่ไม่ได้เชื่อมต่อกับฐานข้อมูล หากต้องการสร้างตัวกรองประเภทอื่นๆ ให้ดูข้อมูลต่อไปนี้
- สร้างตัวกรองตาราง Pivot ด้วย
Pivot
Table.addFilter(sourceDataColumn, filterCriteria) - สร้างตัวกรองสำหรับชีตที่เชื่อมต่อกับฐานข้อมูลด้วย
Data
Source Sheet.addFilter(columnName, filterCriteria) - สร้างตัวกรองสําหรับตาราง Pivot ที่เชื่อมต่อกับฐานข้อมูลด้วย
Data
Source Pivot Table.addFilter(columnName, filterCriteria)
รีเทิร์น
Filter
— ตัวกรองใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
create Pivot Table(sourceData)
สร้างตาราง Pivot ว่างจาก source
ที่ระบุซึ่งยึดอยู่ที่เซลล์แรกในช่วงนี้
// 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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
source | Range | ข้อมูลที่จะสร้างตาราง Pivot |
รีเทิร์น
Pivot
— Pivot
ที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
create Text Finder(findText)
สร้างเครื่องมือค้นหาข้อความสำหรับช่วง ซึ่งสามารถค้นหาและแทนที่ข้อความในนี้ได้
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const range = sheet.getActiveRange(); // Creates a text finder for the range. const textFinder = range.createTextFinder('dog'); // Returns the first occurrence of 'dog'. const firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. const numOccurrencesReplaced = textFinder.replaceWith('cat');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
find | String | ข้อความที่จะค้นหา |
รีเทิร์น
Text
— Text
ของช่วง
delete Cells(shiftDimension)
ลบช่วงของเซลล์นี้ ระบบจะเลื่อนข้อมูลที่มีอยู่ในชีตตามมิติข้อมูลที่ระบุไปไว้ในช่วงที่ถูกลบ
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:D10'); range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
shift | Dimension | มิติข้อมูลที่จะใช้เลื่อนข้อมูลที่มีอยู่ |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expand Groups()
ขยายกลุ่มที่ยุบอยู่ซึ่งมีช่วงหรือปุ่มสลับการควบคุมที่ตัดกับช่วงนี้ ตำแหน่งปุ่มเปิด/ปิดการควบคุมคือดัชนีที่ปุ่มเปิด/ปิดการควบคุมจะแสดงก่อนหรือหลังกลุ่มโดยตรง ทั้งนี้ขึ้นอยู่กับการตั้งค่า หากมีกลุ่มมากกว่า 1 กลุ่มในตำแหน่งเดียวกัน ระบบจะขยายกลุ่มที่ตื้นที่สุด
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const 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
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const 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
get Background()
ส่งกลับสีพื้นหลังของเซลล์ซ้ายบนสุดในช่วง (เช่น '#ffffff'
)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B5'); Logger.log(cell.getBackground());
รีเทิร์น
String
— รหัสสีของพื้นหลัง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Background Object()
แสดงผลสีพื้นหลังของเซลล์ซ้ายบนในช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const 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
get Background Objects()
แสดงผลสีพื้นหลังของเซลล์ในช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B5:C6'); const bgColors = range.getBackgroundObjects(); for (const i in bgColors) { for (const j in bgColors[i]) { Logger.log(bgColors[i][j].asRgbColor().asHexString()); } }
รีเทิร์น
Color[][]
— อาร์เรย์ 2 มิติของสีพื้นหลัง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Backgrounds()
แสดงผลสีพื้นหลังของเซลล์ในช่วง (เช่น '#ffffff'
)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B5:C6'); const bgColors = range.getBackgrounds(); for (const i in bgColors) { for (const j in bgColors[i]) { Logger.log(bgColors[i][j]); } }
รีเทิร์น
String[][]
— อาร์เรย์ 2 มิติของรหัสสีของพื้นหลัง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Bandings()
แสดงผลแถบทั้งหมดที่ใช้กับเซลล์ใดก็ได้ในช่วงนี้
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Sets a range. const range = sheet.getRange('A1:K50'); // Gets the banding info for the range. const bandings = range.getBandings(); // Logs the second row color for each banding to the console. for (const banding of bandings) { console.log(banding.getSecondRowColor()); }
รีเทิร์น
Banding[]
— แถบทั้งหมดที่ใช้กับเซลล์ในช่วงนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Cell(row, column)
แสดงผลเซลล์ที่ระบุภายในช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); // The row and column here are relative to the range // getCell(1,1) in this code returns the cell at B2 const cell = range.getCell(1, 1); Logger.log(cell.getValue());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
row | Integer | แถวของเซลล์ที่เกี่ยวข้องกับช่วง |
column | Integer | คอลัมน์ของเซลล์ที่เกี่ยวข้องกับช่วง |
รีเทิร์น
Range
— ช่วงที่มีเซลล์เดียวที่พิกัดที่ระบุ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Column()
แสดงตำแหน่งคอลัมน์เริ่มต้นของช่วงนี้
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const 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
get Data Region()
แสดงผลสําเนาของช่วงที่ขยายใน Direction
หลัก 4 รายการเพื่อครอบคลุมเซลล์ที่อยู่ติดกันทั้งหมดที่มีข้อมูล หากช่วงล้อมรอบด้วยเซลล์ว่างซึ่งไม่รวมเซลล์ตามแนวทแยง ระบบจะแสดงผลช่วงนั้นๆ ซึ่งคล้ายกับการเลือกช่วงและพิมพ์ Ctrl+A
ในเครื่องมือแก้ไข
// Assume the active spreadsheet is blank. const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; sheet.getRange('C2').setValue(100); sheet.getRange('B3').setValue(100); sheet.getRange('D3').setValue(100); sheet.getRange('C4').setValue(100); // Logs "B2:D4" Logger.log(sheet.getRange('C3').getDataRegion().getA1Notation());
รีเทิร์น
Range
— เขตข้อมูลของช่วงหรือช่วงสำหรับทั้งสเปรดชีต
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Region(dimension)
แสดงผลสําเนาของช่วงแบบขยาย Direction.UP
และ Direction.DOWN
หากมิติข้อมูลที่ระบุคือ Dimension.ROWS
หรือ Direction.NEXT
และ Direction.PREVIOUS
หากมิติข้อมูลคือ Dimension.COLUMNS
การขยายช่วงจะอิงตามการตรวจหาข้อมูลข้างช่วงที่จัดระเบียบเหมือนตาราง ช่วงแบบขยายจะครอบคลุมเซลล์ที่อยู่ติดกันทั้งหมดซึ่งมีข้อมูลอยู่ตามมิติข้อมูลที่ระบุ รวมถึงขอบเขตของตาราง หากช่วงเดิมล้อมรอบด้วยเซลล์ว่างตามมิติข้อมูลที่ระบุ ระบบจะแสดงผลช่วงนั้น วิธีนี้คล้ายกับการเลือกช่วงแล้วพิมพ์
Ctrl+Space
สำหรับคอลัมน์หรือ Shift+Space
สำหรับแถวในเครื่องมือแก้ไข
// Assume the active spreadsheet is blank. const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; sheet.getRange('C2').setValue(100); sheet.getRange('B3').setValue(100); sheet.getRange('D3').setValue(100); sheet.getRange('C4').setValue(100); // Logs "C2:C4" Logger.log( sheet.getRange('C3') .getDataRegion(SpreadsheetApp.Dimension.ROWS) .getA1Notation(), ); // Logs "B3:D3" Logger.log( sheet.getRange('C3') .getDataRegion(SpreadsheetApp.Dimension.COLUMNS) .getA1Notation(), );
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
dimension | Dimension | มิติข้อมูลที่จะใช้ขยายช่วง |
รีเทิร์น
Range
— เขตข้อมูลของช่วงหรือช่วงครอบคลุมแต่ละคอลัมน์หรือแต่ละแถวที่ครอบคลุมโดยช่วงเดิม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Source Formula()
แสดงผล Data
สำหรับเซลล์แรกในช่วง หรือ null
หากเซลล์ไม่มีสูตรแหล่งข้อมูล
// Opens the spreadsheet file by its ID. If you created your script from a // Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1 on Sheet1. const range = sheet.getRange('A1'); // Gets the data source formula from cell A1. const dataSourceFormula = range.getDataSourceFormula(); // Gets the formula. const formula = dataSourceFormula.getFormula(); // Logs the formula. console.log(formula);
รีเทิร์น
Data
— Data
ของเซลล์
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Source Formulas()
แสดงผล Data
สำหรับเซลล์ในช่วง
// Opens the spreadsheet file by its ID. If you created your script from a // Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:B5 on Sheet1. const range = sheet.getRange('A1:B5'); // Gets an array of the data source formulas in the range A1:B5. const dataSourceFormulas = range.getDataSourceFormulas(); // Logs the first formula in the array. console.log(dataSourceFormulas[0].getFormula());
รีเทิร์น
Data
— อาร์เรย์ของ Data
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Source Pivot Tables()
รับตาราง Pivot ของแหล่งข้อมูลทั้งหมดที่ตัดกับช่วง
// Opens the spreadsheet file by its ID. If you created your script from a // Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:G50 on Sheet1. const range = sheet.getRange('A1:G50'); // Gets an array of the data source pivot tables in the range A1:G50. const dataSourcePivotTables = range.getDataSourcePivotTables(); // Logs the last time that the first pivot table in the array was refreshed. console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());
รีเทิร์น
Data
— รายการตาราง Pivot ของแหล่งข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Source Tables()
รับตารางแหล่งข้อมูลทั้งหมดที่ตัดกับช่วง
// Opens the spreadsheet file by its ID. If you created your script from a // Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:G50 on Sheet1. const range = sheet.getRange('A1:G50'); // Gets the first data source table in the range A1:G50. const dataSourceTable = range.getDataSourceTables()[0]; // Logs the time of the last completed data execution on the data source table. console.log(dataSourceTable.getStatus().getLastExecutionTime());
รีเทิร์น
Data
— รายการตารางแหล่งข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Source Url()
แสดงผล URL ของข้อมูลในช่วงนี้ ซึ่งสามารถใช้สร้างแผนภูมิและการค้นหา
Code.gs
function doGet() { const ss = SpreadsheetApp.openById( '1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c', ); const sheet = ss.getSheetByName('ContinentData'); const range = sheet.getRange('A1:B8'); const template = HtmlService.createTemplateFromFile('piechart'); template.dataSourceUrl = range.getDataSourceUrl(); return template.evaluate(); }
piechart.html
<!DOCTYPE html> <html> <head> <!--Load the AJAX API--> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> // Load the Visualization API and the corechart package. google.charts.load('current', {'packages': ['corechart']}); // Set a callback to run when the Google Visualization API is loaded. google.charts.setOnLoadCallback(queryData); function queryData() { var query = new google.visualization.Query('<?= dataSourceUrl ?>'); query.send(drawChart); } // Callback that creates and populates a data table, // instantiates the pie chart, passes in the data and // draws it. function drawChart(response) { if (response.isError()) { alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage()); return; } var data = response.getDataTable(); // Set chart options. var options = { title: 'Population by Continent', width: 400, height: 300 }; // Instantiate and draw the chart, passing in some options. var chart = new google.visualization.PieChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <!-- Div that holds the pie chart. --> <div id="chart_div"></div> </body> </html>
รีเทิร์น
String
— URL สำหรับช่วงนี้เป็นแหล่งข้อมูลซึ่งส่งไปยัง API อื่นๆ ได้ เช่น แผนภูมิ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Table()
แสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น DataTable
// Opens the spreadsheet file by its ID. If you created your script from a // Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:B7 on Sheet1. const range = sheet.getRange('A1:B7'); // Gets the range A1:B7 as a data table. The values in each column must be of // the same type. const datatable = range.getDataTable(); // Uses the Charts service to build a bar chart from the data table. // This doesn't build an embedded chart. To do that, use // sheet.newChart().addRange() instead. const chart = Charts.newBarChart() .setDataTable(datatable) .setOption('title', 'Your Chart Title Here') .build();
รีเทิร์น
Data
— ข้อมูลในรูปแบบตารางข้อมูล
get Data Table(firstRowIsHeader)
แสดงผลข้อมูลภายในช่วงนี้เป็น DataTable
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B7'); // Calling this method with "true" sets the first line to be the title of the // axes const datatable = range.getDataTable(true); // Note that this doesn't build an EmbeddedChart, so you can't just use // Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead. const chart = Charts.newBarChart() .setDataTable(datatable) .setOption('title', 'Your Title Here') .build();
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
first | Boolean | ระบุว่าให้ถือว่าแถวแรกเป็นส่วนหัวหรือไม่ |
รีเทิร์น
Data
— ข้อมูลเป็นตารางข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Validation()
แสดงผลกฎการตรวจสอบข้อมูลสําหรับเซลล์ซ้ายบนในช่วง หากไม่ได้ตั้งค่าการตรวจสอบข้อมูลในเซลล์ เมธอดนี้จะแสดงผลลัพธ์เป็น null
// Log information about the data validation rule for cell A1. const cell = SpreadsheetApp.getActive().getRange('A1'); const rule = cell.getDataValidation(); if (rule != null) { const criteria = rule.getCriteriaType(); const args = rule.getCriteriaValues(); Logger.log('The data validation rule is %s %s', criteria, args); } else { Logger.log('The cell does not have a data validation rule.'); }
รีเทิร์น
Data
— กฎการตรวจสอบข้อมูลสําหรับเซลล์ด้านซ้ายบนของช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Validations()
แสดงผลกฎการตรวจสอบข้อมูลสำหรับเซลล์ทั้งหมดในช่วง หากไม่ได้ตั้งค่าการตรวจสอบข้อมูลในเซลล์หนึ่งๆ เมธอดนี้จะแสดงผล null
สำหรับตําแหน่งของเซลล์นั้นในอาร์เรย์
// Change existing data validation rules that require a date in 2013 to require // a date in 2014. const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')]; const newDates = [new Date('1/1/2014'), new Date('12/31/2014')]; const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns()); const rules = range.getDataValidations(); for (let i = 0; i < rules.length; i++) { for (let j = 0; j < rules[i].length; j++) { const rule = rules[i][j]; if (rule != null) { const criteria = rule.getCriteriaType(); const args = rule.getCriteriaValues(); if (criteria === SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN && args[0].getTime() === oldDates[0].getTime() && args[1].getTime() === oldDates[1].getTime()) { // Create a builder from the existing rule, then change the dates. rules[i][j] = rule.copy().withCriteria(criteria, newDates).build(); } } } } range.setDataValidations(rules);
รีเทิร์น
Data
— อาร์เรย์ 2 มิติของกฎการตรวจสอบข้อมูลที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Developer Metadata()
รับข้อมูลเมตาของนักพัฒนาแอปที่เชื่อมโยงกับช่วงนี้
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on Sheet1. const range = sheet.getRange('2:2'); // Adds metadata to row 2. range.addDeveloperMetadata('NAME', 'GOOGLE'); // Logs the metadata to console. for (const metadata of range.getDeveloperMetadata()) { console.log(`${metadata.getKey()}: ${metadata.getValue()}`); }
รีเทิร์น
Developer
— ข้อมูลเมตาของนักพัฒนาแอปที่เชื่อมโยงกับช่วงนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Display Value()
แสดงผลค่าของเซลล์ซ้ายบนสุดในช่วง ค่าคือ String
ค่าที่แสดงจะพิจารณาการจัดรูปแบบวันที่ เวลา และสกุลเงิน รวมถึงรูปแบบที่การตั้งค่าภาษาของสเปรดชีตใช้โดยอัตโนมัติ เซลล์ว่างจะแสดงผลสตริงว่าง
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A30 and sets its value to 'Test code.' const cell = sheet.getRange('A30'); cell.setValue('Test code'); // Gets the value and logs it to the console. console.log(cell.getDisplayValue());
รีเทิร์น
String
— ค่าที่แสดงในเซลล์นี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Display Values()
แสดงผลตารางกริดสี่เหลี่ยมผืนผ้าของค่าสําหรับช่วงนี้
แสดงผลอาร์เรย์ 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. const values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues(); Logger.log(values[0][0]);
รีเทิร์น
String[][]
— อาร์เรย์ค่า 2 มิติ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Filter()
แสดงตัวกรองในชีตของช่วงที่เป็นของช่วงนี้ หรือ null
หากไม่มีตัวกรองในชีต
const ss = SpreadsheetApp.getActiveSheet(); const range = ss.getRange('A1:C20'); // Gets the existing filter on the sheet that the given range belongs to. const filter = range.getFilter();
รีเทิร์น
Filter
— ตัวกรอง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Font Color Object()
แสดงสีแบบอักษรของเซลล์ที่มุมซ้ายบนของช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const 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
get Font Color Objects()
แสดงผลสีแบบอักษรของเซลล์ในช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getFontColorObjects(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j].asRgbColor().asHexString()); } }
รีเทิร์น
Color[][]
— อาร์เรย์ 2 มิติของสีแบบอักษรที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Font Families()
แสดงผลชุดแบบอักษรของเซลล์ในช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getFontFamilies(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j]); } }
รีเทิร์น
String[][]
— อาร์เรย์ 2 มิติของชุดแบบอักษรที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Font Family()
แสดงชุดแบบอักษรของเซลล์ที่มุมซ้ายบนของช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getFontFamily());
รีเทิร์น
String
— ชุดแบบอักษรของเซลล์
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Font Line()
รับรูปแบบเส้นของเซลล์ที่มุมซ้ายบนของช่วง ('underline'
,
'line-through'
หรือ 'none'
)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getFontLine());
รีเทิร์น
String
— บรรทัดแบบอักษร
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Font Lines()
รับรูปแบบเส้นของเซลล์ในช่วง ('underline'
, 'line-through'
หรือ 'none'
)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getFontLines(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j]); } }
รีเทิร์น
String[][]
— อาร์เรย์ 2 มิติของเส้นแบบอักษรที่เชื่อมโยงกับเซลล์ในแถว
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Font Size()
แสดงผลขนาดแบบอักษรเป็นขนาดจุดของเซลล์ที่มุมบนซ้ายของช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getFontSize());
รีเทิร์น
Integer
— ขนาดแบบอักษรเป็นจุด
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Font Sizes()
แสดงผลขนาดแบบอักษรของเซลล์ในช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getFontSizes(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j]); } }
รีเทิร์น
Integer[][]
— อาร์เรย์ 2 มิติของขนาดแบบอักษรของข้อความที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Font Style()
แสดงผลรูปแบบแบบอักษร ('italic'
หรือ 'normal'
) ของเซลล์ที่มุมซ้ายบนของช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getFontStyle());
รีเทิร์น
String
— รูปแบบแบบอักษรของข้อความในเซลล์
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Font Styles()
แสดงผลสไตล์แบบอักษรของเซลล์ในช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getFontStyles(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j]); } }
รีเทิร์น
String[][]
— อาร์เรย์ 2 มิติของรูปแบบแบบอักษรของข้อความที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Font Weight()
ส่งกลับน้ำหนักแบบอักษร (ปกติ/หนา) ของเซลล์ที่มุมซ้ายบนของช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getFontWeight());
รีเทิร์น
String
— น้ำหนักแบบอักษรของข้อความในเซลล์
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Font Weights()
แสดงผลน้ำหนักแบบอักษรของเซลล์ในช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getFontWeights(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j]); } }
รีเทิร์น
String[][]
— อาร์เรย์ 2 มิติของน้ำหนักแบบอักษรของข้อความที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Formula()
แสดงผลสูตร (รูปแบบ A1) สำหรับเซลล์ซ้ายบนของช่วง หรือสตริงว่างหากเซลล์ว่างเปล่าหรือไม่มีสูตร
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This assumes you have a function in B5 that sums up // B2:B4 const range = sheet.getRange('B5'); // Logs the calculated value and the formula Logger.log( 'Calculated value: %s Formula: %s', range.getValue(), range.getFormula(), );
รีเทิร์น
String
— สูตรของเซลล์
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Formula R1C1()
แสดงผลสูตร (รูปแบบ R1C1) สําหรับเซลล์ที่ระบุ หรือ null
หากไม่มี
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B5'); const formula = range.getFormulaR1C1(); Logger.log(formula);
รีเทิร์น
String
— สูตรในรูปแบบ R1C1
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Formulas()
แสดงผลสูตร (รูปแบบ A1) สำหรับเซลล์ในช่วง รายการในอาร์เรย์ 2 มิติจะเป็นสตริงว่างสําหรับเซลล์ที่ไม่มีสูตร
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B5:C6'); const formulas = range.getFormulas(); for (const i in formulas) { for (const j in formulas[i]) { Logger.log(formulas[i][j]); } }
รีเทิร์น
String[][]
— อาร์เรย์สูตร 2 มิติในรูปแบบสตริง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Formulas R1C1()
แสดงผลสูตร (รูปแบบ R1C1) สำหรับเซลล์ในช่วง รายการในอาร์เรย์ 2 มิติคือ null
สำหรับเซลล์ที่ไม่มีสูตร
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B5:C6'); const formulas = range.getFormulasR1C1(); for (const i in formulas) { for (const j in formulas[i]) { Logger.log(formulas[i][j]); } }
รีเทิร์น
String[][]
— อาร์เรย์ 2 มิติของสูตรในรูปแบบ R1C1
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Grid Id()
แสดงผลรหัสตารางกริดของชีตหลักของช่วง รหัสคือค่า int แบบสุ่มที่ไม่ใช่ค่าลบ
// Log the grid ID of the first sheet (by tab position) in the spreadsheet. const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getGridId());
รีเทิร์น
Integer
— รหัสตารางกริดของชีตหลัก
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Height()
แสดงผลความสูงของช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const 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
get Horizontal Alignment()
ส่งกลับการจัดแนวข้อความแนวนอน (ซ้าย/กลาง/ขวา) ของเซลล์ที่มุมซ้ายบนของช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getHorizontalAlignment());
รีเทิร์น
String
— การจัดแนวข้อความในแนวนอนของเซลล์
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Horizontal Alignments()
แสดงผลการจัดแนวแนวนอนของเซลล์ในช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getHorizontalAlignments(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j]); } }
รีเทิร์น
String[][]
— อาร์เรย์ 2 มิติของการจัดแนวข้อความในแนวนอนที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Last Column()
แสดงผลตําแหน่งคอลัมน์สิ้นสุด
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const 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
get Last Row()
แสดงผลตําแหน่งของแถวสุดท้าย
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const 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
get Merged Ranges()
แสดงผลอาร์เรย์ของออบเจ็กต์ Range
ที่แสดงถึงเซลล์ที่ผสานซึ่งอยู่ภายในช่วงปัจจุบันทั้งหมด หรือมีเซลล์อย่างน้อย 1 เซลล์ในช่วงปัจจุบัน
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B3'); const mergedRanges = range.getMergedRanges(); for (let i = 0; i < mergedRanges.length; i++) { Logger.log(mergedRanges[i].getA1Notation()); Logger.log(mergedRanges[i].getDisplayValue()); }
รีเทิร์น
Range[]
— อาร์เรย์ของออบเจ็กต์ Range
ที่แสดงเซลล์ที่ผสานซึ่งทับซ้อนกับช่วง
get Next Data Cell(direction)
เริ่มจากเซลล์ในคอลัมน์และแถวแรกของช่วง ให้แสดงผลเซลล์ถัดไปในทิศทางที่ระบุซึ่งเป็นขอบของช่วงเซลล์ที่อยู่ติดกันซึ่งมีข้อมูลอยู่ หรือเซลล์ที่ขอบของสเปรดชีตในทิศทางนั้น ซึ่งเทียบเท่ากับการพิมพ์
Ctrl+[arrow key]
ในเครื่องมือแก้ไข
// Assume the active spreadsheet is blank. const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('C3:E5'); // Logs "C1" Logger.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getA1Notation());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
direction | Direction | ทิศทางที่จะค้นหาเซลล์ขอบเขตข้อมูลถัดไป |
รีเทิร์น
Range
— เซลล์ขอบเขตเขตข้อมูลหรือเซลล์ที่ขอบของสเปรดชีต
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Note()
แสดงผลหมายเหตุที่เชื่อมโยงกับช่วงที่กำหนด
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getNote());
รีเทิร์น
String
— หมายเหตุที่เชื่อมโยงกับเซลล์ที่ระบุ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Notes()
แสดงผลหมายเหตุที่เชื่อมโยงกับเซลล์ในช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getNotes(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j]); } }
รีเทิร์น
String[][]
— อาร์เรย์โน้ต 2 มิติที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Num Columns()
แสดงผลจํานวนคอลัมน์ในช่วงนี้
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D5'); Logger.log(range.getNumColumns());
รีเทิร์น
Integer
— จํานวนคอลัมน์ในช่วงนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Num Rows()
แสดงผลจํานวนแถวในระยะนี้
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D5'); Logger.log(range.getNumRows());
รีเทิร์น
Integer
— จํานวนแถวในช่วงนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Number Format()
รับการจัดรูปแบบตัวเลขหรือวันที่ของเซลล์ซ้ายบนของช่วงที่กำหนด รูปแบบที่แสดงผลจะอธิบายไว้ในเอกสารประกอบของ Sheets API
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('C4'); Logger.log(cell.getNumberFormat());
รีเทิร์น
String
— รูปแบบตัวเลขของเซลล์ซ้ายบนของช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Number Formats()
แสดงผลรูปแบบตัวเลขหรือวันที่ของเซลล์ในช่วงที่ระบุ รูปแบบที่แสดงผลจะอธิบายไว้ในเอกสารประกอบของชีต API
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B5:C6'); const formats = range.getNumberFormats(); for (const i in formats) { for (const j in formats[i]) { Logger.log(formats[i][j]); } }
รีเทิร์น
String[][]
— อาร์เรย์ 2 มิติของรูปแบบตัวเลข
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Rich Text Value()
แสดงผลค่า Rich Text สำหรับเซลล์ซ้ายบนสุดของช่วง หรือ null
หากค่าของเซลล์ไม่ใช่ข้อความ
// Gets the Rich Text value of cell D4. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('D4:F6'); const richText = range.getRichTextValue(); console.log(richText.getText());
รีเทิร์น
Rich
— ค่า Rich Text ของเซลล์ซ้ายบนสุดในช่วง หรือ null
หากค่าของเซลล์ไม่ใช่ข้อความ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Rich Text Values()
แสดงผลค่าข้อความที่มีรูปแบบของเซลล์ในช่วง
// Gets the Rich Text values for all cells in range B5:C6 const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B5:C6'); const values = range.getRichTextValues(); for (let i = 0; i < values.length; i++) { for (let j = 0; j < values[i].length; j++) { console.log(values[i][j].getText()); } }
รีเทิร์น
Rich
— อาร์เรย์ 2 มิติของค่าข้อความที่มีรูปแบบ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Row()
แสดงผลตําแหน่งแถวของช่วงนี้ เหมือนกับ get
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2'); Logger.log(range.getRow());
รีเทิร์น
Integer
— ตำแหน่งแถวของช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Row Index()
แสดงผลตําแหน่งแถวของช่วงนี้ เหมือนกับ get
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2'); Logger.log(range.getRowIndex());
รีเทิร์น
Integer
— ตำแหน่งแถวของช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
ดูเพิ่มเติม
get Sheet()
แสดงผลชีตของช่วงที่เลือก
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the sheet that the range belongs to. const rangeSheet = range.getSheet(); // Gets the sheet name and logs it to the console. console.log(rangeSheet.getName());
รีเทิร์น
Sheet
— ชีตของช่วงนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Text Direction()
ส่งกลับทิศทางข้อความของเซลล์ซ้ายบนสุดของช่วง แสดงผล null
หากระบบกำหนดทิศทางข้อความของเซลล์ด้วยการตรวจหาอัตโนมัติ
// Get the text direction of cell B1. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B1:D4'); Logger.log(range.getTextDirection());
รีเทิร์น
Text
— ทิศทางข้อความของเซลล์ซ้ายบนสุดในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Text Directions()
แสดงผลทิศทางของข้อความสำหรับเซลล์ในช่วง รายการในอาร์เรย์ 2 มิติคือ null
สำหรับเซลล์ที่ใช้การตรวจจับอัตโนมัติ
// Get the text directions for all cells in range B5:C6 const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B5:C6'); const directions = range.getTextDirections(); for (let i = 0; i < directions.length; i++) { for (let j = 0; j < directions[i].length; j++) { Logger.log(directions[i][j]); } }
รีเทิร์น
Text
— อาร์เรย์ 2 มิติของทิศทางข้อความ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Text Rotation()
ส่งกลับการตั้งค่าการหมุนข้อความสําหรับเซลล์ซ้ายบนสุดของช่วง
// Log the text rotation settings for a cell. const sheet = SpreadsheetApp.getActiveSheet(); const cell = sheet.getRange('A1'); Logger.log(cell.getTextRotation());
รีเทิร์น
Text
— การตั้งค่าการหมุนข้อความ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Text Rotations()
แสดงผลการตั้งค่าการหมุนข้อความสําหรับเซลล์ในช่วง
const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B2:D4'); const results = range.getTextRotations(); for (const i in results) { for (const j in results[i]) { const rotation = results[i][j]; Logger.log('Cell [%s, %s] has text rotation: %v', i, j, rotation); } }
รีเทิร์น
Text
— อาร์เรย์ 2 มิติของการหมุนข้อความที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Text Style()
ส่งกลับรูปแบบข้อความของเซลล์ซ้ายบนสุดของช่วง
// Get the text style of cell D4. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('D4:F6'); const style = range.getTextStyle(); Logger.log(style);
รีเทิร์น
Text
— รูปแบบข้อความของเซลล์ซ้ายบนสุดในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Text Styles()
แสดงผลสไตล์ข้อความของเซลล์ในช่วง
// Get the text styles for all cells in range B5:C6 const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B5:C6'); const styles = range.getTextStyles(); for (let i = 0; i < styles.length; i++) { for (let j = 0; j < styles[i].length; j++) { Logger.log(styles[i][j]); } }
รีเทิร์น
Text
— อาร์เรย์รูปแบบข้อความ 2 มิติ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Value()
ส่งคืนค่าของเซลล์ซ้ายบนสุดในช่วง ค่าอาจเป็นประเภท Number
,
Boolean
, Date
หรือ String
โดยขึ้นอยู่กับค่าของเซลล์ เซลล์ว่างจะแสดงผลสตริงว่าง
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the value of the top-left cell in the range and logs it to the console. console.log(range.getValue());
รีเทิร์น
Object
— ค่าในเซลล์นี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Values()
แสดงผลตารางกริดสี่เหลี่ยมผืนผ้าของค่าสําหรับช่วงนี้
แสดงผลอาร์เรย์ 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. const values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues(); Logger.log(values[0][0]);ในเว็บแอป ค่า
Date
ไม่ใช่พารามิเตอร์ที่ถูกต้อง get Values()
แสดงผลข้อมูลไปยังเว็บแอปไม่ได้หากช่วงมีเซลล์ที่มีค่า Date
แต่ให้เปลี่ยนค่าทั้งหมดที่ดึงมาจากชีตเป็นค่าพื้นฐานของ JavaScript ที่รองรับ เช่น Number
, Boolean
หรือ String
รีเทิร์น
Object[][]
— อาร์เรย์ค่า 2 มิติ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Vertical Alignment()
ส่งกลับการจัดแนวแนวตั้ง (บน/กลาง/ล่าง) ของเซลล์ที่มุมซ้ายบนของช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getVerticalAlignment());
รีเทิร์น
String
— การจัดแนวข้อความในแนวตั้งของเซลล์
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Vertical Alignments()
แสดงผลการจัดแนวแนวตั้งของเซลล์ในช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getVerticalAlignments(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j]); } }
รีเทิร์น
String[][]
— อาร์เรย์ 2 มิติของการจัดแนวข้อความในแนวตั้งที่เชื่อมโยงกับเซลล์ในแถว
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Width()
แสดงผลความกว้างของช่วงเป็นคอลัมน์
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the width of the range in number of columns and logs it to the console. console.log(range.getWidth());
รีเทิร์น
Integer
— จํานวนคอลัมน์ในช่วงที่ระบุ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Wrap()
แสดงผลว่าข้อความในเซลล์มีการตัดขึ้นบรรทัดใหม่หรือไม่ หากต้องการดูกลยุทธ์การรวมที่ละเอียดยิ่งขึ้น ให้ใช้ get
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getWrap());
รีเทิร์น
Boolean
— ระบุว่าข้อความในเซลล์นี้ตัดขึ้นบรรทัดใหม่หรือไม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Wrap Strategies()
แสดงผลกลยุทธ์การตัดข้อความของเซลล์ในช่วง
// Get the text wrapping strategies for all cells in range B5:C6 const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B5:C6'); const strategies = range.getWrapStrategies(); for (let i = 0; i < strategies.length; i++) { for (let j = 0; j < strategies[i].length; j++) { Logger.log(strategies[i][j]); } }
รีเทิร์น
Wrap
— อาร์เรย์ 2 มิติของกลยุทธ์การตัดข้อความ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Wrap Strategy()
ส่งกลับกลยุทธ์การตัดข้อความของเซลล์ซ้ายบนสุดของช่วง
// Get the text wrapping strategy of cell B1. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B1:D4'); Logger.log(range.getWrapStrategy());
รีเทิร์น
Wrap
— กลยุทธ์การตัดข้อความของเซลล์ซ้ายบนสุดในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Wraps()
แสดงผลว่าข้อความในเซลล์มีการตัดหรือไม่ หากต้องการดูกลยุทธ์การรวมที่ละเอียดยิ่งขึ้น ให้ใช้ get
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getVerticalAlignments(); for (const i in results) { for (const j in results[i]) { const isWrapped = results[i][j]; if (isWrapped) { Logger.log('Cell [%s, %s] has wrapped text', i, j); } } }
รีเทิร์น
Boolean[][]
— อาร์เรย์ 2 มิติของการจัดแนวข้อความในแนวตั้งที่เชื่อมโยงกับเซลล์ในแถว
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Cells(shiftDimension)
แทรกเซลล์ว่างในช่วงนี้ เซลล์ใหม่จะเก็บการจัดรูปแบบที่มีอยู่ในเซลล์ที่เคยอยู่ในช่วงนี้ไว้ ระบบจะเลื่อนข้อมูลที่มีอยู่ในชีตตามมิติข้อมูลที่ระบุออกจากช่วงข้อมูลที่แทรก
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:D10'); range.insertCells(SpreadsheetApp.Dimension.COLUMNS);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
shift | Dimension | มิติข้อมูลที่จะใช้เลื่อนข้อมูลที่มีอยู่ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Checkboxes()
แทรกช่องทำเครื่องหมายลงในเซลล์แต่ละเซลล์ในช่วงที่กำหนดค่าด้วย true
สำหรับเลือก และ false
สำหรับไม่ได้เลือก ตั้งค่าของเซลล์ทั้งหมดในช่วงเป็น false
const range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'true' // for checked and 'false' for unchecked. Also, sets the value of each cell in // the range A1:B10 to 'false'. range.insertCheckboxes();
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Checkboxes(checkedValue)
แทรกช่องทำเครื่องหมายลงในเซลล์แต่ละเซลล์ในช่วงที่กำหนดค่าด้วยค่าที่กำหนดเองสำหรับช่องที่เลือก และสตริงว่างสำหรับช่องที่ไม่ได้เลือก ตั้งค่าของเซลล์แต่ละเซลล์ในช่วงเป็นสตริงว่าง
const range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' // for checked and the empty string for unchecked. Also, sets the value of each // cell in the range A1:B10 to // the empty string. range.insertCheckboxes('yes');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
checked | Object | ค่าที่เลือกสำหรับการตรวจสอบข้อมูลช่องทำเครื่องหมาย |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Checkboxes(checkedValue, uncheckedValue)
แทรกช่องทำเครื่องหมายลงในเซลล์แต่ละเซลล์ในช่วงที่กำหนดค่าด้วยค่าที่กำหนดเองสำหรับสถานะที่เลือกและไม่ได้เลือก ตั้งค่าของเซลล์แต่ละเซลล์ในช่วงเป็นค่าที่กำหนดเองซึ่งไม่ได้เลือก
const range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' // for checked and 'no' for unchecked. Also, sets the value of each cell in the // range A1:B10 to 'no'. range.insertCheckboxes('yes', 'no');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
checked | Object | ค่าที่เลือกสำหรับการตรวจสอบข้อมูลช่องทำเครื่องหมาย |
unchecked | Object | ค่าที่ยกเลิกการเลือกสำหรับการตรวจสอบความถูกต้องของข้อมูลช่องทำเครื่องหมาย |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
is Blank()
แสดงค่า true
หากช่วงว่างเปล่าทั้งหมด
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.isBlank());
รีเทิร์น
Boolean
— true
หากช่วงว่างเปล่า หรือ false
หากไม่ใช่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
is Checked()
แสดงผลว่าเซลล์ทั้งหมดในช่วงมีสถานะช่องทำเครื่องหมายเป็น "เลือกแล้ว" หรือไม่ แสดงผลเป็น null
หากเลือกเซลล์บางเซลล์ไว้และยกเลิกการเลือกเซลล์ที่เหลือ หรือหากเซลล์บางเซลล์ไม่มีช่องทำเครื่องหมายตรวจสอบข้อมูลที่ถูกต้อง
const range = SpreadsheetApp.getActive().getRange('A1:A3'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:A3. range.insertCheckboxes('yes', 'no'); const range1 = SpreadsheetApp.getActive().getRange('A1'); range1.setValue('yes'); // Sets the value of isRange1Checked as true as it contains the checked value. const isRange1Checked = range1.isChecked(); const range2 = SpreadsheetApp.getActive().getRange('A2'); range2.setValue('no'); // Sets the value of isRange2Checked as false as it contains the unchecked // value. const isRange2Checked = range2.isChecked(); const range3 = SpreadsheetApp.getActive().getRange('A3'); range3.setValue('random'); // Sets the value of isRange3Checked as null, as it contains an invalid checkbox // value. const isRange3Checked = range3.isChecked();
รีเทิร์น
Boolean
— true
หากเลือกเซลล์ทั้งหมดในแถบ false
หากยกเลิกการเลือกเซลล์ทั้งหมดในแถบ หรือ null
หากยกเลิกการเลือกเซลล์ใดเซลล์หนึ่งหรือไม่มีการตรวจสอบข้อมูลช่องทำเครื่องหมาย
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
is End Column Bounded()
กำหนดว่าปลายของช่วงเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่งหรือไม่ ตัวอย่างเช่น สำหรับช่วง A1:B10
หรือ B:B
ซึ่งเชื่อมโยงกับคอลัมน์ที่ท้ายช่วง เมธอดนี้จะแสดงผล true
สำหรับช่วง 3:7
หรือ A1:5
ซึ่งเชื่อมโยงกับแถวที่เฉพาะเจาะจงที่ท้ายช่วงเท่านั้น เมธอดนี้จะแสดงผล false
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the end of the range is bound to a particular column and logs // it to the console. console.log(range.isEndColumnBounded());
รีเทิร์น
Boolean
— true
หากช่วงสิ้นสุดเชื่อมโยงกับคอลัมน์หนึ่งๆ หรือ false
ในกรณีอื่นๆ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
is End Row Bounded()
กำหนดว่าช่วงสิ้นสุดเชื่อมโยงกับแถวใดแถวหนึ่งหรือไม่ ตัวอย่างเช่น สำหรับช่วง A1:B10
หรือ 3:7
ซึ่งเชื่อมโยงกับแถวที่ท้ายช่วง เมธอดนี้จะแสดงผล true
สำหรับช่วง B:B
หรือ A1:C
ซึ่งเชื่อมโยงกับคอลัมน์ที่เฉพาะเจาะจงที่ท้ายช่วงเท่านั้น เมธอดนี้จะแสดงผล false
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the end of the range is bound to a particular row and logs it // to the console. console.log(range.isEndRowBounded());
รีเทิร์น
Boolean
— true
หากช่วงสิ้นสุดเชื่อมโยงกับแถวใดแถวหนึ่ง false
มิเช่นนั้น
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
is Part Of Merge()
แสดงผล true
หากเซลล์ในช่วงปัจจุบันทับซ้อนกับเซลล์ที่ผสาน
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B3'); // True if any of the cells in A1:B3 is included in a merge. const isPartOfMerge = range.isPartOfMerge();
รีเทิร์น
Boolean
— true
หากช่วงซ้อนทับกับเซลล์ที่ผสานไว้ และแสดงผล false
ในกรณีอื่นๆ
is Start Column Bounded()
กำหนดว่าจุดเริ่มต้นของช่วงเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่งหรือไม่ เช่น สำหรับช่วง A1:B10
หรือ B:B
ซึ่งเชื่อมโยงกับคอลัมน์ที่จุดเริ่มต้นของช่วง วิธีการนี้จะแสดงผล true
สำหรับช่วง 3:7
ซึ่งเชื่อมโยงกับแถวที่จุดเริ่มต้นของช่วงเท่านั้น วิธีการนี้จะแสดงผล false
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the start of the range is bound to a particular column and logs // it to the console. console.log(range.isStartColumnBounded());
รีเทิร์น
Boolean
— true
หากการเริ่มต้นของช่วงเชื่อมโยงกับคอลัมน์หนึ่งๆ false
ไม่เช่นนั้น
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
is Start Row Bounded()
กำหนดว่าจุดเริ่มต้นของช่วงเชื่อมโยงกับแถวใดแถวหนึ่งหรือไม่ เช่น สำหรับช่วง A1:B10
หรือ 3:7
ซึ่งเชื่อมโยงกับแถวที่จุดเริ่มต้นของช่วง วิธีการนี้จะแสดงผล true
สำหรับช่วง B:B
ซึ่งเชื่อมโยงกับคอลัมน์หนึ่งๆ ที่จุดเริ่มต้นของช่วงเท่านั้น วิธีการนี้จะแสดงผล false
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the start of the range is bound to a particular row and logs it // to the console. console.log(range.isStartRowBounded());
รีเทิร์น
Boolean
— true
หากช่วงเริ่มต้นเชื่อมโยงกับแถวที่เจาะจง หรือ false
หากไม่ใช่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
merge()
ผสานเซลล์ในช่วงที่เลือกเข้าด้วยกันเป็นบล็อกเดียว
const 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
merge Across()
ผสานเซลล์ในช่วงต่างๆ ของคอลัมน์ของช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The code below merges cells C5:E5 into one cell const range1 = sheet.getRange('C5:E5'); range1.mergeAcross(); // The code below creates 2 horizontal cells, F5:H5 and F6:H6 const range2 = sheet.getRange('F5:H6'); range2.mergeAcross();
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
merge Vertically()
ผสานเซลล์ในช่วงเข้าด้วยกัน
const sheet = SpreadsheetApp.getActiveSheet(); // The code below vertically merges the cells in A1 to A10 sheet.getRange('A1:A10').mergeVertically(); // The code below creates 3 merged columns: B1 to B10, C1 to C10, and D1 to D10 sheet.getRange('B1:D10').mergeVertically();
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
move To(target)
ตัดและวาง (ทั้งรูปแบบและค่า) จากช่วงนี้ไปยังช่วงเป้าหมาย
// The code below moves the first 5 columns over to the 6th column const sheet = SpreadsheetApp.getActiveSheet(); sheet.getRange('A1:E').moveTo(sheet.getRange('F1'));
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
target | Range | ช่วงเป้าหมายที่จะคัดลอกช่วงนี้ไป เฉพาะตำแหน่งเซลล์ซ้ายบนเท่านั้นที่เกี่ยวข้อง |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
offset(rowOffset, columnOffset)
แสดงผลช่วงใหม่ที่เลื่อนจากช่วงนี้ตามจำนวนแถวและคอลัมน์ที่ระบุ (ซึ่งอาจเป็นค่าลบได้) ช่วงใหม่จะมีขนาดเท่ากับช่วงเดิม
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('A1'); // newCell references B2 const newCell = cell.offset(1, 1);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
row | Integer | จำนวนแถวที่เลื่อนลงจากเซลล์ซ้ายบนของช่วง ค่าลบแสดงถึงแถวที่เลื่อนขึ้นจากเซลล์ซ้ายบนของช่วง |
column | Integer | จำนวนคอลัมน์ทางด้านขวาจากเซลล์ซ้ายบนของช่วง ค่าลบแสดงถึงคอลัมน์ทางด้านซ้ายจากเซลล์ซ้ายบนของช่วง |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
offset(rowOffset, columnOffset, numRows)
แสดงผลช่วงใหม่ที่สัมพันธ์กับช่วงปัจจุบัน ซึ่งจุดด้านซ้ายบนมีการเลื่อนจากช่วงปัจจุบันตามแถวและคอลัมน์ที่ระบุ และมีเซลล์ที่มีความสูงที่ระบุ
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('A1'); // newCell references B2:B3 const newRange = cell.offset(1, 1, 2);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
row | Integer | จำนวนแถวที่เลื่อนลงจากเซลล์ซ้ายบนของช่วง ค่าลบแสดงถึงแถวที่เลื่อนขึ้นจากเซลล์ซ้ายบนของช่วง |
column | Integer | จำนวนคอลัมน์ทางด้านขวาจากเซลล์ซ้ายบนของช่วง ค่าลบแสดงถึงคอลัมน์ทางด้านซ้ายจากเซลล์ซ้ายบนของช่วง |
num | Integer | ความสูงเป็นแถวของช่วงใหม่ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
offset(rowOffset, columnOffset, numRows, numColumns)
แสดงผลช่วงใหม่ที่สัมพันธ์กับช่วงปัจจุบัน ซึ่งจุดด้านซ้ายบนของออฟเซ็ตจากช่วงปัจจุบันตามแถวและคอลัมน์ที่ระบุ รวมถึงมีความสูงและความกว้างที่ระบุในเซลล์
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('A1'); // newCell references B2:C3 const newRange = cell.offset(1, 1, 2, 2);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
row | Integer | จำนวนแถวที่เลื่อนลงจากเซลล์ซ้ายบนของช่วง ค่าลบแสดงถึงแถวที่เลื่อนขึ้นจากเซลล์ซ้ายบนของช่วง |
column | Integer | จำนวนคอลัมน์ทางด้านขวาจากเซลล์ซ้ายบนของช่วง ค่าลบแสดงถึงคอลัมน์ทางด้านซ้ายจากเซลล์ซ้ายบนของช่วง |
num | Integer | ความสูงเป็นแถวของช่วงใหม่ |
num | Integer | ความกว้างของคอลัมน์ของช่วงใหม่ |
รีเทิร์น
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. const ss = SpreadsheetApp.getActive(); const range = ss.getRange('A1:B10'); const protection = range.protect().setDescription('Sample protected range'); // Ensure the current user is an editor before removing others. Otherwise, if // the user's edit permission comes from a group, the script throws an exception // upon removing the group. const me = Session.getEffectiveUser(); protection.addEditor(me); protection.removeEditors(protection.getEditors()); if (protection.canDomainEdit()) { protection.setDomainEdit(false); }
รีเทิร์น
Protection
— ออบเจ็กต์ที่แสดงการตั้งค่าการป้องกัน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
randomize()
สุ่มลําดับแถวในช่วงที่ระบุ
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const 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
remove Checkboxes()
นำช่องทำเครื่องหมายทั้งหมดออกจากช่วง ล้างการตรวจสอบข้อมูลของเซลล์แต่ละเซลล์ และล้างค่าของเซลล์ด้วยหากเซลล์มีค่าที่เลือกหรือไม่ได้เลือกไว้
const range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:B10. range.insertCheckboxes('yes', 'no'); const range1 = SpreadsheetApp.getActive().getRange('A1'); range1.setValue('yes'); // Removes the checkbox data validation in cell A1 and clears its value. range1.removeCheckboxes(); const range2 = SpreadsheetApp.getActive().getRange('A2'); range2.setValue('random'); // Removes the checkbox data validation in cell A2 but does not clear its value. range2.removeCheckboxes();
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove Duplicates()
นําแถวภายในช่วงนี้ซึ่งมีค่าที่ซ้ำกับค่าในแถวก่อนหน้าออก แถวที่มีค่าเหมือนกันแต่มีตัวอักษรพิมพ์เล็กพิมพ์ใหญ่ การจัดรูปแบบ หรือสูตรต่างกันจะถือว่าเป็นรายการที่ซ้ำกัน นอกจากนี้ วิธีนี้ยังนำแถวที่ซ้ำกันซึ่งซ่อนอยู่ (เช่น เนื่องจากตัวกรอง) ออกด้วย ระบบจะไม่นำเนื้อหาที่อยู่นอกช่วงนี้ออก
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const 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
remove Duplicates(columnsToCompare)
นําแถวภายในช่วงนี้ที่มีค่าในคอลัมน์ที่ระบุซึ่งซ้ำกันของค่าแถวก่อนหน้าออก แถวที่มีค่าเหมือนกันแต่มีตัวอักษรพิมพ์เล็กพิมพ์ใหญ่ การจัดรูปแบบ หรือสูตรต่างกันจะถือว่าเป็นรายการที่ซ้ำกัน นอกจากนี้ วิธีนี้ยังนำแถวที่ซ้ำกันซึ่งซ่อนอยู่ออกจากมุมมองด้วย (เช่น เนื่องจากตัวกรอง) ระบบจะไม่นำเนื้อหาที่อยู่นอกช่วงนี้ออก
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B1:D7'); // Remove rows which have duplicate values in column B. range.removeDuplicates([2]); // Remove rows which have duplicate values in both columns B and D. range.removeDuplicates([2, 4]);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
columns | Integer[] | คอลัมน์ที่จะวิเคราะห์หาค่าที่ซ้ำกัน หากไม่ได้ระบุคอลัมน์ ระบบจะวิเคราะห์คอลัมน์ทั้งหมดเพื่อหารายการที่ซ้ำกัน |
รีเทิร์น
Range
— ช่วงผลลัพธ์หลังจากนํารายการที่ซ้ำกันออก ขนาดของช่วงจะลดลง 1 แถวสําหรับทุกแถวที่นําออก
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Background(color)
ตั้งค่าสีพื้นหลังของเซลล์ทั้งหมดในช่วงในรูปแบบการเขียน CSS (เช่น '#ffffff'
หรือ 'white'
)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D5'); range.setBackground('red');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | String | รหัสสีในเครื่องหมาย CSS (เช่น '#ffffff' หรือ 'white' ) ค่า null จะรีเซ็ตสี |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Background Object(color)
ตั้งค่าสีพื้นหลังของเซลล์ทั้งหมดในช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const bgColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); const range = sheet.getRange('B2:D5'); range.setBackgroundObject(bgColor);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | Color | สีพื้นหลังที่จะตั้งค่า ค่า null จะรีเซ็ตสีพื้นหลัง |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Background Objects(color)
กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของสีพื้นหลัง (ต้องตรงกับมิติข้อมูลของช่วงนี้)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const colorAccent1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); const colorAccent2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); const colorAccent3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); const colorAccent4 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4) .build(); const colors = [ [colorAccent1, colorAccent2], [colorAccent3, colorAccent4], ]; const cell = sheet.getRange('B5:C6'); cell.setBackgroundObjects(colors);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | Color[][] | อาร์เรย์ 2 มิติของสี ค่า null จะรีเซ็ตสี |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Background RGB(red, green, blue)
ตั้งค่าพื้นหลังเป็นสีที่ระบุโดยใช้ค่า RGB (จำนวนเต็มระหว่าง 0 ถึง 255)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); // Sets the background to white cell.setBackgroundRGB(255, 255, 255); // Sets the background to red cell.setBackgroundRGB(255, 0, 0);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
red | Integer | ค่าสีแดงในรูปแบบ RGB |
green | Integer | ค่าสีเขียวในรูปแบบ RGB |
blue | Integer | ค่าสีน้ำเงินในรูปแบบ RGB |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Backgrounds(color)
กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของสีพื้นหลัง (ต้องตรงกับมิติข้อมูลของช่วงนี้) สีจะอยู่ในรูปแบบการเขียน CSS (เช่น '#ffffff'
หรือ 'white'
)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const colors = [ ['red', 'white', 'blue'], ['#FF0000', '#FFFFFF', '#0000FF'], // These are the hex equivalents ]; const cell = sheet.getRange('B5:D6'); cell.setBackgrounds(colors);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | String[][] | อาร์เรย์ 2 มิติของสีในเครื่องหมาย CSS (เช่น '#ffffff' หรือ
'white' ) ค่า null จะรีเซ็ตสี |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Border(top, left, bottom, right, vertical, horizontal)
ตั้งค่าพร็อพเพอร์ตี้เส้นขอบ ค่าที่ใช้ได้คือ true
(เปิด) false
(ปิด) และ null
(ไม่มีการเปลี่ยนแปลง)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); // Sets borders on the top and bottom, but leaves the left and right unchanged cell.setBorder(true, null, true, null, false, false);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
top | Boolean | true สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง |
left | Boolean | true สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง |
bottom | Boolean | true สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง |
right | Boolean | true สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง |
vertical | Boolean | true สำหรับเส้นขอบแนวตั้งภายใน false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง |
horizontal | Boolean | true สำหรับเส้นขอบแนวนอนภายใน false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Border(top, left, bottom, right, vertical, horizontal, color, style)
ตั้งค่าพร็อพเพอร์ตี้เส้นขอบด้วยสีและ/หรือสไตล์ ค่าที่ใช้ได้คือ true
(เปิด) false
(ปิด) และ null
(ไม่มีการเปลี่ยนแปลง) สำหรับสี ให้ใช้การเขียนสีใน CSS (เช่น '#ffffff'
หรือ 'white'
)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); // Sets borders on the top and bottom, but leaves the left and right unchanged // Also sets the color to "red", and the border to "DASHED". cell.setBorder( true, null, true, null, false, false, 'red', SpreadsheetApp.BorderStyle.DASHED, );
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
top | Boolean | true สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง |
left | Boolean | true สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง |
bottom | Boolean | true สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง |
right | Boolean | true สำหรับเส้นขอบ false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง |
vertical | Boolean | true สำหรับเส้นขอบแนวตั้งภายใน false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง |
horizontal | Boolean | true สำหรับเส้นขอบแนวนอนภายใน false สำหรับไม่มี null สำหรับไม่มีการเปลี่ยนแปลง |
color | String | สีในรูปแบบการเขียน CSS (เช่น '#ffffff' หรือ 'white' ) null สำหรับสีเริ่มต้น (สีดํา) |
style | Border | รูปแบบของเส้นขอบ null สำหรับรูปแบบเริ่มต้น (ทึบ) |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Data Validation(rule)
ตั้งค่ากฎการตรวจสอบข้อมูล 1 รายการสำหรับเซลล์ทั้งหมดในช่วง
// Set the data validation rule for cell A1 to require a value from B1:B10. const cell = SpreadsheetApp.getActive().getRange('A1'); const range = SpreadsheetApp.getActive().getRange('B1:B10'); const rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
rule | Data | กฎการตรวจสอบข้อมูลที่จะใช้ หรือ null เพื่อนำการตรวจสอบข้อมูลออก |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Data Validations(rules)
ตั้งค่ากฎการตรวจสอบข้อมูลสำหรับเซลล์ทั้งหมดในช่วง เมธอดนี้ใช้อาร์เรย์การตรวจสอบข้อมูล 2 มิติ ซึ่งจัดทําดัชนีตามแถวแล้วตามคอลัมน์ ขนาดอาร์เรย์ต้องสอดคล้องกับขนาดช่วง
// Set the data validation rules for Sheet1!A1:B5 to require a value from // Sheet2!A1:A10. const destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5'); const sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10'); const rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build(); const rules = destinationRange.getDataValidations(); for (let i = 0; i < rules.length; i++) { for (let j = 0; j < rules[i].length; j++) { rules[i][j] = rule; } } destinationRange.setDataValidations(rules);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
rules | Data | อาร์เรย์ 2 มิติของกฎการตรวจสอบข้อมูลที่จะตั้งค่า ค่า null จะนําการตรวจสอบข้อมูลออก |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Color(color)
กำหนดสีแบบอักษรในเครื่องหมายนิพจน์ CSS (เช่น '#ffffff'
หรือ 'white'
)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setFontColor('red');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | String | สีแบบอักษรในเครื่องหมาย CSS (เช่น '#ffffff' หรือ 'white' ) ค่า null จะรีเซ็ตสี |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Color Object(color)
กำหนดสีแบบอักษรของช่วงที่กำหนด
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); const cell = sheet.getRange('B2'); cell.setFontColor(color);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | Color | สีแบบอักษรที่จะตั้งค่า ค่า null จะรีเซ็ตสี |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Color Objects(colors)
ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของสีแบบอักษร (ต้องตรงกับมิติข้อมูลของช่วงนี้)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const colorAccent1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); const colorAccent2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); const colorAccent3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); const colorAccent4 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4) .build(); const colors = [ [colorAccent1, colorAccent2], [colorAccent3, colorAccent4], ]; const cell = sheet.getRange('B5:C6'); cell.setFontColorObjects(colors);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
colors | Color[][] | อาร์เรย์ 2 มิติของสี ค่า null จะรีเซ็ตสีแบบอักษร |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Colors(colors)
ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของสีแบบอักษร (ต้องตรงกับมิติข้อมูลของช่วงนี้) สีอยู่ในรูปแบบการเขียน CSS (เช่น '#ffffff'
หรือ 'white'
)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const colors = [ ['red', 'white', 'blue'], ['#FF0000', '#FFFFFF', '#0000FF'], // These are the hex equivalents ]; const cell = sheet.getRange('B5:D6'); cell.setFontColors(colors);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
colors | Object[][] | อาร์เรย์ 2 มิติของสีในเครื่องหมาย CSS (เช่น '#ffffff' หรือ
'white' ) ค่า null จะรีเซ็ตสี |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Families(fontFamilies)
ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของชุดแบบอักษร (ต้องตรงกับขนาดของช่วงนี้) ตัวอย่างแบบอักษร ได้แก่ "Arial" หรือ "Helvetica"
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const fonts = [ ['Arial', 'Helvetica', 'Verdana'], ['Courier New', 'Arial', 'Helvetica'], ]; const cell = sheet.getRange('B2:D3'); cell.setFontFamilies(fonts);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
font | Object[][] | อาร์เรย์ 2 มิติของชุดแบบอักษร ค่า null จะรีเซ็ตชุดแบบอักษร |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Family(fontFamily)
ตั้งค่าชุดแบบอักษร เช่น "Arial" หรือ "Helvetica"
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setFontFamily('Helvetica');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
font | String | ชุดแบบอักษรที่จะตั้งค่า ค่า null จะรีเซ็ตชุดแบบอักษร |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Line(fontLine)
ตั้งค่ารูปแบบเส้นของแบบอักษรของช่วงที่กำหนด ('underline'
, 'line-through'
หรือ
'none'
)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setFontLine('line-through');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
font | String | รูปแบบบรรทัดแบบอักษร 'underline' , 'line-through' หรือ 'none' ค่า null จะรีเซ็ตรูปแบบบรรทัดแบบอักษร |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Lines(fontLines)
กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของรูปแบบเส้น (ต้องตรงกับมิติข้อมูลของช่วงนี้)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const fontLines = [['underline', 'line-through', 'none']]; const range = sheet.getRange('B2:D2'); range.setFontLines(fontLines);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
font | Object[][] | อาร์เรย์ 2 มิติของรูปแบบเส้นแบบอักษร ('underline' , 'line-through' หรือ 'none' ) ค่า null จะรีเซ็ตรูปแบบเส้นแบบอักษร |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Size(size)
กำหนดขนาดแบบอักษร โดยขนาดจะเป็นขนาดจุดที่จะใช้
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setFontSize(20);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
size | Integer | ขนาดแบบอักษรเป็นจุด |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Sizes(sizes)
กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของขนาดแบบอักษร (ต้องตรงกับมิติข้อมูลของช่วงนี้) ขนาดจะแสดงเป็นจุด
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const fontSizes = [[16, 20, 24]]; const range = sheet.getRange('B2:D2'); range.setFontSizes(fontSizes);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
sizes | Object[][] | อาร์เรย์ขนาด 2 มิติ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Style(fontStyle)
กำหนดรูปแบบแบบอักษรสำหรับช่วงที่กำหนด ('italic'
หรือ 'normal'
)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setFontStyle('italic');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
font | String | รูปแบบแบบอักษร 'italic' หรือ 'normal' ค่า null จะรีเซ็ตรูปแบบแบบอักษร |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Styles(fontStyles)
กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของรูปแบบแบบอักษร (ต้องตรงกับขนาดของช่วงนี้)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const fontStyles = [['italic', 'normal']]; const range = sheet.getRange('B2:C2'); range.setFontStyles(fontStyles);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
font | Object[][] | อาร์เรย์ 2 มิติของรูปแบบแบบอักษร 'italic' หรือ 'normal' ค่า null จะรีเซ็ตรูปแบบแบบอักษร |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Weight(fontWeight)
กำหนดน้ำหนักแบบอักษรสำหรับช่วงที่กำหนด (ปกติ/หนา)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setFontWeight('bold');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
font | String | น้ำหนักแบบอักษร 'bold' หรือ 'normal' ค่า null จะรีเซ็ตน้ำหนักแบบอักษร |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Weights(fontWeights)
กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของน้ำหนักแบบอักษร (ต้องตรงกับขนาดของช่วงนี้) ตัวอย่างความหนาของแบบอักษรคือ "หนา"
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const fontStyles = [['bold', 'bold', 'normal']]; const range = sheet.getRange('B2:D2'); range.setFontWeights(fontStyles);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
font | Object[][] | อาร์เรย์ 2 มิติของน้ำหนักแบบอักษร 'bold' หรือ 'normal' ค่า null จะรีเซ็ตน้ำหนักแบบอักษร |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Formula(formula)
อัปเดตสูตรสําหรับช่วงนี้ สูตรที่ระบุต้องอยู่ในรูปแบบ A1
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B5'); cell.setFormula('=SUM(B3:B4)');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
formula | String | สตริงที่แสดงสูตรที่จะตั้งค่าสําหรับเซลล์ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Formula R1C1(formula)
อัปเดตสูตรสําหรับช่วงนี้ สูตรที่ระบุต้องอยู่ในรูปแบบ R1C1
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B5'); // This sets the formula to be the sum of the 3 rows above B5 cell.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
formula | String | สูตรสตริง |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Formulas(formulas)
ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของสูตร (ต้องตรงกับมิติข้อมูลของช่วงนี้) สูตรที่ระบุต้องอยู่ในรูปแบบ A1 เมธอดนี้จะรับอาร์เรย์สูตร 2 มิติ โดยจัดทําดัชนีตามแถว แล้วตามด้วยคอลัมน์ ขนาดอาร์เรย์ต้องสอดคล้องกับขนาดช่วง
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This sets the formulas to be a row of sums, followed by a row of averages // right below. The size of the two-dimensional array must match the size of the // range. const formulas = [ ['=SUM(B2:B4)', '=SUM(C2:C4)', '=SUM(D2:D4)'], ['=AVERAGE(B2:B4)', '=AVERAGE(C2:C4)', '=AVERAGE(D2:D4)'], ]; const cell = sheet.getRange('B5:D6'); cell.setFormulas(formulas);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
formulas | String[][] | อาร์เรย์สตริง 2 มิติของสูตร |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Formulas R1C1(formulas)
ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของสูตร (ต้องตรงกับมิติข้อมูลของช่วงนี้) สูตรที่ระบุต้องอยู่ในรูปแบบ R1C1
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This creates formulas for a row of sums, followed by a row of averages. const sumOfRowsAbove = '=SUM(R[-3]C[0]:R[-1]C[0])'; const averageOfRowsAbove = '=AVERAGE(R[-4]C[0]:R[-2]C[0])'; // The size of the two-dimensional array must match the size of the range. const formulas = [ [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove], [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove], ]; const cell = sheet.getRange('B5:D6'); // This sets the formula to be the sum of the 3 rows above B5. cell.setFormulasR1C1(formulas);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
formulas | String[][] | อาร์เรย์สูตร 2 มิติในรูปแบบ R1C1 |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Horizontal Alignment(alignment)
ตั้งค่าการจัดแนวนอน (ซ้ายไปขวา) สำหรับช่วงที่กำหนด (ซ้าย/กลาง/ขวา)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setHorizontalAlignment('center');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
alignment | String | การจัดแนว ซึ่งอาจเป็น 'left' , 'center' หรือ 'normal' ค่า null จะรีเซ็ตการจัดแนว |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Horizontal Alignments(alignments)
ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของการจัดแนวนอน ดู set
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const horizontalAlignments = [['left', 'right', 'center']]; const range = sheet.getRange('B2:D2'); range.setHorizontalAlignments(horizontalAlignments);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
alignments | Object[][] | อาร์เรย์ 2 มิติของการจัดแนว ซึ่งอาจเป็น 'left' , 'center' หรือ 'normal' ค่า null จะรีเซ็ตการจัดแนว |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
ดูเพิ่มเติม
set Note(note)
ตั้งค่าหมายเหตุเป็นค่าที่ระบุ
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setNote('This is a note');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
note | String | ค่าหมายเหตุที่จะตั้งค่าสำหรับช่วง ค่า null จะนําหมายเหตุออก |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Notes(notes)
ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของโน้ต (ต้องตรงกับขนาดของช่วงนี้)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const notes = [ ['it goes', 'like this', 'the fourth, the fifth'], ['the minor fall', 'and the', 'major lift'], ]; const cell = sheet.getRange('B2:D3'); cell.setNotes(notes);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
notes | Object[][] | อาร์เรย์ 2 มิติของโน้ต ค่า null จะนําโน้ตออก |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
ดูเพิ่มเติม
set Number Format(numberFormat)
กำหนดรูปแบบตัวเลขหรือวันที่เป็นสตริงการจัดรูปแบบที่ระบุ รูปแบบที่ยอมรับจะอธิบายไว้ในเอกสารประกอบของ Sheets API
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); // Always show 3 decimal points cell.setNumberFormat('0.000');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
number | String | สตริงรูปแบบตัวเลข |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Number Formats(numberFormats)
กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของรูปแบบตัวเลขหรือวันที่ (ต้องตรงกับมิติข้อมูลของช่วงนี้) ค่าคือสตริงรูปแบบตามที่อธิบายไว้ใน เอกสารประกอบของ Sheets API
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const formats = [['0.000', '0,000,000', '$0.00']]; const range = sheet.getRange('B2:D2'); range.setNumberFormats(formats);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
number | Object[][] | อาร์เรย์ 2 มิติของรูปแบบตัวเลข |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Rich Text Value(value)
กำหนดค่าข้อความที่มีรูปแบบสำหรับเซลล์ในช่วง
// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello" // bolded. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B2:D4'); const bold = SpreadsheetApp.newTextStyle().setBold(true).build(); const richText = SpreadsheetApp.newRichTextValue() .setText('Hello world') .setTextStyle(0, 5, bold) .build(); range.setRichTextValue(richText);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
value | Rich | ค่าข้อความที่มีรูปแบบที่ต้องการ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Rich Text Values(values)
กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของค่าข้อความที่มีรูปแบบ
// Sets the cells in range A1:A2 to have Rich Text values. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:A2'); const bold = SpreadsheetApp.newTextStyle().setBold(true).build(); const italic = SpreadsheetApp.newTextStyle().setItalic(true).build(); const richTextA1 = SpreadsheetApp.newRichTextValue() .setText('This cell is bold') .setTextStyle(bold) .build(); const richTextA2 = SpreadsheetApp.newRichTextValue() .setText('bold words, italic words') .setTextStyle(0, 11, bold) .setTextStyle(12, 24, italic) .build(); range.setRichTextValues([[richTextA1], [richTextA2]]);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
values | Rich | ค่า Rich Text ที่ต้องการ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Show Hyperlink(showHyperlink)
ตั้งค่าว่าช่วงควรแสดงไฮเปอร์ลิงก์หรือไม่
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A30 and sets its hyperlink value. const range = sheet.getRange('A30'); range.setValue('https://www.example.com'); // Sets cell A30 to show hyperlinks. range.setShowHyperlink(true);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
show | Boolean | แสดงไฮเปอร์ลิงก์หรือไม่ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Text Direction(direction)
ตั้งค่าทิศทางข้อความสำหรับเซลล์ในช่วง หากทิศทางที่ระบุคือ null
ระบบจะอนุมานทิศทางแล้วตั้งค่า
// Sets right-to-left text direction for the range. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B5:C6'); range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
direction | Text | ทิศทางข้อความที่ต้องการ หากเป็น null ระบบจะอนุมานทิศทางก่อนการตั้งค่า |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Text Directions(directions)
ตั้งค่าตารางสี่เหลี่ยมผืนผ้าของทิศทางข้อความ หากทิศทางที่ระบุคือ null
ระบบจะอนุมานทิศทางแล้วตั้งค่า
// Copies all of the text directions from range A1:B2 over to range C5:D6. const sheet = SpreadsheetApp.getActiveSheet(); const range1 = sheet.getRange('A1:B2'); const range2 = sheet.getRange('C5:D6'); range2.setTextRotations(range1.getTextDirections());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
directions | Text | ทิศทางข้อความที่ต้องการ หากทิศทางที่ระบุคือ null ระบบจะอนุมานก่อนตั้งค่า |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Text Rotation(degrees)
ตั้งค่าการหมุนข้อความสำหรับเซลล์ในช่วง อินพุตจะสอดคล้องกับมุมระหว่างการวางแนวข้อความมาตรฐานกับการวางแนวที่ต้องการ การป้อนค่า 0 บ่งชี้ว่าข้อความได้รับการตั้งค่าให้อยู่ในแนวนอนมาตรฐาน
สำหรับทิศทางข้อความจากซ้ายไปขวา มุมบวกจะเป็นไปในทิศทางทวนเข็มนาฬิกา ส่วนมุมลบจะเป็นไปในทิศทางตามเข็มนาฬิกา
// Sets all cell's in range B2:D4 to have text rotated up 45 degrees. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B2:D4'); range.setTextRotation(45);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
degrees | Integer | มุมที่ต้องการระหว่างการวางแนวมาตรฐานกับการวางแนวที่ต้องการ สำหรับข้อความแบบซ้ายไปขวา มุมบวกจะอยู่ในทิศทางทวนเข็มนาฬิกา |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Text Rotation(rotation)
ตั้งค่าการหมุนข้อความสำหรับเซลล์ในช่วง
// Sets all cell's in range B2:D4 to have the same text rotation settings as // cell A1. const sheet = SpreadsheetApp.getActiveSheet(); const rotation = sheet.getRange('A1').getTextRotation(); sheet.getRange('B2:D4').setTextRotation(rotation);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
rotation | Text | การตั้งค่าการหมุนข้อความที่ต้องการ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Text Rotations(rotations)
ตั้งค่าตารางสี่เหลี่ยมผืนผ้าของการหมุนข้อความ
// Copies all of the text rotations from range A1:B2 over to range C5:D6. const sheet = SpreadsheetApp.getActiveSheet(); const range1 = sheet.getRange('A1:B2'); const range2 = sheet.getRange('C5:D6'); range2.setTextRotations(range1.getTextRotations());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
rotations | Text | การตั้งค่าการหมุนข้อความที่ต้องการ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Text Style(style)
กำหนดรูปแบบข้อความสำหรับเซลล์ในช่วงที่เลือก
// Sets the cells in range C5:D6 to have underlined size 15 font. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('C5:D6'); const style = SpreadsheetApp.newTextStyle().setFontSize(15).setUnderline(true).build(); range.setTextStyle(style);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
style | Text | รูปแบบข้อความที่ต้องการ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Text Styles(styles)
ตั้งค่าตารางสี่เหลี่ยมผืนผ้าของรูปแบบข้อความ
// Sets text styles for cells in range A1:B2 const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B2'); const bold = SpreadsheetApp.newTextStyle().setBold(true).build(); const otherStyle = SpreadsheetApp.newTextStyle() .setBold(true) .setUnderline(true) .setItalic(true) .setForegroundColor('#335522') .setFontSize(44) .build(); range.setTextStyles([ [bold, otherStyle], [otherStyle, bold], ]);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
styles | Text | รูปแบบข้อความที่ต้องการ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Value(value)
ตั้งค่าของช่วง ค่าอาจเป็นตัวเลข สตริง บูลีน หรือวันที่ หากเริ่มต้นด้วย '='
ระบบจะตีความว่าเป็นสูตร
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setValue(100);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
value | Object | ค่าของช่วง |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Values(values)
ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของค่า (ต้องตรงกับมิติข้อมูลของช่วงนี้) หากค่าขึ้นต้นด้วย =
ระบบจะตีความค่านั้นเป็นสูตร
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const values = [['2.000', '1,000,000', '$2.99']]; const range = sheet.getRange('B2:D2'); range.setValues(values);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
values | Object[][] | อาร์เรย์ค่า 2 มิติ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Vertical Alignment(alignment)
ตั้งค่าการจัดแนวแนวตั้ง (จากบนลงล่าง) สำหรับช่วงที่กำหนด (บน/กลาง/ล่าง)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setVerticalAlignment('middle');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
alignment | String | การจัดแนว ซึ่งอาจเป็น 'top' , 'middle' หรือ 'bottom' ค่า null จะรีเซ็ตการจัดแนว |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Vertical Alignments(alignments)
กำหนดตารางกริดสี่เหลี่ยมผืนผ้าของการจัดแนวแนวตั้ง (ต้องตรงกับขนาดของช่วงนี้)
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const alignments = [['top', 'middle', 'bottom']]; const range = sheet.getRange('B2:D2'); range.setVerticalAlignments(alignments);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
alignments | Object[][] | อาร์เรย์ 2 มิติของการจัดแนว ซึ่งอาจเป็น 'top' , 'middle' หรือ 'bottom' ค่า null จะรีเซ็ตการจัดแนว |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
ดูเพิ่มเติม
set Vertical Text(isVertical)
ตั้งค่าว่าจะซ้อนข้อความของเซลล์ในช่วงที่เลือกหรือไม่ หากข้อความซ้อนกันอยู่แนวตั้ง ระบบจะไม่สนใจการตั้งค่าองศาการหมุนข้อความ
// Sets all cell's in range B2:D4 to have vertically stacked text. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B2:D4'); range.setVerticalText(true);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
is | Boolean | เลือกว่าจะซ้อนข้อความหรือไม่ |
รีเทิร์น
Range
— ช่วงนี้สําหรับการต่อเชื่อม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-