【GAS入門#16】配列データを一括変換!Array.map()の基本から2次元配列の整形まで超徹底解説

前回(第15回)は、条件に合うデータだけをきれいに抽出する Array.filter() を学びましたね。

第16回となる今回は、配列の中身を丸ごと一括で加工・変換できる最強のメソッド Array.map() を解説します!

スプレッドシートからデータを取得したとき、「すべての価格に消費税10%をかけて計算し直したい」「氏名の先頭に『様』を一括でつけたい」「特定の列だけを取り出して、スプレッドシートに書き戻せる形(2次元配列)に整えたい」といった作業は、日常の業務で毎日のように発生します。

for 文を使って1要素ずつ繰り返し処理を書くこともできますが、Array.map() を使いこなせると、コードの量が半分以下になり、読みやすくバグの少ない綺麗なプログラムが書けるようになります。

プログラミング初心者の方でも絶対につまずかないよう、図解イメージや1行ずつのコード解説を交えて、どこよりもわかりやすくお届けします!

1. そもそも Array.map() とは?

Array.map()(アレイ・マップ)は一言でいうと、「配列の全要素に対して、決まった加工処理を施した『新しい配列』を自動で作り出す命令」 です。

魔法のベルトコンベアでイメージしてみよう!

map() の動きは、工場のベルトコンベアに例えるとイメージしやすくなります。

  1. 元の材料(元の配列):[100, 200, 300] がベルトコンベアに乗って運ばれてきます。
  2. 加工マシン(map内の処理):通る材料すべてに対して「1.1倍にする(税込化)」という操作を行います。
  3. 完成した製品(新しい配列):[110, 220, 330] という新しい配列が反対側から出てきます。

ポイントは、「元の配列には一切手を加えず、まったく新しい加工後の配列を別で作る」 という点です。

なぜ for 文ではなく map() を使うの?

「繰り返し処理なら for 文でもできるのでは?」と思った方もいるかもしれません。それぞれの書き方を比べてみましょう。

【パターンA】 for 文を使う場合

var original = [100, 200, 300];
var result = []; // 空の配列をあらかじめ用意する

for (var i = 0; i < original.length; i++) {
  var taxIncluded = Math.floor(original[i] * 1.1);
  result.push(taxIncluded); // 1つずつ配列の末尾に追加する
}

【パターンB】 map() を使う場合

var original = [100, 200, 300];
var result = original.map(function(price) {
  return Math.floor(price * 1.1);
});

for 文だと「空の配列を作る」「カウンター変数(i)を用意する」「条件式を書く」「push() で追加する」といった下準備がたくさん必要ですよね。

一方 map() を使えば、「何をどう加工するか」だけをシンプルに書くことができます。手順が少ない分、打ち間違いによるエラー(タイポ)も激減するのです。

2. Array.map() の基本文法

map() の基本的な構文を確認してみましょう。

var 新しい配列 = 元の配列.map(function(要素) {
  // ここに各要素への加工処理を書く
  return 加工後の値;
});

引数の意味を分解!

  • 元の配列:加工したいデータが入っている配列。
  • function(要素):配列の要素が1つずつこのカッコの中に入ってきます。変数名(ここでは要素)は自由につけてOKです(item や row など)。
  • return:加工したあとの値を返します。この return した値が、新しい配列の要素になります。

※最近のJavaScript(ES6以降)でよく使われる「アロー関数(=>)」を使うと、さらに短く書くこともできます。

// アロー関数を使った書き方(内容はまったく同じ)
var 新しい配列 = 元の配列.map(要素 => 加工後の値);

💡 アロー関数の復習はこちら! アロー関数(=>)の詳しい書き方や基本的な文法ルールについては、第15回「Array.filter()」で詳しく解説しています。「アロー関数の書き方にまだ自信がないな…」という方は、ぜひ第15回の記事も参照してみてくださいね!

3. STEP1:準備!「札幌スープカレー巡りリスト」を用意しよう

それでは、実際に手元のスプレッドシートを使ってコードを動かしてみましょう! 今回はほんの少しだけ北海道らしく、休日に食べに行きたい「札幌スープカレー店」の税抜価格リストを題材にします。

