GASスプレッドシート書式設定一覧｜背景色・罫線・列幅

GAS（Google Apps Script）でスプレッドシートの見た目を整えるには、範囲（Range）とシート（Sheet）の書式メソッドを使います。 背景色は setBackground、罫線は setBorder、列幅は setColumnWidth や autoResizeColumns というように、やりたいことごとにメソッドが決まっています。

この記事では、見出し行の装飾・固定・罫線・列幅の調整を1関数で済ませるコードを最初に示し、そのあとに書式メソッドを「やりたいこと→メソッド→引数の例」の逆引き表にまとめます。値の読み書きや画面操作での設定は扱わず、スクリプトからの見た目の設定だけに絞っています。

確認環境：メソッド名・引数・指定できる値は、Google 公式の Apps Script リファレンス（Class Range／Class Sheet／ConditionalFormatRuleBuilder／Enum BorderStyle）と Google Sheets API の「Number format patterns」を 2026-10-06 に開いて確認し、型定義パッケージ @types/google-apps-script 2.0.13 と照合しました。コードは Node.js 22.22.2 で構文を確かめ、シートをまねた簡易モックの上で動かして、どの範囲にどのメソッドがどの引数で呼ばれるかを記録しています。記事中の「モックでの呼び出し記録」はその出力で、画面上の見た目そのものを写したものではありません。

この記事の結論

• 表を整える定番は、見出し行を太字＋背景色＋中央寄せ＋固定、表全体に罫線、列幅を自動調整の4点です。下のコードを貼れば1回の実行で済みます。
• 1色で塗るなら setBackground、セルごとに色を変えるなら二次元配列を渡す setBackgrounds を使います。
• 値が変わるたびに色を変えたいなら条件付き書式（newConditionalFormatRule）、実行した時点の見た目を固定したいなら直接の書式設定を選びます。
• setBorder の引数は 上・左・下・右・内側の縦・内側の横 の順で、true は引く、false は消す、null は変えない、です。

コピペ用：表を整える1関数

function formatTable() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const lastRow = sheet.getLastRow();
  const lastCol = sheet.getLastColumn();
  if (lastRow < 1 || lastCol < 1) return; // 空のシートでは何もしない

  // 1. 見出し行：太字＋背景色＋中央寄せ
  sheet.getRange(1, 1, 1, lastCol)
    .setFontWeight('bold')
    .setBackground('#d9ead3')
    .setHorizontalAlignment('center')
    .setVerticalAlignment('middle');

  // 2. 見出し行を固定
  sheet.setFrozenRows(1);

  // 3. 表全体に罫線（外枠＋内側の縦線・横線）
  sheet.getRange(1, 1, lastRow, lastCol)
    .setBorder(true, true, true, true, true, true,
      '#999999', SpreadsheetApp.BorderStyle.SOLID);

  // 4. 列幅を内容に合わせて自動調整
  sheet.autoResizeColumns(1, lastCol);
}

次の6行×6列の表（備品の在庫表を想定）に対して動かしたときの、モックでの呼び出し記録です。

A1:F1.setFontWeight("bold")
A1:F1.setBackground("#d9ead3")
A1:F1.setHorizontalAlignment("center")
A1:F1.setVerticalAlignment("middle")
sheet.setFrozenRows(1)
A1:F6.setBorder(true, true, true, true, true, true, "#999999", SpreadsheetApp.BorderStyle.SOLID)
sheet.autoResizeColumns(1, 6)

書式メソッドの多くは Range を返すので、.setFontWeight('bold').setBackground(...) のようにつなげて書けます。行数と列数は getLastRow() と getLastColumn() から求めているため、表の大きさが変わってもコードはそのまま使えます。

書式メソッドの早見表（やりたいこと→メソッド→引数の例）

範囲（Range）に対するメソッド

sheet.getRange(...) で取った範囲に対して呼びます。

シート（Sheet）に対するメソッド

列幅・行の高さ・固定は、範囲ではなくシートに対して呼びます。

列と行の番号は 1 から数えます（A列＝1）。幅と高さの単位はピクセルです。

setBackgroundとsetBackgroundsの違い

名前の末尾に s が付くメソッドは、セルごとに別の値を指定するための二次元配列版です。背景色に限らず、setFontColors、setFontWeights、setFontSizes、setNumberFormats、setHorizontalAlignments などが同じ関係になっています。

