[{"id":"dc3147d7-d3fb-4bc1-b1b3-142c0633e6d3","tags":[{"name":"New","color":"Red","productId":"c15646e4-63d8-4965-8d62-7549a2986e99","links":null,"id":"c3c0ef13-c7a9-4649-9fcb-23b3abec175d"}]},{"id":"ca5ca1be-6d75-4ad1-880e-1589e3d52695","tags":[{"name":"New","color":"Red","productId":"c15646e4-63d8-4965-8d62-7549a2986e99","links":null,"id":"c3c0ef13-c7a9-4649-9fcb-23b3abec175d"}]},{"id":"ea870089-5ea1-499a-bb0c-29cf378ead8d","tags":[{"name":"New","color":"Red","productId":"c15646e4-63d8-4965-8d62-7549a2986e99","links":null,"id":"c3c0ef13-c7a9-4649-9fcb-23b3abec175d"}]},{"id":"d304d34f-f329-4f3b-b45e-2acb478427f8","tags":[{"name":"New","color":"Red","productId":"c15646e4-63d8-4965-8d62-7549a2986e99","links":null,"id":"c3c0ef13-c7a9-4649-9fcb-23b3abec175d"}]},{"id":"3a79d24d-b853-4a51-a1e4-361feab06c57","tags":[{"name":"Upd","color":"Blue","productId":"c15646e4-63d8-4965-8d62-7549a2986e99","links":null,"id":"2f377cfe-f512-431a-895b-f89af32041ce"}]},{"id":"5d31b3db-69bb-4388-9a57-450a63e44456","tags":[{"name":"Upd","color":"Blue","productId":"c15646e4-63d8-4965-8d62-7549a2986e99","links":null,"id":"2f377cfe-f512-431a-895b-f89af32041ce"}]},{"id":"95e6d892-7bcd-4f6a-a152-504dec37c741","tags":[{"name":"New","color":"Red","productId":"c15646e4-63d8-4965-8d62-7549a2986e99","links":null,"id":"c3c0ef13-c7a9-4649-9fcb-23b3abec175d"}]},{"id":"ec137f4b-3069-487f-bb0c-69f40fe6805d","tags":[{"name":"New","color":"Red","productId":"c15646e4-63d8-4965-8d62-7549a2986e99","links":null,"id":"c3c0ef13-c7a9-4649-9fcb-23b3abec175d"}]},{"id":"9a2b2f20-5f3d-43a4-90d0-6f517fd3eebc","tags":[{"name":"Upd","color":"Blue","productId":"c15646e4-63d8-4965-8d62-7549a2986e99","links":null,"id":"2f377cfe-f512-431a-895b-f89af32041ce"}]},{"id":"8d43dc09-ddd1-4c42-8b02-90765c4c705b","tags":[{"name":"New","color":"Red","productId":"c15646e4-63d8-4965-8d62-7549a2986e99","links":null,"id":"c3c0ef13-c7a9-4649-9fcb-23b3abec175d"}]},{"id":"a0c3d1e1-4a95-4eaf-808e-93242f2f9aee","tags":[{"name":"Upd","color":"Blue","productId":"c15646e4-63d8-4965-8d62-7549a2986e99","links":null,"id":"2f377cfe-f512-431a-895b-f89af32041ce"}]},{"id":"bd44c5b0-cd6b-443c-95dc-b8d8054fe1d7","tags":[{"name":"New","color":"Red","productId":"c15646e4-63d8-4965-8d62-7549a2986e99","links":null,"id":"c3c0ef13-c7a9-4649-9fcb-23b3abec175d"}]},{"id":"fd5ccaa1-50b7-4c33-9ec5-c1eb48317119","tags":[{"name":"Upd","color":"Blue","productId":"c15646e4-63d8-4965-8d62-7549a2986e99","links":null,"id":"2f377cfe-f512-431a-895b-f89af32041ce"}]},{"id":"ea61139a-0ecf-45ba-83c3-c2f8b20a4126","tags":[{"name":"New","color":"Red","productId":"c15646e4-63d8-4965-8d62-7549a2986e99","links":null,"id":"c3c0ef13-c7a9-4649-9fcb-23b3abec175d"}]},{"id":"ca986d5e-dfda-46e9-84f3-f44e4248ab94","tags":[{"name":"Upd","color":"Blue","productId":"c15646e4-63d8-4965-8d62-7549a2986e99","links":null,"id":"2f377cfe-f512-431a-895b-f89af32041ce"}]}]
        
(Showing Draft Content)

LET

This function is used to assign names to calculation results. The variable names can then be used to store intermediate calculations, values, or defining names within braces of the LET() function. To use this function, you have to define pairs of names and values associated with it and a calculation that uses them all.


By using this function, users do not have to remember what a specific range or cell reference referred to, what your calculation is supposed to do or even copy-pasting the same expression all over again.

Syntax

LET(name1, name_value1, calculation_or_name2, [name_value2, calculation_or_name3...])

Arguments

This function has these arguments:

Argument

Description

name

First name to assign. Must always begin with a letter and should not contain a '.'

name_value1

The value that is assigned to name1.

calculation_or_name2

You can define one of the following.

  • A calculation that uses all names within the LET function. This must be the last argument in the LET function.

  • A second name to be assigned to a second name_value. If a name is specified, name_value2 and calculation_or_name3 become required.

name_value2

[Optional] The value or calculation that is assigned to calculation_or_name2.

calculation_or_name3

[Optional] You can define one of the following.

  • A calculation that uses all names within the LET function. This must be the last argument of this function.

  • A third name to assign to a third name_value. If a name is specified, name_value3 and calculation_or_name4 become required.

Data Types

Returns variant data type.

Remarks

The last argument must always be a calculation that returns a result.

Examples

The following code sample shows the basic usage of the LET function.

var formula = '=LET(x,2,x+3)';
sheet1.setValue(2, 0, 'Pair varible');
sheet1.setValue(2, 1, formula);
sheet1.setValue(3, 0, 'Result');
sheet1.setFormula(3, 1, formula);

The following code sample shows the usage of the LET local variable and custom name with the LET function.

sheet1.addCustomName('user', '="Michael"');
                
var formula = '=LET(user,"Ivy","The actual user is: "&user)';
sheet1.setValue(2, 0, 'Always use LET local variable first');
sheet1.setValue(2, 1, formula);
sheet1.setValue(3, 0, 'Result');
sheet1.setFormula(3, 1, formula);

// Use custom name if local variable is not available
var formula = '=LET(user,user,"The actual user is: "&user)';
sheet1.setValue(5, 0, 'Use custom name if local variable is not available');
sheet1.setValue(5, 1, formula);
sheet1.setValue(6, 0, 'Result');
sheet1.setFormula(6, 1, formula);

Note: The name argument should not contain a '.' and has been updated to match Excel's updated behavior. Refer Release Notes for Version 14.1.0 to learn more.