スプレッドシートの準備

  1. 新しいGoogleスプレッドシートを1枚開きます。
  2. シート名を 「スープカレーリスト」 に変更します。
  3. 以下のようにデータを入力してください。
AB
1店名税抜価格(円)
2スープカレーGARAKU1200
3マジックスパイス1150
4ラマイ1100
  1. 画面上部メニューの 「拡張機能」 > 「Apps Script」 をクリックしてエディタを開きます。

4. STEP2:【実践】1次元配列の全データを一括で税込計算してみよう

まずは、1次元配列(数字のリスト)に対して map() を適用する一番シンプルな処理から試します。

コードの入力

エディタ画面のコードをすべて消して、以下のプログラムを貼り付けてください。

function convertToTaxIncluded() {
  // ① スープカレーの税抜価格リスト(1次元配列)を用意
  var pricesExcludingTax = [1200, 1150, 1100];
  
  // ② map() を使って全要素を1.1倍(税込化)した新しい配列を作成
  var pricesIncludingTax = pricesExcludingTax.map(function(price) {
    // price に 1200 -> 1150 -> 1100 が順番に入ってくる
    var taxIn = Math.floor(price * 1.1); // Math.floor で端数を切り捨て
    return taxIn; // 新しい配列へ追加される値を返す
  });
  
  // ③ ログ画面で元の配列と新しい配列を見比べる
  Logger.log("元の税抜価格: " + pricesExcludingTax);
  Logger.log("変換後の税込価格: " + pricesIncludingTax);
}

実行手順

  1. 画面上の 「保存(フロッピーアイコン)」 を押します。
  2. 「実行」 ボタンをクリックします。
  3. エディタ下部の「実行ログ」を確認します。

実行結果

情報    元の税抜価格: 1200,1150,1100
情報    変換後の税込価格: 1320,1265,1210

map() の中に書いた「1.1倍にして端数を切る」という処理が、1200、1150、1100 のすべてに順番に適用され、[1320, 1265, 1210] という新しい配列がバッチリ作成されました!

5. STEP3:【GASの真骨頂】2次元配列(getValues)× map() × setValues()

ここからが本番です! 実務でGASを使う際、一番頻繁に登場するのが 「Range.getValues() で取得した2次元配列を map() で加工し、Range.setValues() でスプレッドシートに書き戻す」 という流れです。

スプレッドシートの表データは、GASの中では以下のような 2次元配列(配列の中に配列が入った構造) として扱われます。

// sheet.getRange("A2:B4").getValues() で取れるデータ
[
  ["スープカレーGARAKU", 1200],  // 0行目(1行分のデータ)
  ["マジックスパイス",   1150],  // 1行目
  ["ラマイ",            1100]   // 2行目
]

このデータから「税込価格」を計算し、C列(税込価格列)に一括書き込み するコードを書いてみましょう。

実践コード

function updateTaxIncludedColumn() {
  // 1. 開いているシートを取得
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getActiveSheet();
  
  // 2. A2:B4(店名と税抜価格)の範囲を取得(2次元配列)
  var data = sheet.getRange("A2:B4").getValues();
  
  // 3. map() を使って C列に書き込むための新しい2次元配列を作成する
  var taxIncludedData = data.map(function(row) {
    // row には1行分の配列(例: ["スープカレーGARAKU", 1200])が入ってくる
    var priceExcludingTax = row[1]; // 1番目の要素(B列の税抜価格)を取り出す
    var priceIncludingTax = Math.floor(priceExcludingTax * 1.1); // 1.1倍
    
    // 【超重要】setValues用に [[値1], [値2], ...] の2次元配列の形にするため [ ] で囲んで返す!
    return [priceIncludingTax]; 
  });
  
  // 4. 作成したデータを C2:C4 のセル範囲へ一括書き込み!
  sheet.getRange("C2:C4").setValues(taxIncludedData);
  
  Logger.log("C列に税込価格を一括で書き込みました!");
}

💡 なぜ return [priceIncludingTax] とカッコ [ ] で囲むの?