1行おきに色分けする・値に応じて色分けする

// データ行を1行おきに色分けする（setBackgrounds に二次元配列を渡す）
function stripeRows() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const lastRow = sheet.getLastRow();
  const lastCol = sheet.getLastColumn();
  if (lastRow < 2) return; // データ行が無い

  const numRows = lastRow - 1; // 見出し行を除く
  const colors = [];
  for (let r = 0; r < numRows; r++) {
    const color = r % 2 === 0 ? '#ffffff' : '#f3f3f3';
    colors.push(new Array(lastCol).fill(color)); // 1行ぶん＝列数ぶんの配列
  }
  sheet.getRange(2, 1, numRows, lastCol).setBackgrounds(colors);
}

// 在庫数（C列）が10未満の行だけ色を付ける（値を読んで配列を作る）
function highlightLowStock() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const lastRow = sheet.getLastRow();
  const lastCol = sheet.getLastColumn();
  if (lastRow < 2) return;

  const range = sheet.getRange(2, 1, lastRow - 1, lastCol);
  const colors = range.getValues().map(row =>
    new Array(lastCol).fill(row[2] < 10 ? '#fce5cd' : '#ffffff'));
  range.setBackgrounds(colors);
}

どちらの関数も、範囲 A2:F6 に対して setBackgrounds を 1回だけ呼びます（モックでの呼び出し記録）。

A2:F6.setBackgrounds(5行x6列の配列)

highlightLowStock が作る配列の1列目を取り出すと、在庫数が 10 未満の3行目（ホワイトボードマーカー）と5行目（プロジェクター用ケーブル）だけ色が変わっていることを確認できます。

["#ffffff","#fce5cd","#ffffff","#fce5cd","#ffffff"]

セルを1つずつ setBackground で塗るループに比べて、シートへの呼び出しが1回で済むのが利点です。配列を作るときは、行数は numRows、1行の要素数は列数と、範囲の大きさから組み立てると大きさがそろいます。

直接の書式設定と条件付き書式の違いと選び方

setBackground などで付けた色は、実行した時点の値に基づく固定の見た目です。あとで在庫数が書き換わっても、色は変わりません。値の変化に合わせて色を変えたいときは、条件付き書式のルールをスクリプトから設定します。

どちらを使うかの判断表

条件付き書式をスクリプトで設定する

// 在庫数（C列）が10未満の行に色を付ける条件付き書式を設定する
function setLowStockRule() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange('A2:F1000');

  const rule = SpreadsheetApp.newConditionalFormatRule()
    .whenFormulaSatisfied('=AND($C2<>"", $C2<10)') // 行全体を塗るので列は $ で固定
    .setBackground('#fce5cd')
    .setBold(true)
    .setRanges([range])
    .build();

  // 何度実行してもルールが増えないよう、入れ替える
  sheet.setConditionalFormatRules([rule]);
}

// 既存のルールを残したまま1件追加する
function addStatusRule() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo('要発注')
    .setFontColor('#cc0000')
    .setRanges([sheet.getRange('B2:B1000')])
    .build();

  const rules = sheet.getConditionalFormatRules();
  rules.push(rule);
  sheet.setConditionalFormatRules(rules);
}

setLowStockRule を2回、続けて addStatusRule を1回呼んだときの、モックでの呼び出し記録です。

（setLowStockRule 1回目）
sheet.setConditionalFormatRules(1件)
（setLowStockRule 2回目）
sheet.setConditionalFormatRules(1件)
（addStatusRule）
sheet.setConditionalFormatRules(2件)

setConditionalFormatRules は、シートのルール一式を渡した配列で置き換えるメソッドです。そのため、ルールを足したいときは getConditionalFormatRules() で今のルールを取り、push してから設定し直します（公式リファレンスのサンプルもこの形です）。逆に、同じ関数を何度も実行する使い方なら、配列を作り直して入れ替えるとルールが増え続けません。

条件を作るメソッドは、公式リファレンスに次のものが載っています。

setBorderの引数と線種の早見表

setBorder は引数が多いので、順番を表で確かめながら書くと確実です。

1〜6番目に渡す値の意味は次の3通りです。

線種は、公式リファレンスの Enum BorderStyle に6種類あります。

よく使う罫線のパターン

