series_fill_forward()

  • Artikel

Führt eine Vorwärtsfüllinterpolation fehlender Werte in einer Reihe durch.

Ein Ausdruck, der ein dynamisches numerisches Array enthält, ist die Eingabe. Die Funktion ersetzt alle Instanzen von missing_value_placeholder durch den nächstgelegenen Wert von der linken Seite als missing_value_placeholder und gibt das resultierende Array zurück. Die linkssten Instanzen von missing_value_placeholder werden beibehalten.

Syntax

series_fill_forward(Serie, [ missing_value_placeholder ])

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Typ Erforderlich BESCHREIBUNG
Serie dynamic ✔️ Ein Array numerischer Werte.
missing_value_placeholder Skalar Gibt einen Platzhalter für fehlende Werte an. Der Standardwert ist double(NULL). Der Wert kann von einem beliebigen Typ sein, der in tatsächliche Elementtypen konvertiert wird. double(null), long(null) und int(null) haben die gleiche Bedeutung.

Gibt zurück

Serie mit allen Instanzen von missing_value_placeholder vorwärts ausgefüllt.

Hinweis

  • Wenn Sie Serien mit dem Make-Series-Operator erstellen, geben Sie null als Standardwert an, um Interpolationsfunktionen wie series_fill_forward() danach zu verwenden. Siehe Erklärung.
  • Wenn missing_value_placeholder (NULL) ist oder ausgelassen wirddouble, kann ein Ergebnis NULL-Werte enthalten. Um diese NULL-Werte zu füllen, verwenden Sie andere Interpolationsfunktionen. Nur series_outliers() unterstützt NULL-Werte in Eingabearrays.
  • series_fill_forward() behält den ursprünglichen Typ der Arrayelemente bei.

Beispiel

Abfrage ausführen

let data = datatable(arr: dynamic)
    [
    dynamic([null, null, 36, 41, null, null, 16, 61, 33, null, null])   
];
data 
| project
    arr, 
    fill_forward = series_fill_forward(arr)

Ausgabe

arr fill_forward
[null,null,36,41,null,null,16,61,33,null,null,null] [null,null,36,41,41,41,16,61,33,33,33,33]

Verwenden Sie series_fill_backward oder series-fill-const , um die Interpolation des obigen Arrays abzuschließen.