Back to Influxdb

uint() function

content/flux/v0/stdlib/universe/uint.md

latest4.2 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/universe/universe.flux#L3442-L3442 Contributing to Flux: https://github.com/influxdata/flux#contributing Fluxdoc syntax: https://github.com/influxdata/flux/blob/master/docs/fluxdoc.md ------------------------------------------------------------------------------->

uint() converts a value to an unsigned integer type.

uint() behavior depends on the input data type:

Input typeReturned value
bool1 (true) or 0 (false)
durationNumber of nanoseconds in the specified duration
floatUInteger equivalent of the float value truncated at the decimal
intUInteger equivalent of the integer
stringUInteger equivalent of the numeric string
timeEquivalent nanosecond epoch timestamp
Function type signature
js
(v: A) => uint

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

Parameters

v

({{< req >}}) Value to convert.

Examples

Convert basic types to unsigned integers

js
uint(v: "3")

// Returns 3
uint(v: 1m)

// Returns 160000000000
uint(v: 2022-01-01T00:00:00Z)

// Returns 1640995200000000000
uint(v: 10.12)

// Returns 10
uint(v: -100)// Returns 18446744073709551516


Convert all values in a column to unsigned integers

If converting the _value column to uint types, use toUInt(). If converting columns other than _value, use map() to iterate over each row and uint() to convert a column value to a uint type.

js
data
    |> map(fn: (r) => ({r with exampleCol: uint(v: r.exampleCol)}))

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

Input data

_timeexampleCol*tag
2021-01-01T00:00:00Z-2t1
2021-01-01T00:00:10Z10t1
2021-01-01T00:00:20Z7t1
2021-01-01T00:00:30Z17t1
2021-01-01T00:00:40Z15t1
2021-01-01T00:00:50Z4t1
_timeexampleCol*tag
2021-01-01T00:00:00Z19t2
2021-01-01T00:00:10Z4t2
2021-01-01T00:00:20Z-3t2
2021-01-01T00:00:30Z19t2
2021-01-01T00:00:40Z13t2
2021-01-01T00:00:50Z1t2

Output data

_timeexampleCol*tag
2021-01-01T00:00:00Z18446744073709551614t1
2021-01-01T00:00:10Z10t1
2021-01-01T00:00:20Z7t1
2021-01-01T00:00:30Z17t1
2021-01-01T00:00:40Z15t1
2021-01-01T00:00:50Z4t1
_timeexampleCol*tag
2021-01-01T00:00:00Z19t2
2021-01-01T00:00:10Z4t2
2021-01-01T00:00:20Z18446744073709551613t2
2021-01-01T00:00:30Z19t2
2021-01-01T00:00:40Z13t2
2021-01-01T00:00:50Z1t2

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