こんにちは、凛です。2児のママで現役ナースをしながら、GASで副業をしています。GASを触るとほぼ必ず向き合うのが「配列」です。スプレッドシートのデータはgetValues()を叩いた瞬間に2次元配列として返ってくるので、配列を制する者がGASを制すと言っても大げさじゃありません。
今日は、実務で出番が多い配列メソッド15個を早見表でサクッと整理します。
「GAS 配列」「GAS map filter」で検索してここに来た方が、読み終わったあと即コードに戻れるレベルで書いています。
こんな悩みありませんか？
「配列メソッドがありすぎて、どれを使えばいいかわからない」「for文で頑張ってるけど、mapやfilterのほうが速くて読みやすいって聞いた」「2次元配列の扱いでいつも迷子になる」「sortで元の配列が書き換わってバグった」
私も最初は全部forでゴリ押しで、30行かけて書いていた処理がmapとfilterで3行になったときは感動でした。知っているだけで、コードの読みやすさが段違いになります。
配列とは何か（GAS入門の方向け）
GASで配列を理解する前に、ざっくりおさらいしましょう。
配列とは、複数のデータをまとめて持つ変数のことです。
// 1次元配列（1行のデータ）
const nurses = ['佐藤', '鈴木', '田中'];
console.log(nurses[0]); // '佐藤'（インデックスは0始まり）
// 2次元配列（複数行のデータ = スプシと同じ構造）
const schedule = [
['佐藤', '日勤', '8:00'],
['鈴木', '夜勤', '16:00'],
['田中', '早番', '7:00'],
];
console.log(schedule[0][1]); // '日勤'（0行目の1列目）スプレッドシートからgetValues()で取得したデータはまさにこの2次元配列の形です。schedule[行インデックス][列インデックス]でアクセスします。
全体像：GAS配列メソッド早見表15個
| # | メソッド | 用途 | 元配列を書き換える？ |
|---|---|---|---|
| 1 | push | 末尾に追加 | ✅ |
| 2 | pop | 末尾を取り出す | ✅ |
| 3 | shift | 先頭を取り出す | ✅ |
| 4 | unshift | 先頭に追加 | ✅ |
| 5 | concat | 配列を結合（新配列） | ❌ |
| 6 | slice | 部分コピー（新配列） | ❌ |
| 7 | splice | 削除／挿入 | ✅ |
| 8 | indexOf | 位置を探す | ❌ |
| 9 | includes | 含むか判定 | ❌ |
| 10 | join | 文字列に結合 | ❌ |
| 11 | map | 要素を変換（新配列） | ❌ |
| 12 | filter | 要素を絞り込む（新配列） | ❌ |
| 13 | find | 最初の1件を探す | ❌ |
| 14 | reduce | 集計する | ❌ |
| 15 | sort | 並び替える | ✅ |
「元配列を書き換えるかどうか」は超重要。 バグの大半はここに起因します。書き換えるメソッド（✅）は破壊的メソッド、書き換えないメソッド（❌）は非破壊的メソッドと呼びます。
この15個で実務の9割はカバーできます。
要素の出し入れ：push / pop / shift / unshift
もっとも基本的な配列操作です。
const nurses = ['佐藤', 'さとみ'];
nurses.push('ゆき'); // 末尾に追加 → ['佐藤', 'さとみ', 'ゆき']
const last = nurses.pop(); // 末尾を取り出す → last = 'ゆき'
nurses.unshift('師長'); // 先頭に追加 → ['師長', '佐藤', 'さとみ']
const head = nurses.shift(); // 先頭を取り出す → head = '師長'GASで一番出番が多いのはpushです。 スプレッドシートに書き込む行データを組み立てるときに頻出します。
// 実践例：複数行のデータを組み立てて一括書き込み
function writeDataToSheet() {
const sheet = SpreadsheetApp.openById('スプシID').getActiveSheet();
const users = [
{ name: '佐藤', age: 32, shift: '日勤' },
{ name: '鈴木', age: 28, shift: '夜勤' },
{ name: '田中', age: 35, shift: '早番' },
];
const rows = [];
for (const user of users) {
rows.push([user.name, user.age, user.shift]); // 各ユーザーを行として追加
}
// まとめて一括書き込み（行ごとに書き込むより高速）
sheet.getRange(2, 1, rows.length, 3).setValues(rows);
}pushで行データを配列に積み上げてから、setValuesで一括書き込みするのがGASのお決まりパターンです。
加工の三兄弟：map / filter / find
この3つが使いこなせると、for文だらけのコードがスッキリします。
map — 各要素を変換する
const prices = [100, 200, 300];
// 全要素に税を掛ける（新しい配列が返る。元の配列は変わらない）
const withTax = prices.map(p => Math.round(p * 1.1));
// withTax: [110, 220, 330]
// prices は [100, 200, 300] のままmapは「全部に同じ処理をしたいとき」に使います。税計算、単位変換、形式の変換など。
// 実践例：スプシの日付列を「YYYY年MM月DD日」形式に変換
const formatted = data.map(row => {
const date = row[0]; // 日付型
return [
Utilities.formatDate(date, 'Asia/Tokyo', 'yyyy年MM月dd日'),
row[1],
row[2],
];
});filter — 条件に合うものだけ残す
const prices = [100, 200, 300];
// 200以上のもの
const expensive = prices.filter(p => p >= 200);
// expensive: [200, 300]filterは「ある条件のデータだけ欲しいとき」に使います。
// 実践例：「未処理」のデータだけ抽出してメール送信
const allData = sheet.getDataRange().getValues().slice(1); // ヘッダー除去
const pending = allData.filter(row => row[3] === '未処理');
if (pending.length > 0) {
GmailApp.sendEmail(
'admin@example.com',
`未処理件数: ${pending.length}件`,
pending.map(row => row[0]).join('\n')
);
}find — 最初の1件を探す
const users = [
{ id: 1, name: '佐藤' },
{ id: 2, name: '鈴木' },
{ id: 3, name: '田中' },
];
const target = users.find(u => u.id === 2);
// target: { id: 2, name: '鈴木' }
const notFound = users.find(u => u.id === 99);
// notFound: undefined（見つからない場合）findは「特定の1件を探すとき」に使います。filterと違い、最初に見つかった1件だけ返します。
注意：見つからない場合はundefinedが返るので、そのままプロパティにアクセスするとエラーになります。
// ❌ NG：targetがundefinedのとき.nameでエラー
const name = target.name;
// ✅ OK：undefinedチェックを入れる
if (!target) {
console.log('見つかりませんでした');
return;
}
console.log(target.name); // 安全にアクセスできる集計と並び替え：reduce / sort
reduce — 集計する
reduceは「配列を1つの値にまとめるとき」に使います。合計、平均、オブジェクトへの集計など。
const prices = [100, 200, 300];
// 合計
const total = prices.reduce((sum, p) => sum + p, 0);
// total: 600
// 第2引数（0）がスタート値。これが「これまでの合計」として引き継がれるreduceは最初は難しく見えますが、「第2引数がスタート値」と覚えれば一気に使えるようになります。
// 実践例：シフト種別ごとの人数を集計
const shiftData = [
['佐藤', '日勤'],
['鈴木', '夜勤'],
['田中', '日勤'],
['山田', '夜勤'],
['小林', '早番'],
];
const count = shiftData.reduce((acc, row) => {
const shift = row[1];
acc[shift] = (acc[shift] || 0) + 1;
return acc;
}, {});
// count: { 日勤: 2, 夜勤: 2, 早番: 1 }sort — 並び替える
const prices = [300, 100, 200];
// 昇順（小さい順）
prices.sort((a, b) => a - b);
// prices: [100, 200, 300]（元の配列が変わる！）sortは元の配列を書き換えます。 元の順番を残したい場合は、コピーしてからsortしてください。
// ✅ コピーしてから並び替え
const sorted = [...prices].sort((a, b) => b - a); // 降順
// prices は元の順番のまま
// sorted は [300, 200, 100]// 実践例：スプシデータを日付降順に並び替え
const data = sheet.getDataRange().getValues().slice(1);
const sorted = [...data].sort((a, b) => {
const dateA = new Date(a[0]); // 0列目が日付
const dateB = new Date(b[0]);
return dateB - dateA; // 降順（新しい順）
});2次元配列でよく使うパターン
スプレッドシートから取ったvaluesは2次元配列（[[行1], [行2], ...]）です。GAS配列の実戦はここからです。
パターン1：ヘッダーを除いてフィルタ
const values = sheet.getDataRange().getValues();
// 安全な方法：sliceで先頭（ヘッダー）を除く（元配列を変えない）
const dataRows = values.slice(1);
const activeRows = dataRows.filter(row => row[2] === '有効');shift()でも同じことができますが、shift()は元の配列からヘッダーを削除してしまいます。元データを保持したい場合はslice(1)が安全です。
パターン2：特定列だけ抜き出す
const values = sheet.getDataRange().getValues().slice(1);
// 1列目（名前）だけ抜き出す
const names = values.map(row => row[0]);
// 分割代入を使うとさらに読みやすい
const names2 = values.map(([name]) => name);
// 複数列を抜き出す
const nameAndShift = values.map(([name, , shift]) => ({ name, shift }));
// 2列目を飛ばして1列目と3列目だけ取得パターン3：重複を排除する
const names = ['佐藤', '鈴木', '佐藤', '田中', '鈴木'];
// Setを使って重複を排除（スプシ配列でよく使う）
const unique = [...new Set(names)];
// unique: ['佐藤', '鈴木', '田中']SetはJavaScriptの組み込みオブジェクトで、重複した値を自動的に除いてくれます。
パターン4：合計・集計
const salesData = [
['佐藤', 50000],
['鈴木', 80000],
['田中', 60000],
];
// 2列目（数字）の合計
const total = salesData.reduce((sum, row) => sum + row[1], 0);
// total: 190000
// 平均
const avg = total / salesData.length;
// avg: 63333...パターン5：2次元配列を1次元に平坦化
const matrix = [['a', 'b'], ['c', 'd'], ['e', 'f']];
const flat = matrix.flat();
// flat: ['a', 'b', 'c', 'd', 'e', 'f']flat()はGASのV8ランタイムで使えます。入れ子の配列を1次元に展開したいときに便利です。
困ったときの小さなコツ
// map後に条件分岐したくなったら、先にfilterで絞る
const result = data
.filter(row => row[2] === '有効') // 絞り込んでから
.map(row => row[0] + ': ' + row[1]); // 変換
// indexOf より includes の方が読みやすい（-1比較が不要）
// ❌ 読みにくい
if (arr.indexOf('完了') !== -1) { ... }
// ✅ 読みやすい
if (arr.includes('完了')) { ... }
// 元配列を壊したくないときは毎回スプレッド演算子でコピー
const safeSorted = [...original].sort();
// 空配列チェック
if (arr.length === 0) { ... } // シンプルで確実よくあるエラーと解決法
TypeError: Cannot read properties of undefined
空配列や存在しないインデックスにアクセスするとき。
// ❌ NGパターン
const sheet = SpreadsheetApp.openById('ID').getActiveSheet();
const data = sheet.getDataRange().getValues();
console.log(data[100][0]); // データが100行未満だとエラー
// ✅ 安全なアクセス
const row = data[100];
if (row) {
console.log(row[0]);
}
// オプショナルチェーン（?.）でも簡単に書ける
console.log(data[100]?.name); // 存在しないときundefinedを返すfindで見つからないのに処理が続く
const target = users.find(u => u.id === 99);
// targetはundefinedかもしれない
// ❌ NG：undefinedのままプロパティアクセスするとエラー
console.log(target.name);
// ✅ OK：undefinedチェックを入れる
if (!target) {
console.log('見つかりませんでした');
return;
}
console.log(target.name);sortの数値比較に注意
const nums = [10, 9, 100, 2];
// ❌ NG：デフォルトsortは文字列比較
nums.sort();
// ['10', '100', '2', '9'] → 数値的には正しくない結果
// ✅ OK：比較関数を指定
nums.sort((a, b) => a - b);
// [2, 9, 10, 100]デフォルトのsort()は文字列として比較するため、数値をsortする際は必ず(a, b) => a - b（昇順）または(a, b) => b - a（降順）を指定してください。
実践：スプシ全体のデータ処理の例
ここまでの知識を組み合わせた実践例です。
function processAttendance() {
const sheet = SpreadsheetApp.openById('スプシID').getSheetByName('出勤記録');
const data = sheet.getDataRange().getValues();
// ヘッダー行を保持しつつデータ行を取得
const [header, ...rows] = data;
// 今月のデータだけ抽出
const thisMonth = new Date().getMonth();
const thisMonthRows = rows.filter(row => {
const date = new Date(row[0]);
return date.getMonth() === thisMonth;
});
// シフト種別ごとに集計
const shiftCount = thisMonthRows.reduce((acc, row) => {
const shift = row[2]; // 3列目がシフト種別
acc[shift] = (acc[shift] || 0) + 1;
return acc;
}, {});
// スタッフ名だけ抽出して重複排除
const staffNames = [...new Set(thisMonthRows.map(row => row[1]))];
// 結果をログ出力
console.log('今月の出勤回数:', thisMonthRows.length);
console.log('シフト別集計:', JSON.stringify(shiftCount));
console.log('出勤スタッフ:', staffNames.join(', '));
}まとめ
- 出し入れは
push/pop/shift/unshift（全部破壊的なので注意） - 加工は
map/filter/find、集計はreduce（全部非破壊） - 2次元配列は
slice(1)でヘッダー除去→filter/mapが鉄板 sort/splice/shiftは破壊的なので、[...array]でコピーしてから使う- 迷ったら元配列を書き換えないメソッドを優先するとバグりにくい
15個すべてを一度に覚えなくて大丈夫です。まずは**push・map・filter・reduceの4つ**から始めましょう。コードがグッとモダンになります。慣れてきたらfind・sort・flatを足していけば、実務はほぼ何でも書けるようになります。
関連記事
- GAS変数const/letの違いと使い分け3パターン — JavaScript基礎
- GAS関数の書き方7例とreturn徹底解説 — 関数の使い方
- GASでCSVをスプシに取り込む3手順 — 配列を使ったCSV処理
- 条件付き書式をGASで一括設定する10例 — 配列を使ったスプシ操作
この記事を書いた人：凛
2児のママで現役ナース。夜勤明けの細切れ時間を副業GASに投じ、月5〜8万円の副収入を継続中。「看護師でもコードは書ける」を合言葉に、家事育児とプログラミングを両立する等身大の情報を発信しています。本記事のコードは静的検証済みです（構文・API仕様・ロジックを確認）。
AI活用について：本記事の構成・文章の一部はAIを活用して作成しています。掲載コードは実際に動作検証済みで、内容の正確性は筆者が確認しています。