getValues

function getValues<T = unknown>(
  target: GoogleAppsScript.Spreadsheet.Sheet | GoogleAppsScript.Spreadsheet.Range,
  config: GetValuesConfig | null | undefined = {}
): T[];

Ist headerRow gesetzt, kommt jede Zeile als Objekt mit den Spaltennamen als Schlüsseln — genau das macht einen Filter lesbar: row.status statt row[4]. Wiederholt sich ein Name, gewinnt die linke Spalte.

filter engt die Zeilen ein, offset und limit blättern durch den Rest, und mapper bestimmt, was aus jeder übrigen Zeile wird. display liest die Werte so, wie ein Mensch sie sieht — ein formatiertes Datum als Text statt als Date. Das ist anderer Inhalt, keine Kosmetik.

Ein Blatt liest seinen ganzen Datenbereich; ein Bereich liest nur sich selbst — ein Dienstaufruf über einen Block statt über alles. Positionen bleiben eins-basiert im Blatt, eine Zeile behält also ihre echte Nummer, und headerRow benennt eine Zeile des Blatts, keinen Versatz im Bereich.

Parameter

Parameter	Typ	Beschreibung
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	Das zu lesende Blatt oder der zu lesende Bereich: geholt werden nur dessen Zellen.
`config` (optional) `= {}`	`GetValuesConfig \\| null \\| undefined`	`headerRow`, `display`, `filter`, `offset`, `limit` und `mapper`.

Rückgabewert

T[] — die verbliebenen Zeilen in der Reihenfolge des Blattes.

Ausnahmen

Ausnahme	Bedingung
`InvalidSheetException`	das erste Argument weder ein Blatt noch ein Bereich ist.

Beispiele

Zeilen lesen

const sheet = SpreadsheetApp.getActiveSheet();

const active = getValues(sheet, {
  headerRow: 1,
  filter: (row) => row.status === "active",
  mapper: (row) => row.email,
  limit: 100
});

Einen Block lesen

const sheet = SpreadsheetApp.getActiveSheet();

// Only A1:C50 is fetched; the header is row 1 of the sheet.
const rows = getValues(sheet.getRange("A1:C50"), { headerRow: 1 });

Siehe auch

Quellcode

src/appsscript/sheet/getValues.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.