スプレッドシートに溜まった大量のデータから、「特定の条件に合うデータだけをパッと抜き出したい」と思ったことはありませんか?
例えば、「売上が10,000円以上のデータだけを集めたい」「特定の担当者の行だけを抽出したい」「先月分のデータだけを取り出したい」といった場面は、日々の業務で頻繁に発生しますよね。
for文(繰り返し処理)と if文(条件分岐)を組み合わせて、1行ずつ上から順番にチェックしていく方法もありますが、コードが長くなり、書き間違いも起きやすくなります。
そこで登場するのが、今回マスターする Array.filter()(フィルター) です!
Array.filter() を使えば、たった数行のコードで条件に合うデータだけを一瞬でふるい落として抽出できます。
さらに今回は、プログラミングの世界で今や世界標準となっている超便利で現代的な書き方「アロー関数(=>)」についても、どこよりも噛み砕いて徹底解説します!
スプレッドシートから getValues() で取得した2次元配列のデータを自在に絞り込めるようになると、業務自動化の作業効率が格段に上がります。初心者の方でも絶対に挫折しないよう、基礎から丁寧に解説していきます!
1. そもそも Array.filter() とは?
Array.filter() は、配列(データのグループ)に入っている要素を1つずつチェックし、条件を満たしたもの(結果が true になったもの)だけを集めて「新しい配列」を作り出す命令です。
「キッチンのザル(ふるい)」でイメージしてみよう
プログラミングの概念を理解するときは、身近なツールに例えると一気に分かりやすくなります。Array.filter() は、まさに「キッチンのザル」や「ふるい」と同じ働きをしています。
- 元の配列(ザルに入れる前の状態):いろいろな大きさや種類のデータが混ざったグループ
- filterの条件(ザルの網目の大きさ):「数値が20以上」「文字が〇〇と一致する」といったふるいの基準
- 新しい配列(ザルの上に残ったデータ):条件をクリアしてふるいを通り抜けられなかった、欲しいデータだけのグループ
ポイントは、「ふるいにかけた後も、元々のデータはそのまま残っている」 という点です。元のデータを壊さずに、必要なデータだけをコピーして新しいグループを作ってくれるのが filter() の素晴らしい特徴です。
2. Array.filter() の基本文法と動く仕組み
まずは、一番シンプルな「1次元配列(数字や文字が1列に並んだデータ)」を使って、文法と動く仕組みをじっくり紐解いていきましょう。
従来の基本の書き方
var 新しい配列 = 元の配列.filter(function(要素) {
return 条件式;
});
処理の内部で起きていること(1ステップずつ分解!)
例えば、var numbers = [10, 25, 40, 5, 60]; という配列から「30以上の数字だけ」を取り出したいとします。
var numbers = [10, 25, 40, 5, 60];
// 30以上の数値だけを抽出する
var bigNumbers = numbers.filter(function(num) {
return num >= 30;
});
Logger.log(bigNumbers); // 実行結果:[40, 60]
このとき、プログラムの内部では以下のような「判定作業」が1マスずつ順番に行われています。
- 1回目(
numが10のとき):10 >= 30はfalse(不合格!) ➡ 捨てる - 2回目(
numが25のとき):25 >= 30はfalse(不合格!) ➡ 捨てる - 3回目(
numが40のとき):40 >= 30はtrue(合格!) ➡ 新しい配列に残す! - 4回目(
numが5のとき) :5 >= 30はfalse(不合格!) ➡ 捨てる - 5回目(
numが60のとき):60 >= 30はtrue(合格!) ➡ 新しい配列に残す!
最終的に、true になった 40 と 60 だけが選ばれ、bigNumbers という新しい配列に保存されます。
3. コードが10倍スッキリ!「アロー関数(=>)」を完璧マスター
さて、ここでGASやJavaScriptを学ぶ上で避けては通れない、「アロー関数」 についてじっくり解説します!
ネットでGASのコードを検索すると、function() ではなく => という記法がよく使われているのを目にするはずです。「なんだか記号だらけで難しそう…」と感じるかもしれませんが、仕組みさえ知れば「ただの便利なショートカット記法」だと分かります。
3-1. アロー関数ってなに?(なぜ「矢印」なの?)
アロー関数(Arrow Function)の「アロー(Arrow)」とは、英語で「矢(=矢印)」のことです。
記号の => (イコール + 大なり)が、右を向いた矢印の形に見えることからこの名前がつきました。
機能としては、従来の function で書く関数とまったく同じです。単に「もっと短く、もっと楽に書けるようにしよう!」という目的で作られた書き方(構文)です。
3-2. 従来の書き方から「アロー関数」への変身3ステップ!
「なぜあの長いコードがこんなに短くなるの?」という謎を解き明かすために、従来の function 構文をアロー関数へ順番に変身させてみましょう。
【ビフォー(従来の書き方)】
function(num) {
return num >= 30;
}
ここから以下の3つのステップを踏むだけで、アロー関数に化けます!
[ステップ1]function という文字を削除し、矢印 => を置く
関数を意味する function という長い英単語を消し、引数 (num) の後ろに矢印 => を挿入します。
(num) => {
return num >= 30;
}
[ステップ2]中身が1行なら、波カッコ { } と return を消す
処理が「1行の条件判定だけ」の場合、波カッコ { } と return という単語をセットで丸ごと省略できるというルールがあります。
(num) => num >= 30
[ステップ3]受け取るデータ(引数)が1つなら、丸カッコ ( ) も消す
条件チェックに使うデータ(引数)が num 1つだけの場合、一番外側の丸カッコ ( ) すら省略可能です!
// 【アフター(完成形のアロー関数!)】
num => num >= 30
3-3. アロー関数の「カッコ省略ルール」まとめ
アロー関数を使うときのカッコ ( ) の扱い方は、受け取るデータの数によって決まっています。
| データ(引数)の数 | 書き方 | コード例 | カッコの要不要 |
| 1つのとき | 引数 => 処理 | num => num >= 30 | 省略OK!(一番スッキリ) |
| 2つ以上のとき | (引数1, 引数2) => 処理 | (row, index) => row[2] >= 20 | 丸カッコ () が必須! |
| 0(なし)のとき | () => 処理 | () => Logger.log("Hello") | 空の丸カッコ () が必須! |
3-4. filter() と合体させたときの劇的な変化!
それでは、従来の見分けづらいコードと、アロー関数を使ったコードを読み比べてみましょう。
【従来の書き方】
var bigNumbers = numbers.filter(function(num) {
return num >= 30;
});
【アロー関数を使った書き方】
var bigNumbers = numbers.filter(num => num >= 30);
いかがでしょうか?
アロー関数を使うと、「numbers の中から、num が 30 以上のものを filter する」 という意味が、ひと目で直感的に読み取れるようになりますよね!
3-5. ⚠️ 初心者が絶対ハマる!アロー関数「波カッコ {} の罠」
アロー関数を使う上で、初心者が一番最初につまずく超危険な落とし穴があります。それが「波カッコ { } を書いたのに return を忘れる罠」です。
// ✕ 超危険!間違いコード
var bigNumbers = numbers.filter(num => {
num >= 30; // 波カッコを書いているのに return を書いていない!
});
// ➡ 結果は空の配列 [] になってしまう!
- 波カッコ
{}なし:自動的に判定結果(trueかfalse)をreturnしてくれる。 - 波カッコ
{}あり:自動returnが無効化されるため、明示的にreturnと書かなければならない。
複数行にわたる複雑な処理を書くために波カッコ { } を使った場合は、必ず return もセットで記述してくださいね!
// ◯ 正しい書き方(波カッコを使う場合)
var bigNumbers = numbers.filter(num => {
Logger.log("チェック中の数値: " + num);
return num >= 30; // 明示的に return を書く!
});
4. STEP1:準備!サンプルデータを用意しよう
アロー関数の強力さを理解したところで、GASの実務で最もよく使う「スプレッドシートの表データ(2次元配列)を絞り込む」 実践に入ります。
今回は練習用に、秋風が心地よくなってきた札幌の月別最高気温データをサンプルとして使ってみましょう。
スプレッドシートの入力手順
- 新しいスプレッドシートを開き、シート名を「気温データ」にします。
- 以下のようにセルへデータを入力してください。
| A | B | C | |
| 1 | 月 | エリア | 最高気温(℃) |
| 2 | 7月 | 札幌 | 27.5 |
| 3 | 8月 | 札幌 | 29.1 |
| 4 | 9月 | 札幌 | 22.4 |
| 5 | 10月 | 札幌 | 16.2 |
| 6 | 11月 | 札幌 | 8.5 |
入力が完了したら、上部メニューの 「拡張機能」 > 「Apps Script」 をクリックして、GASのエディタ画面を開きます。
5. STEP2:【実践】GASで2次元配列(表データ)を絞り込んでみよう!
第13回で学んだ通り、getValues() を使ってスプレッドシートから取得したデータは、以下のような2次元配列(配列の中に配列が入った二重構造)になっています。
[
["7月", "札幌", 27.5], // 0行目 (row)
["8月", "札幌", 29.1], // 1行目 (row)
["9月", "札幌", 22.4], // 2行目 (row)
["10月", "札幌", 16.2], // 3行目 (row)
["11月", "札幌", 8.5] // 4行目 (row)
]
この中から、さっそく学んだばかりのアロー関数を使って「最高気温が20℃以上の月(行全体)だけ」 を抽出するコードを書いていきましょう!
1. コードを入力する
エディタに元から入っているコードを全消去し、以下のスクリプトを貼り付けます。
function filterTemperatureData() {
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getActiveSheet();
// A2:C6の範囲(見出しを除くデータ部分)を2次元配列で取得
var data = sheet.getRange("A2:C6").getValues();
// 【アロー関数で記述!】
// C列(最高気温:row[2])が 20 以上の行だけを抽出する
var warmMonths = data.filter(row => row[2] >= 20);
// 抽出結果をログに出力して確認
Logger.log(warmMonths);
}
たったこれだけです!data.filter(row => row[2] >= 20); の1行だけで、複雑な絞り込み処理が完結してしまいます。
2. 2次元配列での row[2] の意味を超解説!
2次元配列に filter() を使う場合、引数である row には「1行分のデータ(配列)」が丸ごと渡されてきます。
例えば、1回目の処理では row の中に ["7月", "札幌", 27.5] が入っています。
プログラミングでは数を 0から数えるルール(インデックス) があるため、各列要素は以下のようになります。
row[0]➡ 1番目のデータ(A列:月 ="7月")row[1]➡ 2番目のデータ(B列:エリア ="札幌")row[2]➡ 3番目のデータ(C列:最高気温 =27.5)★ここを比較したい!
そのため、row => row[2] >= 20 と書くことで、「3番目の要素(最高気温)が20以上かどうか」を判定できるのです。
3. 保存と実行結果の確認
- 画面上部の 「保存(フロッピーアイコン)」 を押します。
- 「実行」 ボタンをクリックします。
実行ログに以下のように表示されれば大成功です!
情報 [[7月, 札幌, 27.5], [8月, 札幌, 29.1], [9月, 札幌, 22.4]]
最高気温が20℃を下回る10月(16.2℃)と11月(8.5℃)の行が綺麗に除外され、条件をクリアした「7月・8月・9月」の3行分だけが抽出されました!
6. STEP3:実務で即使える!複雑な条件での絞り込みテクニック
実際の業務では、「AかつB」「AまたはB」「特定の文字を含む」といった、より柔軟な条件指定が求められます。アロー関数を使ったスマートな書き方で見ていきましょう。
パターン①:AND条件(〜かつ〜)
両方の条件を同時に満たす行だけを取り出す場合は、論理演算子 &&(アンド) を使います。
「最高気温が20℃以上」かつ「月が『9月』である」データを取り出してみましょう。
// row[2](気温)が20以上 かつ row[0](月)が "9月"
var result = data.filter(row => row[2] >= 20 && row[0] === "9月");
Logger.log(result);
// 実行結果:[["9月", "札幌", 22.4]]
パターン②:OR条件(〜または〜)
どちらか一方の条件を満たせばOKとする場合は、論理演算子 ||(パイプライン2本=オア) を使います。
「最高気温が28℃以上(真夏日並み)」または「最高気温が10℃未満(肌寒い)」の極端な月を取り出します。
// row[2] が28以上 または row[2] が10未満
var result = data.filter(row => row[2] >= 28 || row[2] < 10);
Logger.log(result);
// 実行結果:8月(29.1℃) と 11月(8.5℃) の2行が抽出される
パターン③:文字の「あいまい検索」(特定の単語を含むか)
文字列の中に特定の文字が含まれているかを判定したい場合は、JavaScriptの includes() メソッドと組み合わせます。
例えば、B列(エリア)に「札幌」という文字が含まれている行だけを取り出す場合は以下のように書きます。
// B列(row[1])の中に "札幌" という文字が含まれていれば true
var result = data.filter(row => row[1].includes("札幌"));
7. 超重要!初心者が100%ハマる「5大トラップ」と解決策
Array.filter() を使い始めた方が必ず一度は直面するエラーや勘違いを5つまとめました。あらかじめ知っておくことで、無駄なハマり時間をゼロにできます!
トラップ1:元の配列が書き換わると思っている(非破壊的メソッドの勘違い)
filter() は元の配列を一切変更しません(非破壊的メソッド)。
// ✕ よくある間違い
data.filter(row => row[2] >= 20);
Logger.log(data); // data の中身は絞り込まれていない「元の5行のまま」!
// ◯ 正しい書き方(戻り値を新しい変数で受ける)
var filteredData = data.filter(row => row[2] >= 20);
Logger.log(filteredData); // filteredData に絞り込み結果が入る!
必ず var 新しい変数 = data.filter(...) のように、結果を受け取る変数を用意してください。
トラップ2:アロー関数で波カッコ {} を書いて return を忘れる
先ほど解説した通り、アロー関数で波カッコ { } を付けると自動 return が効かなくなります。
// ✕ 結果が空っぽ [] になってしまう例
var result = data.filter(row => {
row[2] >= 20; // 波カッコがあるのに return がない!
});
// ◯ 正しい解法:1行なら波カッコを消すか、波カッコを残すなら return を書く
var result = data.filter(row => row[2] >= 20);
トラップ3:列のインデックス指定ミス(0始まりの法則)
- スプレッドシートの画面:A列=1列目、B列=2列目、C列=3列目
- GAS(配列のインデックス):A列=
row[0]、B列=row[1]、C列=row[2]
C列を指定したいのに、ついつい row[3] と書いてしまうミスが後を絶ちません。row[3] は「存在しない4列目」を参照してしまい、エラーや意図しない挙動の原因になります。「列番号 minus 1」 と覚えましょう!
トラップ4:見出し(1行目)も一緒にフィルターしてしまう
sheet.getDataRange().getValues() や sheet.getRange("A1:C6").getValues() のように、1行目の見出しも含めてデータを取得すると、見出し行まで filter() の条件判定に巻き込まれてしまいます。
【解決策①】最初からデータ範囲だけを取得する
getRange("A2:C6") のように、2行目から指定します。
【解決策②】プログラムの中で見出しを切り離す(shift() の活用)
var allData = sheet.getDataRange().getValues();
var header = allData.shift(); // 1行目(見出し)を抜き出して別保存!
var body = allData; // 2行目以降のデータだけが残る
// bodyに対して filter を実行
var filteredBody = body.filter(row => row[2] >= 20);
この切り離しテクニックを使うと、見出しを保持したままデータだけを綺麗に絞り込めるため、実務で非常に役立ちます。
トラップ5:filter() と find() の混同
filter():条件に合うものをすべて集めて「配列(複数)」で返すfind():条件に合う最初の1件だけを探して「単一のデータ」で返す
1件だけデータを取り出したいのか、該当するものを全件リストアップしたいのかによって使い分けましょう。
8. 発展:抽出したデータを別のシートに書き出してみよう!
filter() で絞り込んだデータは、そのまま第14回で学んだ setValues() を使ってスプレッドシートの新しい場所に一括で書き出すことができます。
function exportFilteredData() {
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sourceSheet = ss.getActiveSheet();
// 1. データを取得して絞り込む(アロー関数で記述)
var data = sourceSheet.getRange("A2:C6").getValues();
var warmMonths = data.filter(row => row[2] >= 20);
// 抽出結果が空でなければ書き出す
if (warmMonths.length > 0) {
// 書き出し用の別シートを取得(なければ自動作成)
var targetSheet = ss.getSheetByName("抽出結果") || ss.insertSheet("抽出結果");
// 2. 見出しを1行目に書き込む
targetSheet.getRange("A1:C1").setValues([["月", "エリア", "最高気温(℃)"]]);
// 3. 抽出されたデータを2行目以降に一括書き出し
// targetSheet.getRange(開始行, 開始列, 行数, 列数)
targetSheet.getRange(2, 1, warmMonths.length, warmMonths[0].length).setValues(warmMonths);
Logger.log("書き出しが完了しました!");
}
}
このコードを実行すると、「20℃以上のデータだけを自動で抽出し、新しいシートにまとめる」という、実務でそのまま使える自動化ツールが完成します!
9. まとめ&次回予告
今回は、配列から条件に合うデータだけを抽出する Array.filter() と、コードを格段に読みやすくする 「アロー関数(=>)」 について詳しく解説しました。
今日の重要ポイント
filter()は条件がtrueになった要素だけを集めて「新しい配列」を作る- アロー関数(
=>)はfunctionを短く書くための超便利ショートカット記法 - アロー関数で1行で書く場合は
{}とreturnを省略できる(逆に{}を書いたらreturnは必須!) - 2次元配列では
row[列インデックス](0始まり)で指定して比較する - 抽出結果はそのまま
setValues()で別シートへ一括書き出しが可能
アロー関数を使いこなせるようになると、コードの行数が激減し、後から自分で見返したときやチームで共有したときにも理解しやすいスマートなプログラムが書けるようになります。
次回(第16回)は、今回学んだ filter() と双璧をなす超重要メソッド Array.map() を解説します。
配列の中にある全データを一括で変換・加工する(例:全データの価格に消費税10%を掛ける、全文字列の後ろに「様」をつけるなど)強力なテクニックですので、どうぞお楽しみに!
