2022.07.10 2023.01.31

【GAS】スプレッドシートでコピー＆ペーストの実行の仕方！GASでどこまでできる？

momeq

モー

今回のテーマは、GAS（Google App Script）でのコピー＆ペーストをやって見ます。VBAと比較されがちなGASさんですが、どこまでできるのか？見ていきたいと思います。

＜VBAでのコピー＆ペーストはこちらから＞

この記事は・・・

GASでコピー＆ペーストをしたい人
ペーストのいろいろな方法を知っておきたい人
コピー以外の方法を知っておきたい人

にお勧めです。

ニャー

GASの使い方の初歩となるところだにゃ。是非憶えて欲しいんだにゃ。

リンク

Contents

コピーのやり方
代入という方法
エクセルとの違い
プログラミングを学ぶならTechAcademy（テックアカデミー）がおすすめ！

コピーのやり方

モー

GASでのコピー＆ペーストは、基本的にcopyTo()メソッドを使用してきます。使用方法は至ってシンプルで、コピーをしたいセルに繋げて記載するだけです。でも、引数が色々あって、引数の数でコピー方法が変わります。

ニャー

憶えておきたい方法は、３段階に分かれるんだにゃ。引数の数で変わるけど、引数の数が変わると渡す引数も変わるから、別々のものとして捉えた方が、憶えやすいと思うんだにゃ。

一番シンプルなコピー＆ペースト

モー

まずは、引数が１つの一番シンプルなコピー＆ペーストです。引数にコピー先を指定するだけ。指定する引数は、貼り付けたい場所の左上のセルをしてします。

オブジェクト.copyTo(コピー先)

オブジェクトを指定したコピー先にコピーする

function myFunction() {
  let sheet1 = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("シート1")
  let sheet2 = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("シート2")
  sheet1.getRange(1, 1, 5, 3).copyTo(sheet2.getRange(1, 1))
}

値orフォーマットを指定

モー

次に、引数を２つ指定する方法。値かフォーマットを貼り付けられるやり方です。

オブジェクト.copyTo(コピー先, オプション)

オブジェクトを指定したコピー先にコピーする

オプションを指定することで、コピーする内容を制限する

{オプション:true}の形で指定

オプション	タイプ	説明
`formatOnly`	true/false	フォーマットのみをコピー
`contentsOnly`	true/false	値のみをコピー

function myFunction() {
  let sheet1 = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("シート1")
  let sheet2 = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("シート2")
  sheet1.getRange(1, 1, 5, 3).copyTo(sheet2.getRange(1, 1), {contentsOnly:true})
}

様々な形式を指定

モー

最後が引数を３つ指定する方法。第２引数で何をペーストするかを指定できます。値だけ、フォーマットだけの他、数式、入力規則だけなど８つの中から選ぶことができます。そして、第３引数で、行と列を反転させる転置を行うかを指定できますね。

copyTo(コピー先, ペーストタイプ, 転置)

ペーストタイプ => SpreadsheetApp.CopyPasteType.ペーストタイプで指定

転置=>true or false で指定

オブジェクト.copyTo(コピー先, ペーストタイプ, 転置)

オブジェクトを指定したコピー先にコピーする

ペーストタイプでコピー内容を指定し、転置で列と行を反転させるかを選べる

ペーストタイプ => SpreadsheetApp.CopyPasteType.ペーストタイプで指定

転置=>true or false で指定

オプション名	タイプ	説明
`ペーストタイプ`	タイプを指定	値、数式、フォーマットなど何をコピーするのかを指定
転置	true/false	転置させるかどうか。転置とは行、列を逆転させること

`ペーストタイプ`	説明
`PASTE_NORMAL`	値、数式、フォーマット、およびマージの貼り付け。
`PASTE_NO_BORDERS`	値、数式、フォーマット、マージを貼り付け。ボーダーなし。
`PASTE_FORMAT`	フォーマットとデータ検証のみを貼り付け。
`PASTE_FORMULA`	数式のみを貼り付け。
`PASTE_DATA_VALIDATION`	データの入力規則のみを貼り付け。
`PASTE_VALUES`	値のみを貼り付け。
`PASTE_CONDITIONAL_FORMATTING`	条件式書式のみを貼り付け。
`PASTE_COLUMN_WIDTHS`	列幅のみを貼り付け。

function myFunction() {
  let sheet1 = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("シート1")
  let sheet2 = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("シート2")
  sheet1.getRange(1, 1, 5, 3).copyTo(sheet2.getRange(1, 1), SpreadsheetApp.CopyPasteType.PASTE_FORMULA, true)
  sheet1.getRange(1, 1, 5, 3).copyTo(sheet2.getRange(1, 1), SpreadsheetApp.CopyPasteType.PASTE_FORMAT, true)
}

代入という方法

モー

さて、次は値を入れるだけならば、代入でいいんじゃない？という考えで行うForループによるコピーです。正確には、値を順次、目的のセルに代入している感じです。

function myFunction() {
  let sheet1 = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("シート1")
  let sheet2 = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("シート2")
  let lastLow = sheet1.getLastRow()
  let lastColumn = sheet1.getLastColumn()
  for(let i = 1 ; i <= lastLow ; i++){
    for(let j = 1 ; j <= lastColumn ; j++){
      sheet2.getRange(i, j).setValue(sheet1.getRange(i, j).getValue())
    }
  }
}

ニャー

こちらは、値だけしか入れられないため、コピーよりも劣っている感じがするんだにゃ。でもループを利用したり、変数を使うことができるので、より柔軟に入力できるのが強みだにゃ。状況に合わせて、使い分けて欲しいんだにゃ。