---
title: strings.toUpper() function
description: strings.toUpper() converts a string to uppercase.
url: https://docs.influxdata.com/flux/v0/stdlib/strings/toupper/
estimated_tokens: 941
product: Flux
version: v0
publisher: InfluxData
canonical: https://docs.influxdata.com/flux/v0/stdlib/strings/toupper/
date: '2024-04-08T16:01:02-06:00'
lastmod: '2024-04-08T16:01:02-06:00'
---

* Flux 0.18.0+

InfluxDB support

`strings.toUpper()` converts a string to uppercase.

#### toUpper vs toTitle

The results of `toUpper()` and `toTitle()` are often the same, however the
difference is visible when using special characters:

```no_run
str = "dz"

strings.toUpper(v: str) // Returns DZ
strings.toTitle(v: str) // Returns Dz
```

##### Function type signature

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

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

## Parameters

### v

(Required)
String value to convert.

## Examples

### Convert all values of a column to upper case

```js
import "sampledata"
import "strings"

sampledata.string()
    |> map(fn: (r) => ({r with _value: strings.toUpper(v: r._value)}))
```

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

View example input and output

#### Input data

|       \_time       |\*tag|  \_value   |
|--------------------|-----|------------|
|2021-01-01T00:00:00Z| t1  |smpl\_g9qczs|
|2021-01-01T00:00:10Z| t1  |smpl\_0mgv9n|
|2021-01-01T00:00:20Z| t1  |smpl\_phw664|
|2021-01-01T00:00:30Z| t1  |smpl\_guvzy4|
|2021-01-01T00:00:40Z| t1  |smpl\_5v3cce|
|2021-01-01T00:00:50Z| t1  |smpl\_s9fmgy|

|       \_time       |\*tag|  \_value   |
|--------------------|-----|------------|
|2021-01-01T00:00:00Z| t2  |smpl\_b5eida|
|2021-01-01T00:00:10Z| t2  |smpl\_eu4oxp|
|2021-01-01T00:00:20Z| t2  |smpl\_5g7tz4|
|2021-01-01T00:00:30Z| t2  |smpl\_sox1ut|
|2021-01-01T00:00:40Z| t2  |smpl\_wfm757|
|2021-01-01T00:00:50Z| t2  |smpl\_dtn2bv|

#### Output data

|       \_time       |  \_value   |\*tag|
|--------------------|------------|-----|
|2021-01-01T00:00:00Z|SMPL\_G9QCZS| t1  |
|2021-01-01T00:00:10Z|SMPL\_0MGV9N| t1  |
|2021-01-01T00:00:20Z|SMPL\_PHW664| t1  |
|2021-01-01T00:00:30Z|SMPL\_GUVZY4| t1  |
|2021-01-01T00:00:40Z|SMPL\_5V3CCE| t1  |
|2021-01-01T00:00:50Z|SMPL\_S9FMGY| t1  |

|       \_time       |  \_value   |\*tag|
|--------------------|------------|-----|
|2021-01-01T00:00:00Z|SMPL\_B5EIDA| t2  |
|2021-01-01T00:00:10Z|SMPL\_EU4OXP| t2  |
|2021-01-01T00:00:20Z|SMPL\_5G7TZ4| t2  |
|2021-01-01T00:00:30Z|SMPL\_SOX1UT| t2  |
|2021-01-01T00:00:40Z|SMPL\_WFM757| t2  |
|2021-01-01T00:00:50Z|SMPL\_DTN2BV| t2  |

#### Related

* [strings.toTitle() function](/flux/v0/stdlib/strings/totitle/)
* [strings.toLower() function](/flux/v0/stdlib/strings/tolower/)
* [strings.title() function](/flux/v0/stdlib/strings/title/)
| _time | *tag | _value |
| --- | --- | --- |
| _time | *tag | _value |
| 2021-01-01T00:00:00Z | t1 | smpl_g9qczs |
| 2021-01-01T00:00:10Z | t1 | smpl_0mgv9n |
| 2021-01-01T00:00:20Z | t1 | smpl_phw664 |
| 2021-01-01T00:00:30Z | t1 | smpl_guvzy4 |
| 2021-01-01T00:00:40Z | t1 | smpl_5v3cce |
| 2021-01-01T00:00:50Z | t1 | smpl_s9fmgy |

| _time | *tag | _value |
| --- | --- | --- |
| _time | *tag | _value |
| 2021-01-01T00:00:00Z | t2 | smpl_b5eida |
| 2021-01-01T00:00:10Z | t2 | smpl_eu4oxp |
| 2021-01-01T00:00:20Z | t2 | smpl_5g7tz4 |
| 2021-01-01T00:00:30Z | t2 | smpl_sox1ut |
| 2021-01-01T00:00:40Z | t2 | smpl_wfm757 |
| 2021-01-01T00:00:50Z | t2 | smpl_dtn2bv |

| _time | _value | *tag |
| --- | --- | --- |
| _time | _value | *tag |
| 2021-01-01T00:00:00Z | SMPL_G9QCZS | t1 |
| 2021-01-01T00:00:10Z | SMPL_0MGV9N | t1 |
| 2021-01-01T00:00:20Z | SMPL_PHW664 | t1 |
| 2021-01-01T00:00:30Z | SMPL_GUVZY4 | t1 |
| 2021-01-01T00:00:40Z | SMPL_5V3CCE | t1 |
| 2021-01-01T00:00:50Z | SMPL_S9FMGY | t1 |

| _time | _value | *tag |
| --- | --- | --- |
| _time | _value | *tag |
| 2021-01-01T00:00:00Z | SMPL_B5EIDA | t2 |
| 2021-01-01T00:00:10Z | SMPL_EU4OXP | t2 |
| 2021-01-01T00:00:20Z | SMPL_5G7TZ4 | t2 |
| 2021-01-01T00:00:30Z | SMPL_SOX1UT | t2 |
| 2021-01-01T00:00:40Z | SMPL_WFM757 | t2 |
| 2021-01-01T00:00:50Z | SMPL_DTN2BV | t2 |