appendColumn

function appendColumn(
  target: GoogleAppsScript.Spreadsheet.Sheet | GoogleAppsScript.Spreadsheet.Range,
  values: unknown,
  options: Options | null | undefined = {}
): GoogleAppsScript.Spreadsheet.Sheet;

Die Werte füllen die Spalte von oben nach unten: ein Wert je Zeile. Ein Blatt wird ganz betrachtet und die Spalte ab Zeile 1 geschrieben; ein Bereich wird nur in sich betrachtet und die Spalte auf seinen Zeilen geschrieben, rechts der letzten Spalte des Bereichs mit Daten.

Es ist appendColumns mit einer Spalte: dieselben Prüfungen, dasselbe Wachsen des Blatts, wenn das Ergebnis nicht passt, und dieselbe Regel, dass eine Zelle mit = zur Formel wird.

Parameter

Parameter	Typ	Beschreibung
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	Das Blatt, an das angefügt wird, oder der Bereich, innerhalb dessen angefügt wird.
`values`	`unknown`	Eine einzelne Spalte: ein flaches Array, ein Wert je Zeile.
`options` (optional) `= {}`	`Options \\| null \\| undefined`	`afterFrozenColumns` beginnt hinter den fixierten Spalten, wenn die Daten davor enden.

Rückgabewert

GoogleAppsScript.Spreadsheet.Sheet — das Blatt, sodass Aufrufe verkettet werden können.

Ausnahmen

Ausnahme	Bedingung
`IllegalArgumentException`	kein Argument übergeben wurde.
`InvalidSheetException`	das erste Argument weder ein Blatt noch ein Bereich ist.
`TypeError`	die Werte kein flaches Array sind.

Beispiele

An ein Blatt anfügen

const sheet = SpreadsheetApp.getActiveSheet();

appendColumn(sheet, ["status", "new", "new"]);

Innerhalb eines Bereichs anfügen

const sheet = SpreadsheetApp.getActiveSheet();

appendColumn(sheet.getRange("A1:D3"), ["status", "new", "new"]);

Siehe auch

Quellcode

src/appsscript/sheet/appendColumn.ts

23 September 2026

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