// 罫線の引き方いろいろ
function borderSamples() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const style = SpreadsheetApp.BorderStyle;

  // 外枠だけ（内側は変えない）
  sheet.getRange('A1:F6').setBorder(true, true, true, true, null, null);

  // 見出し行の下だけ太線
  sheet.getRange('A1:F1').setBorder(null, null, true, null, null, null,
    '#000000', style.SOLID_MEDIUM);

  // 内側の横線だけ点線
  sheet.getRange('A2:F6').setBorder(null, null, null, null, null, true,
    '#bbbbbb', style.DOTTED);

  // 罫線をすべて消す
  sheet.getRange('H1:J6').setBorder(false, false, false, false, false, false);
}

モックでの呼び出し記録です。

A1:F6.setBorder(true, true, true, true, null, null)
A1:F1.setBorder(null, null, true, null, null, null, "#000000", SpreadsheetApp.BorderStyle.SOLID_MEDIUM)
A2:F6.setBorder(null, null, null, null, null, true, "#bbbbbb", SpreadsheetApp.BorderStyle.DOTTED)
H1:J6.setBorder(false, false, false, false, false, false)

setNumberFormatの書式文字列の早見表

setNumberFormat には、数値や日付の見せ方を表す書式文字列を渡します。セルの値そのものは変わらず、表示だけが変わります。記号の意味は Google Sheets API の「Number format patterns」に載っています。

数値の記号

日付・時刻の記号

よく使う書式文字列

公式ページには、#,### で 12,000、000.0000 で 012.3400、yyyy-mm-dd で 2016-04-05 と表示される例が載っています。

コピペ用：列ごとに表示形式・配置・列幅を設定する

// 列ごとに表示形式・配置・折り返しを設定する
function formatColumns() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const lastRow = sheet.getLastRow();
  if (lastRow < 2) return;
  const numRows = lastRow - 1;

  sheet.getRange(2, 1, numRows, 1).setWrap(true);                      // A列 品名：折り返す
  sheet.getRange(2, 3, numRows, 1).setNumberFormat('#,##0');           // C列 在庫数：桁区切り
  sheet.getRange(2, 4, numRows, 1).setNumberFormat('#,##0"円"');       // D列 単価：単位つき
  sheet.getRange(2, 5, numRows, 1).setNumberFormat('yyyy-mm-dd')       // E列 入荷日
    .setHorizontalAlignment('center');
  sheet.getRange(2, 6, numRows, 1).setNumberFormat('0.0%');            // F列 充足率
  sheet.getRange(2, 3, numRows, 2).setHorizontalAlignment('right');    // C〜D列：右寄せ

  sheet.setColumnWidth(1, 220);      // A列を220ピクセルに
  sheet.setColumnWidths(2, 5, 100);  // B列から5列ぶんを100ピクセルに
  sheet.setRowHeight(1, 32);         // 1行目の高さを32ピクセルに
}

モックでの呼び出し記録です。

A2:A6.setWrap(true)
C2:C6.setNumberFormat("#,##0")
D2:D6.setNumberFormat("#,##0\"円\"")
E2:E6.setNumberFormat("yyyy-mm-dd")
E2:E6.setHorizontalAlignment("center")
F2:F6.setNumberFormat("0.0%")
C2:D6.setHorizontalAlignment("right")
sheet.setColumnWidth(1, 220)
sheet.setColumnWidths(2, 5, 100)
sheet.setRowHeight(1, 32)

折り返したい列は setColumnWidth で幅を決めて setWrap(true)、内容に合わせたい列は autoResizeColumns と、列ごとに役割を分けると整えやすくなります。

書式を消す：clearFormat・clearFormats・条件付き書式の削除

// 書式を消す3通り
function clearSamples() {
  const sheet = SpreadsheetApp.getActiveSheet();

  sheet.getRange('A2:F6').clearFormat();        // 範囲の書式だけ消す（値は残る）
  sheet.getRange('H1:J6').clear({ formatOnly: true }); // 同じく書式だけ
  sheet.clearFormats();                         // シート全体の書式を消す（値は残る）
  sheet.clearConditionalFormatRules();          // 条件付き書式のルールをすべて消す
}

範囲用は clearFormat（s なし）、シート用は clearFormats（s あり）と名前が1文字違います。条件付き書式のルールは直接の書式とは別に管理されているので、ルールを消すときは専用のメソッドを呼びます。

確かめて分かったこと

