elasticsearch/docs/reference/esql/functions/to_upper.asciidoc

[discrete]
[[esql-to_upper]]
=== `TO_UPPER`

*Syntax*

[.text-center]
image::esql/functions/signature/to_upper.svg[Embedded,opts=inline]

*Parameters*

`str`::
String expression. If `null`, the function returns `null`.

*Description*

Returns a new string representing the input string converted to upper case.

*Supported types*

include::types/to_upper.asciidoc[]

*Example*

[source.merge.styled,esql]
----
include::{esql-specs}/string.csv-spec[tag=to_upper]
----
[%header.monospaced.styled,format=dsv,separator=|]
|===
include::{esql-specs}/string.csv-spec[tag=to_upper-result]
|===