# recordMeasurement

[Built-ins](README.md) · [Labs guide](../guides/labs.md)

Canonical ID: `measurements.record`. Nederlands: `voegMetingToe`.

Adds a reading at a strictly later, nonnegative time. Value is a finite Number or none for a missing reading. When full, the oldest sample is dropped.

## Signature

```text
recordMeasurement(series, time, value)
```

## Return value and behavior

A new series Map; the input series stays unchanged.

The helper returns a new value. Use set/zet when updating a variable; the earlier value stays unchanged.

## Example

```pliro
# language: en
let readings = measurementSeries("Height", "m")
set readings = recordMeasurement(readings, 0.1, 2)
```