---
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: 3332
product: Flux
version: v0
---

# hex.string() function

-   Flux 0.131.0+
-   View InfluxDB support

`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

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

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

```

### Convert a boolean to a hexadecimal string value

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

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

```

### Convert a duration to a hexadecimal string value

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

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

```

### Convert a time to a hexadecimal string value

```js
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

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

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

```

### Convert a uinteger to a hexadecimal string value

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

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

```

### Convert a float to a hexadecimal string value

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

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

```

### Convert bytes to a hexadecimal string value

```js
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/)