如何给自定义函数做备注及说明(1)

我们平时在使用Power Query中，针对比较繁琐的过程，都希望能生成一个函数来进行处理，平时使用的时候直接输入参数即可达到目的，而不需要每次都进行同样的代码输入。毕竟Power Query的存在本身就是自动化办公的作用，既然要作为自定义函数使用，那数量多了难免会不记得具体的用法，所以对自定义函数做备注就显得尤为重要。

这次我们来讲下，在Power Query中书写自定义函数的时候如何进行备注及说明。

(一) 在查询函数中声明类型

1. 声明变量类型

在函数描写过程中，在变量后加上as及变量类型

例：

let

合计=(x as number,y as number)=>x+y

in

合计

在函数简介的参数这里会出现示例类型。

2. 声明变量必选及可选

通过在变量前面加上optional可以声明变量为可选参数。

let

合计=(x as number , optional y)=>x+y

in

合计

声明变量类型的时候有一个是否可接受空值，如果可以接受空值null，则可以在什么变量类型前加上nullable前缀，则不需要进行optional声明可选。因为可包含空值原本就是一个可选选项。

特别要注意的是：

如果声明了函数的类型，又没有写optional或接受空值，则会作为必选参数；

如果未声明函数的类型，则会作为可选参数。

3. 声明函数返回类型

我们可以在公式表达式的最后添加声明返回值的类型。如果返回值非声明类型，则会报错。

例：

let

合计=(x as number , optional y as number)=>x+y as number

in

合计

解释：

我们看到虽然第2参数y是可选项，但是最终的返回结果是数字格式。我们知道在Power Query中任何和空值（null）进行计算的结果都是空值（null）。所以虽然我们这里的参数y是作为可选项，但是实际上是必填项，因为如果省略，返回结果是null，不符合返回声明的类型，会出错。