GASでスプレッドシートの指定方向の次のセルを取得する方法

くら

GASでスプレッドシートの指定方向の次のセルを取得する方法を紹介します！

こんな人にむけた記事です。

GASを使って、スプレッドシートの指定方向の次のセルを取得したい人

指定方向の次のセルを取得：getNextDataCell(direction)
まとめ

指定方向の次のセルを取得：getNextDataCell(direction)

指定方向の次のセルを取得します。Ctrl+矢印キーと同じ動きをします。

パラメータ

名前	タイプ	説明
direction	Direction	指定する方向

戻り値

Range

端のセル

説明

function myFunction() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const range = ss.getSheetByName("サンプルA").getRange("C4");
  
  // 上方向の位置と値をログに出力する
  console.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getA1Notation());
  console.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getValue());
  
  // 下方向の位置と値をログに出力する
  console.log(range.getNextDataCell(SpreadsheetApp.Direction.DOWN).getA1Notation());
  console.log(range.getNextDataCell(SpreadsheetApp.Direction.DOWN).getValue());

  // 左方向の位置と値をログに出力する
  console.log(range.getNextDataCell(SpreadsheetApp.Direction.PREVIOUS).getA1Notation());
  console.log(range.getNextDataCell(SpreadsheetApp.Direction.PREVIOUS).getValue());
  
  // 右方向の位置と値をログに出力する
  console.log(range.getNextDataCell(SpreadsheetApp.Direction.NEXT).getA1Notation());
  console.log(range.getNextDataCell(SpreadsheetApp.Direction.NEXT).getValue());
}

C3の起点から、上下左右それぞれの端のセルを取得してみます。