LEFT

从文本字符串的开头返回指定数量的字符。

语法

expression.LEFT(arg1, arg2);

expression - 表示 ApiWorksheetFunction 类的变量。

参数

名称	必需/可选	数据类型	默认值	描述
arg1	必需	ApiRange | ApiName | string		包含要提取字符的文本字符串。
arg2	可选	ApiRange | ApiName | number		子字符串的字符数。必须大于或等于 0。

返回值

string

示例

此示例演示如何从文本字符串的开头返回指定数量的字符。

// How to find the number of characters starting from the index.

// Use a function to get a length of a text starting from the index.

let worksheet = Api.GetActiveSheet();
let func = Api.WorksheetFunction;
worksheet.GetRange("A1").SetValue(func.LEFT("Online Office", 6));