ContextQMD
Back to Influxdb

math.roundtoeven() function

content/flux/v0/stdlib/math/roundtoeven.md

latest2.9 KB
Original Source
<!------------------------------------------------------------------------------ IMPORTANT: This page was generated from comments in the Flux source code. Any edits made directly to this page will be overwritten the next time the documentation is generated. To make updates to this documentation, update the function comments above the function definition in the Flux source code: https://github.com/influxdata/flux/blob/master/stdlib/math/math.flux#L1934-L1934 Contributing to Flux: https://github.com/influxdata/flux#contributing Fluxdoc syntax: https://github.com/influxdata/flux/blob/master/docs/fluxdoc.md ------------------------------------------------------------------------------->

math.roundtoeven() returns the nearest integer, rounding ties to even.

Function type signature
js
(x: float) => float

{{% caption %}} For more information, see Function type signatures. {{% /caption %}}

Parameters

x

({{< req >}}) Value to operate on.

Examples

Round a value to the nearest integer

js
import "math"

math.roundtoeven(x: 3.14)

// 3.0
math.roundtoeven(x: 3.5)// 4.0

Use math.roundtoeven in map

js
import "math"
import "sampledata"

sampledata.float()
    |> map(fn: (r) => ({r with _value: math.roundtoeven(x: r._value)}))

{{< expand-wrapper >}} {{% expand "View example input and output" %}}

Input data

_time*tag_value
2021-01-01T00:00:00Zt1-2.18
2021-01-01T00:00:10Zt110.92
2021-01-01T00:00:20Zt17.35
2021-01-01T00:00:30Zt117.53
2021-01-01T00:00:40Zt115.23
2021-01-01T00:00:50Zt14.43
_time*tag_value
2021-01-01T00:00:00Zt219.85
2021-01-01T00:00:10Zt24.97
2021-01-01T00:00:20Zt2-3.75
2021-01-01T00:00:30Zt219.77
2021-01-01T00:00:40Zt213.86
2021-01-01T00:00:50Zt21.86

Output data

_time_value*tag
2021-01-01T00:00:00Z-2t1
2021-01-01T00:00:10Z11t1
2021-01-01T00:00:20Z7t1
2021-01-01T00:00:30Z18t1
2021-01-01T00:00:40Z15t1
2021-01-01T00:00:50Z4t1
_time_value*tag
2021-01-01T00:00:00Z20t2
2021-01-01T00:00:10Z5t2
2021-01-01T00:00:20Z-4t2
2021-01-01T00:00:30Z20t2
2021-01-01T00:00:40Z14t2
2021-01-01T00:00:50Z2t2

{{% /expand %}} {{< /expand-wrapper >}}