ここが超重要ポイントです! Range.setValues() は、指定したマス目(縦×横)に合わせて 必ず2次元配列形式 でデータを渡さなければいけない決まりがあります。

もし return priceIncludingTax; と単体で返してしまうと、出来上がるのは [1320, 1265, 1210] という1次元配列になり、setValues() を実行したときに 「パラメータが一致しません」というエラー で止まってしまいます。

return [priceIncludingTax]; と [ ] で囲むことで、 [[1320], [1265], [1210]] という 「縦3行 × 横1列」の2次元配列 になり、C2:C4 の範囲に綺麗にセットできるようになるのです!

6. 初心者が絶対につまずく!map() の5大トラップと解決策

map() を使っていて「あれ?動かない…」「エラーが出た!」となったときは、以下の5つの落とし穴をチェックしてみてください。

トラップ1:return を書き忘れて全要素が undefined になる

最も多いミスです! map() の処理の中で return を書かないと、結果の配列の中身がすべて undefined(未定義)になってしまいます。

  • ✕ 失敗例
var result = prices.map(function(price) {
  price * 1.1; // return がない!
});
// result は [undefined, undefined, undefined] になる
  • ◯ 解決策:処理の最後で必ず return を書きましょう!

トラップ2:元の配列が書き換わる(上書きされる)と勘違いしている

map() は「新しい配列を作る」命令であり、元の配列は一切変更しません(非破壊的処理)。

  • ✕ 勘違いしやすい例
var prices = [100, 200, 300];
prices.map(price => price * 1.1);
// ここで prices を見ても [100, 200, 300] のまま!
  • ◯ 解決策:var newPrices = prices.map(...) のように、必ず新しい変数で結果を受け取るか、prices = prices.map(...) と代入し直しましょう。

トラップ3:setValues() に渡す配列の「次元」が合っていない

先ほど解説した通り、setValues() は2次元配列しか受け取りません。

  • エラーメッセージ例:Exception: The parameters (number[]) do not match the method signature for SpreadsheetApp.Range.setValues.
  • ◯ 解決策:map() の return 部分で return [加工した値]; のように [ ] で囲まれているか確認してください。

トラップ4:Array.filter() と頭の中でごっちゃになる

前回の filter() と今回の map() はどちらもよく使うため、混乱しやすいです。

メソッド目的返ってくる配列の要素数
Array.filter()条件に合う要素だけを**「絞り込む」**元の配列と同じか、少なくなる
Array.map()全要素を一定のルールで**「加工・変身させる」**元の配列と絶対に同じ個数

「数を減らしたいなら filter()」、「中身の形を変えたいなら map()」、と整理して覚えましょう!

トラップ5:アロー関数のカッコの有無による return の省略ミス

(※アロー関数の基本や記法についておさらいしたい方は、ぜひ第15回「Array.filter()」の記事も参照してくださいね!)

アロー関数を使う際、波カッコ { } を書くか書かないかで return の扱いが変わります。

// ◯ OK:波カッコなし ➡ 自動的に return される
var res1 = prices.map(price => price * 1.1);

// ✕ NG:波カッコありなのに return を省略している ➡ undefined になる!
var res2 = prices.map(price => { price * 1.1 });

// ◯ OK:波カッコありなら return を明記する
var res3 = prices.map(price => { return price * 1.1; });

慣れないうちは、省略せずに function(要素) { return ... } と丁寧に書くのが一番安全です!

7. 今回のまとめ&次回予告

今回は、配列データを一括で変換する Array.map() を超徹底解説しました。

今日の重要ポイント

  1. Array.map() は全要素を加工して「新しい配列」を作る命令
  2. for 文よりもコードがシンプルになり、読みやすくバグりにくい
  3. getValues() で取った2次元配列を加工し、setValues() で戻すときに超絶役立つ
  4. setValues() 用に整形するなら return [加工後の値] と [ ] で囲むのが鉄則

これで filter() による絞り込みと map() によるデータ加工が自在にできるようになりましたね!

次回(第17回)は、表の指定した位置に新しい行をサッと割り込み挿入する Sheet.insertRowBefore() を解説します。ログの自動記録やデータ追加で必須のテクニックですので、次回もお楽しみに!