GASでスプレッドシートのシート名を変更するには「setName(name)
」を利用する。
setName(name)
シート名を設定します。
https://developers.google.com/apps-script/reference/spreadsheet/sheet?hl=en#setnamename
スプレッドシートのシート名を変更するGAS実行の様子
setName(name)メソッドを利用して、スプレッドシートのシート名を変更するGASを実行してみました。
- inputBoxへ任意のシート名を入力
- setNameでアクティブシートの名前を変更
といった様子をGIFにしました。
参照記事:【GAS】スプレッドシートのアクティブシートを複製してアクティブシートにする
スプレッドシートのシート名を変更するGAS
function rename(){
//SpreadsheetAppを起動
var ss = SpreadsheetApp.getActiveSpreadsheet();
//0番目のシートを取得
var sht = ss.getSheets()[0];
//shtのシート名を取得
var shtnm = ss.getSheetName();
//YESNOを確認
var yesno = Browser.msgBox("シート"+shtnm+"を変更しますか?",Browser.Buttons.YES_NO_CANCEL);
//ーーーーー条件分岐ーーーーー
//YESだったら
if(yesno == "yes"){
//inputBoxでrenameするテキストを取得
var rename = Browser.inputBox("変更するシート名を入力してください");
//■setNameでshtのシート名を変更
sht.setName(rename);
//変更したシート名の内容をメッセージで掲載
Browser.msgBox("0番目のシート名を「"+shtnm+"」から「"+rename+"」へ変更しました!");
} else {
//変更しなかった場合のメッセージを掲載
Browser.msgBox("名前の変更はしませんでした");
}
//ーーーーーここまでーーーーー
}
setName(name)のパラメーター
名前 | タイプ | 説明 |
---|---|---|
name | String | シートの新しい名前。 |
setName(name)の戻り値
Sheet—このシート、連鎖用。
スプレッドシートのシート名を変更するまとめ
GAS×スプレッドシートのシート名を変更するならsetName(name)
メソッドを利用しましょう。
setNameなので扱いやすいメソッドと言えるでしょう。
関連記事:【GAS】スプレッドシートをコピーして新規シートを作成する
関連記事:【GAS】スプレッドシートで指定した名前で新規シートを作成する
関連記事:【GAS】スプレッドシートのアクティブシートを削除する
関連記事:【GAS】スプレッドシートで現在アクティブなシートを返す
関連記事:【GAS】スプレッドシートで名前・行・列数を指定して新規シートする
関連記事:【GAS】スプレッドシートのアクティブシートの名前を取得する