# ln
ln函数用于返回给定数值的自然对数。
#### 命令格式
```
ln(DOUBLE a)
```
#### 参数说明
表1参数说明 
| 参数 | 是否必选 | 参数类型                            | 说明                                                                                                                        |
|:---|:---|:---|:---|
| a  | 是    | DOUBLE、BIGINT、DECIMAL、STRING类型。 | 参数a的格式包括浮点数格式、整数格式、字符串格式。 参数a非DOUBLE类型时，会隐式转换为DOUBLE类型后参与运算。 |
   
#### 返回值说明
返回DOUBLE类型的值。
![](https://support.huaweicloud.com/sqlref-spark-dli/public_sys-resources/note_3.0-zh-cn.png)
- a值为负数或0时，返回NULL。
- a值为NULL时，返回NULL。
 
#### 示例代码
返回1.144729868791239。
```
select ln(3.1415926);
```
返回1。
```
select ln(2.718281828459045);
```
返回NULL。
```
select ln(null);
```