---
title: uint() function
description: uint() converts a value to an unsigned integer type.
url: https://docs.influxdata.com/flux/v0/stdlib/universe/uint/
estimated_tokens: 1273
product: Flux
version: v0
publisher: InfluxData
canonical: https://docs.influxdata.com/flux/v0/stdlib/universe/uint/
date: '2024-04-08T16:01:02-06:00'
lastmod: '2024-04-08T16:01:02-06:00'
---

* Flux 0.7.0+

InfluxDB support

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

`uint()` behavior depends on the input data type:

|Input type|                        Returned value                         |
|----------|---------------------------------------------------------------|
|   bool   |                     1 (true) or 0 (false)                     |
| duration |        Number of nanoseconds in the specified duration        |
|  float   |UInteger equivalent of the float value truncated at the decimal|
|   int    |              UInteger equivalent of the integer               |
|  string  |           UInteger equivalent of the numeric string           |
|   time   |             Equivalent nanosecond epoch timestamp             |

##### Function type signature

```js
(v: A) => uint
```

For more information, see [Function type signatures](/flux/v0/function-type-signatures/).

## Parameters

### v

(Required)
Value to convert.

## Examples

* [Convert basic types to unsigned integers](#convert-basic-types-to-unsigned-integers)
* [Convert all values in a column to unsigned integers](#convert-all-values-in-a-column-to-unsigned-integers)

### Convert basic types to unsigned integers

```
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)}))
```

[](#view-example-input-and-output)

View example input and output

#### Input data

|       \_time       |exampleCol|\*tag|
|--------------------|----------|-----|
|2021-01-01T00:00:00Z|   \-2    | t1  |
|2021-01-01T00:00:10Z|    10    | t1  |
|2021-01-01T00:00:20Z|    7     | t1  |
|2021-01-01T00:00:30Z|    17    | t1  |
|2021-01-01T00:00:40Z|    15    | t1  |
|2021-01-01T00:00:50Z|    4     | t1  |

|       \_time       |exampleCol|\*tag|
|--------------------|----------|-----|
|2021-01-01T00:00:00Z|    19    | t2  |
|2021-01-01T00:00:10Z|    4     | t2  |
|2021-01-01T00:00:20Z|   \-3    | t2  |
|2021-01-01T00:00:30Z|    19    | t2  |
|2021-01-01T00:00:40Z|    13    | t2  |
|2021-01-01T00:00:50Z|    1     | t2  |

#### Output data

|       \_time       |     exampleCol     |\*tag|
|--------------------|--------------------|-----|
|2021-01-01T00:00:00Z|18446744073709551614| t1  |
|2021-01-01T00:00:10Z|         10         | t1  |
|2021-01-01T00:00:20Z|         7          | t1  |
|2021-01-01T00:00:30Z|         17         | t1  |
|2021-01-01T00:00:40Z|         15         | t1  |
|2021-01-01T00:00:50Z|         4          | t1  |

|       \_time       |     exampleCol     |\*tag|
|--------------------|--------------------|-----|
|2021-01-01T00:00:00Z|         19         | t2  |
|2021-01-01T00:00:10Z|         4          | t2  |
|2021-01-01T00:00:20Z|18446744073709551613| t2  |
|2021-01-01T00:00:30Z|         19         | t2  |
|2021-01-01T00:00:40Z|         13         | t2  |
|2021-01-01T00:00:50Z|         1          | t2  |

#### Related

* [Work with unsigned integers](/flux/v0/data-types/basic/uint/)
* [toUInt() function](/flux/v0/stdlib/universe/touint/)

[type-conversions](/flux/v0/tags/type-conversions/)
| Input type | Returned value |
| --- | --- |
| Input type | Returned value |
| bool | 1 (true) or 0 (false) |
| duration | Number of nanoseconds in the specified duration |
| float | UInteger equivalent of the float value truncated at the decimal |
| int | UInteger equivalent of the integer |
| string | UInteger equivalent of the numeric string |
| time | Equivalent nanosecond epoch timestamp |

| _time | exampleCol | *tag |
| --- | --- | --- |
| _time | exampleCol | *tag |
| 2021-01-01T00:00:00Z | -2 | t1 |
| 2021-01-01T00:00:10Z | 10 | t1 |
| 2021-01-01T00:00:20Z | 7 | t1 |
| 2021-01-01T00:00:30Z | 17 | t1 |
| 2021-01-01T00:00:40Z | 15 | t1 |
| 2021-01-01T00:00:50Z | 4 | t1 |

| _time | exampleCol | *tag |
| --- | --- | --- |
| _time | exampleCol | *tag |
| 2021-01-01T00:00:00Z | 19 | t2 |
| 2021-01-01T00:00:10Z | 4 | t2 |
| 2021-01-01T00:00:20Z | -3 | t2 |
| 2021-01-01T00:00:30Z | 19 | t2 |
| 2021-01-01T00:00:40Z | 13 | t2 |
| 2021-01-01T00:00:50Z | 1 | t2 |

| _time | exampleCol | *tag |
| --- | --- | --- |
| _time | exampleCol | *tag |
| 2021-01-01T00:00:00Z | 18446744073709551614 | t1 |
| 2021-01-01T00:00:10Z | 10 | t1 |
| 2021-01-01T00:00:20Z | 7 | t1 |
| 2021-01-01T00:00:30Z | 17 | t1 |
| 2021-01-01T00:00:40Z | 15 | t1 |
| 2021-01-01T00:00:50Z | 4 | t1 |

| _time | exampleCol | *tag |
| --- | --- | --- |
| _time | exampleCol | *tag |
| 2021-01-01T00:00:00Z | 19 | t2 |
| 2021-01-01T00:00:10Z | 4 | t2 |
| 2021-01-01T00:00:20Z | 18446744073709551613 | t2 |
| 2021-01-01T00:00:30Z | 19 | t2 |
| 2021-01-01T00:00:40Z | 13 | t2 |
| 2021-01-01T00:00:50Z | 1 | t2 |
