文档首页/ 智能数据湖 AIDataLake/ Spark语法参考/ 内置函数/ 字符串函数/ ltrim
更新时间：2026-07-03 GMT+08:00
查看PDF
分享

ltrim

ltrim函数用于从str的左端去除字符：

  • 如果未指定trimChars，则默认去除空格。
  • 如果指定了trimChars，则以trimChars中包含的字符作为一个集合，从str的左端去除尽可能长的所有字符都在集合trimChars中的子串。

相似函数：

  • rtrim，rtrim函数用于从str的右端去除字符。
  • trim，trim函数用于从str的左右两端去除字符。

命令格式

ltrim([,] string )

参数说明

参数

是否必选

参数类型

说明

str

是

STRING

待去除左端字符的字符串。如果输入为BIGINT、DECIMAL、DOUBLE或DATETIME类型，则会隐式转换为STRING类型后参与运算。

trimChars

是

STRING

待去除的字符。

返回值说明

返回为STRING类型。

  • str非STRING、BIGINT、DOUBLE、DECIMAL或DATETIME类型时，返回报错。
  • str或trimChars值为NULL时，返回NULL。

示例代码

  • 去除字符串" abc"的左边空格。命令示例如下。

    返回字符串abc 。

    select ltrim('     abc');

    等效于如下语句。

    select trim(leading from '     abc');

    leading代表去除字符串前面的空格。

  • 输入参数为NULL。命令示例如下。

    返回NULL。

    select ltrim(null);      select ltrim('xy', null);     select ltrim(null, 'xy');
  • 去除字符串yxlucyxx左端所有字符都在集合xy中的子串。

    返回lucyxx，只要左端遇到x或者y就会被去掉。

    select ltrim( 'xy','yxlucyxx');

    等效于如下语句。

    select trim(leading 'xy' from 'yxlucyxx');
父主题： 字符串函数

相关文档