• 列幅・行の高さ・固定は Range ではなく Sheet のメソッドです。sheet.getRange(...).setColumnWidth(...) という書き方は型定義に無く、sheet.setColumnWidth(列番号, 幅) と書きます。
• setBorder の null は「変えない」、false は「消す」です。外枠だけを引き直したいときに内側を false にすると、内側の線が消えます。
• setConditionalFormatRules は追加ではなく置き換えです。モックで同じ関数を2回呼んでもルールは1件のままで、getConditionalFormatRules() に push したときだけ2件になりました。
• 横の配置は 'left'・'center'・'right'、縦の配置は 'top'・'middle'・'bottom' で、縦の中央は 'center' ではなく 'middle' です。
• 書式文字列の m は、前後に時や秒があると「分」として扱われます。 日付と時刻を1つの書式に書くときは、月を MM と書くと区別がはっきりします。
• 二次元配列版のメソッドは、範囲と配列の行数・列数をそろえて渡します。 範囲を getRange(2, 1, numRows, lastCol) と取ったら、配列も numRows 行 × lastCol 列で作ります。

よくある質問

Q. setBackground と setBackgrounds の違いは？ A. 渡す引数が、色の文字列1つか、色の二次元配列かの違いです。範囲全体を同じ色にするなら setBackground、セルごとに色を変えるなら範囲と同じ大きさの配列を作って setBackgrounds を使います。

Q. GAS で条件付き書式を設定するには？ A. SpreadsheetApp.newConditionalFormatRule() で条件・見た目・範囲を指定して build() し、sheet.setConditionalFormatRules([ルール]) で設定します。既存のルールを残すなら、getConditionalFormatRules() の結果に push してから設定します。

Q. 列幅を自動調整できないときは？ A. autoResizeColumns は Sheet のメソッドなので、sheet.autoResizeColumns(開始列, 列数) の形で呼びます。開始列は 1 から数え、2つ目の引数は終了列ではなく列数です。

Q. 罫線を消すには？ A. range.setBorder(false, false, false, false, false, false) で、その範囲の外枠と内側の線を消せます。色や表示形式もまとめて消してよいなら range.clearFormat() が使えます。

Q. 書式だけを別の範囲に写すには？ A. 型定義では、range.copyTo(destination, SpreadsheetApp.CopyPasteType.PASTE_FORMAT, false) の形で書式だけを貼り付ける指定ができます。見出し行の装飾を別のシートにそろえるときに使えます。

まとめ

• 表を整える定番は、見出し行の太字＋背景色＋中央寄せ＋固定、表全体の罫線、列幅の自動調整。1関数にまとめておくと使い回せる
• 色・文字・配置・表示形式・罫線は Range、列幅・行の高さ・固定は Sheet のメソッド
• 1色なら setBackground、セルごとなら二次元配列の setBackgrounds。配列は範囲と同じ行数×列数にする
• 値が変わるたびに色を変えたいなら条件付き書式。setConditionalFormatRules はルール一式の置き換え
• setBorder は上・左・下・右・縦・横の順。true は引く、false は消す、null は変えない
• setNumberFormat は表示だけを変える。#,##0・0.0%・yyyy/MM/dd の3つから覚えると応用しやすい
• 書式を消すのは clearFormat（範囲）と clearFormats（シート）、条件付き書式は clearConditionalFormatRules

参考・出典

• Google Apps Script リファレンス「Class Range」 https://developers.google.com/apps-script/reference/spreadsheet/range （2026-10-06 閲覧）
• Google Apps Script リファレンス「Class Sheet」 https://developers.google.com/apps-script/reference/spreadsheet/sheet （2026-10-06 閲覧）
• Google Apps Script リファレンス「Class ConditionalFormatRuleBuilder」 https://developers.google.com/apps-script/reference/spreadsheet/conditional-format-rule-builder （2026-10-06 閲覧）
• Google Apps Script リファレンス「Enum BorderStyle」 https://developers.google.com/apps-script/reference/spreadsheet/border-style （2026-10-06 閲覧）
• Google Sheets API「Number format patterns」 https://developers.google.com/sheets/api/guides/formats （2026-10-06 閲覧）
• Google Apps Script「Extending Google Sheets」 https://developers.google.com/apps-script/guides/sheets （2026-10-06 閲覧）
• 型定義パッケージ @types/google-apps-script 2.0.13（npm）

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。