---
title: hex.string() function
description: hex.string() converts a Flux basic type to a hexadecimal string.
url: https://docs.influxdata.com/flux/v0/stdlib/contrib/bonitoo-io/hex/string/
estimated_tokens: 1391
product: Flux
version: v0
publisher: InfluxData
canonical: https://docs.influxdata.com/flux/v0/stdlib/contrib/bonitoo-io/hex/string/
date: '2024-04-08T16:01:02-06:00'
lastmod: '2024-04-08T16:01:02-06:00'
---

* Flux 0.131.0+

InfluxDB support

> [!Important]
> `hex.string()` is a user-contributed function maintained by
> the [package author](#package-author-and-maintainer).

`hex.string()` converts a Flux basic type to a hexadecimal string.

The function is similar to `string()`, but encodes int, uint, and bytes
types to hexadecimal lowercase characters.

##### Function type signature

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

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

## Parameters

### v

(Required)
Value to convert.

## Examples

* [Convert integer to hexadecimal string](#convert-integer-to-hexadecimal-string)
* [Convert a boolean to a hexadecimal string value](#convert-a-boolean-to-a-hexadecimal-string-value)
* [Convert a duration to a hexadecimal string value](#convert-a-duration-to-a-hexadecimal-string-value)
* [Convert a time to a hexadecimal string value](#convert-a-time-to-a-hexadecimal-string-value)
* [Convert an integer to a hexadecimal string value](#convert-an-integer-to-a-hexadecimal-string-value)
* [Convert a uinteger to a hexadecimal string value](#convert-a-uinteger-to-a-hexadecimal-string-value)
* [Convert a float to a hexadecimal string value](#convert-a-float-to-a-hexadecimal-string-value)
* [Convert bytes to a hexadecimal string value](#convert-bytes-to-a-hexadecimal-string-value)
* [Convert all values in a column to hexadecimal string values](#convert-all-values-in-a-column-to-hexadecimal-string-values)

### Convert integer to hexadecimal string

```
import "contrib/bonitoo-io/hex"

hex.string(v: 1234)// Returns 4d2

```

### Convert a boolean to a hexadecimal string value

```
import "contrib/bonitoo-io/hex"

hex.string(v: true)// Returns "true"

```

### Convert a duration to a hexadecimal string value

```
import "contrib/bonitoo-io/hex"

hex.string(v: 1m)// Returns "1m"

```

### Convert a time to a hexadecimal string value

```
import "contrib/bonitoo-io/hex"

hex.string(v: 2021-01-01T00:00:00Z)// Returns "2021-01-01T00:00:00Z"

```

### Convert an integer to a hexadecimal string value

```
import "contrib/bonitoo-io/hex"

hex.string(v: 1234)// Returns "4d2"

```

### Convert a uinteger to a hexadecimal string value

```
import "contrib/bonitoo-io/hex"

hex.string(v: uint(v: 5678))// Returns "162e"

```

### Convert a float to a hexadecimal string value

```
import "contrib/bonitoo-io/hex"

hex.string(v: 10.12)// Returns "10.12"

```

### Convert bytes to a hexadecimal string value

```
import "contrib/bonitoo-io/hex"

hex.string(v: bytes(v: "Hello world!"))// Returns "48656c6c6f20776f726c6421"

```

### Convert all values in a column to hexadecimal string values

Use `map()` to iterate over and update all input rows.
Use `hex.string()` to update the value of a column.
The following example uses data provided by the sampledata package.

```js
import "sampledata"
import "contrib/bonitoo-io/hex"

data =
    sampledata.int()
        |> map(fn: (r) => ({r with _value: r._value * 1000}))

data
    |> map(fn: (r) => ({r with _value: hex.string(v: r.foo)}))
```

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

View example input and output

#### Input data

|       \_time       |\_value|\*tag|
|--------------------|-------|-----|
|2021-01-01T00:00:00Z|\-2000 | t1  |
|2021-01-01T00:00:10Z| 10000 | t1  |
|2021-01-01T00:00:20Z| 7000  | t1  |
|2021-01-01T00:00:30Z| 17000 | t1  |
|2021-01-01T00:00:40Z| 15000 | t1  |
|2021-01-01T00:00:50Z| 4000  | t1  |

|       \_time       |\_value|\*tag|
|--------------------|-------|-----|
|2021-01-01T00:00:00Z| 19000 | t2  |
|2021-01-01T00:00:10Z| 4000  | t2  |
|2021-01-01T00:00:20Z|\-3000 | t2  |
|2021-01-01T00:00:30Z| 19000 | t2  |
|2021-01-01T00:00:40Z| 13000 | t2  |
|2021-01-01T00:00:50Z| 1000  | t2  |

#### Output data

|       \_time       |\_value|\*tag|
|--------------------|-------|-----|
|2021-01-01T00:00:00Z|       | t1  |
|2021-01-01T00:00:10Z|       | t1  |
|2021-01-01T00:00:20Z|       | t1  |
|2021-01-01T00:00:30Z|       | t1  |
|2021-01-01T00:00:40Z|       | t1  |
|2021-01-01T00:00:50Z|       | t1  |

|       \_time       |\_value|\*tag|
|--------------------|-------|-----|
|2021-01-01T00:00:00Z|       | t2  |
|2021-01-01T00:00:10Z|       | t2  |
|2021-01-01T00:00:20Z|       | t2  |
|2021-01-01T00:00:30Z|       | t2  |
|2021-01-01T00:00:40Z|       | t2  |
|2021-01-01T00:00:50Z|       | t2  |

#### Related

* [string() function](/flux/v0/stdlib/universe/string/)
| _time | _value | *tag |
| --- | --- | --- |
| _time | _value | *tag |
| 2021-01-01T00:00:00Z | -2000 | t1 |
| 2021-01-01T00:00:10Z | 10000 | t1 |
| 2021-01-01T00:00:20Z | 7000 | t1 |
| 2021-01-01T00:00:30Z | 17000 | t1 |
| 2021-01-01T00:00:40Z | 15000 | t1 |
| 2021-01-01T00:00:50Z | 4000 | t1 |

| _time | _value | *tag |
| --- | --- | --- |
| _time | _value | *tag |
| 2021-01-01T00:00:00Z | 19000 | t2 |
| 2021-01-01T00:00:10Z | 4000 | t2 |
| 2021-01-01T00:00:20Z | -3000 | t2 |
| 2021-01-01T00:00:30Z | 19000 | t2 |
| 2021-01-01T00:00:40Z | 13000 | t2 |
| 2021-01-01T00:00:50Z | 1000 | t2 |

| _time | _value | *tag |
| --- | --- | --- |
| _time | _value | *tag |
| 2021-01-01T00:00:00Z |  | t1 |
| 2021-01-01T00:00:10Z |  | t1 |
| 2021-01-01T00:00:20Z |  | t1 |
| 2021-01-01T00:00:30Z |  | t1 |
| 2021-01-01T00:00:40Z |  | t1 |
| 2021-01-01T00:00:50Z |  | t1 |

| _time | _value | *tag |
| --- | --- | --- |
| _time | _value | *tag |
| 2021-01-01T00:00:00Z |  | t2 |
| 2021-01-01T00:00:10Z |  | t2 |
| 2021-01-01T00:00:20Z |  | t2 |
| 2021-01-01T00:00:30Z |  | t2 |
| 2021-01-01T00:00:40Z |  | t2 |
| 2021-01-01T00:00:50Z |  | t2 |