All Products
Search
Document Center

MaxCompute:TOLOWER

Last Updated:Mar 26, 2026

Converts all uppercase letters in a string to lowercase.

Syntaxstring tolower(string <source>)
ReturnsSTRING
Exampletolower('aBcd')'abcd'

Parameters

ParameterRequiredTypeDescription
sourceYesSTRINGThe string to convert. BIGINT, DOUBLE, DECIMAL, and DATETIME values are implicitly converted to STRING before processing. Only English characters are supported.

Return value

Returns a STRING value.

  • If source is of an unsupported type (not STRING, BIGINT, DOUBLE, DECIMAL, or DATETIME), an error is returned.

  • If source is null, null is returned.

Examples

-- Returns 'abcd'
SELECT tolower('aBcd');

-- Returns 'china fighting'
SELECT tolower('China Fighting');

-- Returns null
SELECT tolower(null);

Related functions

tolower is a string function. For other string search and conversion functions, see String functions.