@rowsncolumns/functions 15.0.2 → 15.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/Readme.md +21 -3
- package/dist/cjs/descriptions.d.ts +16 -0
- package/dist/cjs/descriptions.d.ts.map +1 -0
- package/dist/cjs/descriptions.js +18 -0
- package/dist/cjs/function-descriptions.d.ts.map +1 -1
- package/dist/cjs/function-descriptions.js +933 -0
- package/dist/cjs/tsconfig.cjs.tsbuildinfo +1 -1
- package/dist/esm/descriptions.d.ts +16 -0
- package/dist/esm/descriptions.d.ts.map +1 -0
- package/dist/esm/descriptions.js +14 -0
- package/dist/esm/function-descriptions.d.ts.map +1 -1
- package/dist/esm/function-descriptions.js +933 -0
- package/dist/esm/tsconfig.esm.tsbuildinfo +1 -1
- package/package.json +14 -6
|
@@ -9805,4 +9805,937 @@ exports.functionDescriptions = [
|
|
|
9805
9805
|
},
|
|
9806
9806
|
],
|
|
9807
9807
|
},
|
|
9808
|
+
{
|
|
9809
|
+
datatype: "Logical",
|
|
9810
|
+
title: "LET",
|
|
9811
|
+
syntax: "LET(name1, value1, [name2, value2], …, calculation)",
|
|
9812
|
+
description: "Assigns names to calculation results so a value is computed once and reused by name inside the final calculation.",
|
|
9813
|
+
example: "LET(x, A1*2, x+x)",
|
|
9814
|
+
usage: [
|
|
9815
|
+
"LET(x, A1*2, x+x)",
|
|
9816
|
+
"LET(total, SUM(A1:A10), count, COUNT(A1:A10), total/count)",
|
|
9817
|
+
],
|
|
9818
|
+
parameters: [
|
|
9819
|
+
{
|
|
9820
|
+
title: "name1",
|
|
9821
|
+
description: "The first name to assign. Must begin with a letter and cannot look like a cell reference.",
|
|
9822
|
+
},
|
|
9823
|
+
{
|
|
9824
|
+
title: "value1",
|
|
9825
|
+
description: "The value assigned to name1.",
|
|
9826
|
+
},
|
|
9827
|
+
{
|
|
9828
|
+
title: "name2, value2, … [OPTIONAL]",
|
|
9829
|
+
description: "Additional name/value pairs; each value can use the names assigned before it.",
|
|
9830
|
+
},
|
|
9831
|
+
{
|
|
9832
|
+
title: "calculation",
|
|
9833
|
+
description: "The expression that uses the assigned names; its result is the result of LET.",
|
|
9834
|
+
},
|
|
9835
|
+
],
|
|
9836
|
+
},
|
|
9837
|
+
{
|
|
9838
|
+
datatype: "Logical",
|
|
9839
|
+
title: "LAMBDA",
|
|
9840
|
+
syntax: "LAMBDA([parameter1, parameter2, …,] calculation)",
|
|
9841
|
+
description: "Creates a reusable custom function from its parameters and a calculation. Call it in place with LAMBDA(…)(arguments), give it a name in the Name Manager, or pass it to MAP, BYROW, REDUCE and the other helper functions.",
|
|
9842
|
+
example: "LAMBDA(x, y, x+y)(1, 2)",
|
|
9843
|
+
usage: ["LAMBDA(x, y, x+y)(1, 2)", "MAP(A1:A5, LAMBDA(v, v*2))"],
|
|
9844
|
+
parameters: [
|
|
9845
|
+
{
|
|
9846
|
+
title: "parameter1, parameter2, … [OPTIONAL]",
|
|
9847
|
+
description: "Names for the values passed when the function is called. Wrap a name in square brackets to make it optional (see ISOMITTED).",
|
|
9848
|
+
},
|
|
9849
|
+
{
|
|
9850
|
+
title: "calculation",
|
|
9851
|
+
description: "The formula evaluated with the parameters; always the last argument and the function's result.",
|
|
9852
|
+
},
|
|
9853
|
+
],
|
|
9854
|
+
},
|
|
9855
|
+
{
|
|
9856
|
+
datatype: "Info",
|
|
9857
|
+
title: "ISOMITTED",
|
|
9858
|
+
syntax: "ISOMITTED(argument)",
|
|
9859
|
+
description: "Returns TRUE when the named LAMBDA parameter was left out of the call, so a custom function can supply a default.",
|
|
9860
|
+
example: "LAMBDA(x, [y], IF(ISOMITTED(y), x, x+y))(5)",
|
|
9861
|
+
usage: [
|
|
9862
|
+
"LAMBDA(x, [y], IF(ISOMITTED(y), x, x+y))(5)",
|
|
9863
|
+
"LAMBDA(x, [y], IF(ISOMITTED(y), x, x+y))(5, 2)",
|
|
9864
|
+
],
|
|
9865
|
+
parameters: [
|
|
9866
|
+
{
|
|
9867
|
+
title: "argument",
|
|
9868
|
+
description: "The LAMBDA parameter to test.",
|
|
9869
|
+
},
|
|
9870
|
+
],
|
|
9871
|
+
},
|
|
9872
|
+
{
|
|
9873
|
+
datatype: "Lookup",
|
|
9874
|
+
title: "XMATCH",
|
|
9875
|
+
syntax: "XMATCH(lookup_value, lookup_array, [match_mode], [search_mode])",
|
|
9876
|
+
description: "Returns the position of a value in a range or array. Exact match by default, with the same match and search modes as XLOOKUP.",
|
|
9877
|
+
example: "XMATCH(E2, B2:B10)",
|
|
9878
|
+
usage: ["XMATCH(E2, B2:B10)", "XMATCH(E2, B2:B10, 1)", 'XMATCH("gr*", B2:B10, 2)'],
|
|
9879
|
+
parameters: [
|
|
9880
|
+
{
|
|
9881
|
+
title: "lookup_value",
|
|
9882
|
+
description: "The value to search for.",
|
|
9883
|
+
},
|
|
9884
|
+
{
|
|
9885
|
+
title: "lookup_array",
|
|
9886
|
+
description: "The range or array to search in.",
|
|
9887
|
+
},
|
|
9888
|
+
{
|
|
9889
|
+
title: "match_mode [OPTIONAL]",
|
|
9890
|
+
description: "0 for exact match (default), -1 for exact or next smaller, 1 for exact or next larger, 2 for wildcard match.",
|
|
9891
|
+
},
|
|
9892
|
+
{
|
|
9893
|
+
title: "search_mode [OPTIONAL]",
|
|
9894
|
+
description: "1 to search first to last (default), -1 last to first, 2 binary search on ascending data, -2 binary search on descending data.",
|
|
9895
|
+
},
|
|
9896
|
+
],
|
|
9897
|
+
},
|
|
9898
|
+
{
|
|
9899
|
+
datatype: "Filter",
|
|
9900
|
+
title: "VSTACK",
|
|
9901
|
+
syntax: "VSTACK(array1, [array2], …)",
|
|
9902
|
+
description: "Appends arrays vertically, one below the other, into a single array; narrower arrays are padded with #N/A.",
|
|
9903
|
+
example: "VSTACK(A1:C3, E1:G2)",
|
|
9904
|
+
usage: ["VSTACK(A1:C3, E1:G2)", "VSTACK({1,2}, {3,4})"],
|
|
9905
|
+
parameters: [
|
|
9906
|
+
{
|
|
9907
|
+
title: "array1",
|
|
9908
|
+
description: "The first range or array to stack.",
|
|
9909
|
+
},
|
|
9910
|
+
{
|
|
9911
|
+
title: "array2, … [OPTIONAL]",
|
|
9912
|
+
description: "Additional ranges or arrays appended below the previous one.",
|
|
9913
|
+
},
|
|
9914
|
+
],
|
|
9915
|
+
},
|
|
9916
|
+
{
|
|
9917
|
+
datatype: "Filter",
|
|
9918
|
+
title: "HSTACK",
|
|
9919
|
+
syntax: "HSTACK(array1, [array2], …)",
|
|
9920
|
+
description: "Appends arrays horizontally, side by side, into a single array; shorter arrays are padded with #N/A.",
|
|
9921
|
+
example: "HSTACK(A1:A3, C1:C3)",
|
|
9922
|
+
usage: ["HSTACK(A1:A3, C1:C3)", "HSTACK({1;2}, {3;4})"],
|
|
9923
|
+
parameters: [
|
|
9924
|
+
{
|
|
9925
|
+
title: "array1",
|
|
9926
|
+
description: "The first range or array to stack.",
|
|
9927
|
+
},
|
|
9928
|
+
{
|
|
9929
|
+
title: "array2, … [OPTIONAL]",
|
|
9930
|
+
description: "Additional ranges or arrays appended to the right of the previous one.",
|
|
9931
|
+
},
|
|
9932
|
+
],
|
|
9933
|
+
},
|
|
9934
|
+
{
|
|
9935
|
+
datatype: "Filter",
|
|
9936
|
+
title: "CHOOSECOLS",
|
|
9937
|
+
syntax: "CHOOSECOLS(array, col_num1, [col_num2], …)",
|
|
9938
|
+
description: "Returns the specified columns of an array, in the order given; negative numbers count from the last column.",
|
|
9939
|
+
example: "CHOOSECOLS(A1:E10, 1, 3)",
|
|
9940
|
+
usage: ["CHOOSECOLS(A1:E10, 1, 3)", "CHOOSECOLS(A1:E10, -1)"],
|
|
9941
|
+
parameters: [
|
|
9942
|
+
{
|
|
9943
|
+
title: "array",
|
|
9944
|
+
description: "The range or array to pick columns from.",
|
|
9945
|
+
},
|
|
9946
|
+
{
|
|
9947
|
+
title: "col_num1",
|
|
9948
|
+
description: "The first column to return; negative counts from the end.",
|
|
9949
|
+
},
|
|
9950
|
+
{
|
|
9951
|
+
title: "col_num2, … [OPTIONAL]",
|
|
9952
|
+
description: "Additional columns to return, in output order.",
|
|
9953
|
+
},
|
|
9954
|
+
],
|
|
9955
|
+
},
|
|
9956
|
+
{
|
|
9957
|
+
datatype: "Filter",
|
|
9958
|
+
title: "CHOOSEROWS",
|
|
9959
|
+
syntax: "CHOOSEROWS(array, row_num1, [row_num2], …)",
|
|
9960
|
+
description: "Returns the specified rows of an array, in the order given; negative numbers count from the last row.",
|
|
9961
|
+
example: "CHOOSEROWS(A1:E10, 1, 3)",
|
|
9962
|
+
usage: ["CHOOSEROWS(A1:E10, 1, 3)", "CHOOSEROWS(A1:E10, -1)"],
|
|
9963
|
+
parameters: [
|
|
9964
|
+
{
|
|
9965
|
+
title: "array",
|
|
9966
|
+
description: "The range or array to pick rows from.",
|
|
9967
|
+
},
|
|
9968
|
+
{
|
|
9969
|
+
title: "row_num1",
|
|
9970
|
+
description: "The first row to return; negative counts from the end.",
|
|
9971
|
+
},
|
|
9972
|
+
{
|
|
9973
|
+
title: "row_num2, … [OPTIONAL]",
|
|
9974
|
+
description: "Additional rows to return, in output order.",
|
|
9975
|
+
},
|
|
9976
|
+
],
|
|
9977
|
+
},
|
|
9978
|
+
{
|
|
9979
|
+
datatype: "Filter",
|
|
9980
|
+
title: "TOCOL",
|
|
9981
|
+
syntax: "TOCOL(array, [ignore], [scan_by_column])",
|
|
9982
|
+
description: "Returns an array as a single column, reading it row by row unless scan_by_column is TRUE.",
|
|
9983
|
+
example: "TOCOL(A1:C3)",
|
|
9984
|
+
usage: ["TOCOL(A1:C3)", "TOCOL(A1:C3, 1)", "TOCOL(A1:C3, 0, TRUE)"],
|
|
9985
|
+
parameters: [
|
|
9986
|
+
{
|
|
9987
|
+
title: "array",
|
|
9988
|
+
description: "The range or array to flatten.",
|
|
9989
|
+
},
|
|
9990
|
+
{
|
|
9991
|
+
title: "ignore [OPTIONAL]",
|
|
9992
|
+
description: "0 keeps every value (default), 1 ignores blanks, 2 ignores errors, 3 ignores blanks and errors.",
|
|
9993
|
+
},
|
|
9994
|
+
{
|
|
9995
|
+
title: "scan_by_column [OPTIONAL]",
|
|
9996
|
+
description: "TRUE to read the array column by column. Defaults to FALSE (row by row).",
|
|
9997
|
+
},
|
|
9998
|
+
],
|
|
9999
|
+
},
|
|
10000
|
+
{
|
|
10001
|
+
datatype: "Filter",
|
|
10002
|
+
title: "TOROW",
|
|
10003
|
+
syntax: "TOROW(array, [ignore], [scan_by_column])",
|
|
10004
|
+
description: "Returns an array as a single row, reading it row by row unless scan_by_column is TRUE.",
|
|
10005
|
+
example: "TOROW(A1:C3)",
|
|
10006
|
+
usage: ["TOROW(A1:C3)", "TOROW(A1:C3, 1)", "TOROW(A1:C3, 0, TRUE)"],
|
|
10007
|
+
parameters: [
|
|
10008
|
+
{
|
|
10009
|
+
title: "array",
|
|
10010
|
+
description: "The range or array to flatten.",
|
|
10011
|
+
},
|
|
10012
|
+
{
|
|
10013
|
+
title: "ignore [OPTIONAL]",
|
|
10014
|
+
description: "0 keeps every value (default), 1 ignores blanks, 2 ignores errors, 3 ignores blanks and errors.",
|
|
10015
|
+
},
|
|
10016
|
+
{
|
|
10017
|
+
title: "scan_by_column [OPTIONAL]",
|
|
10018
|
+
description: "TRUE to read the array column by column. Defaults to FALSE (row by row).",
|
|
10019
|
+
},
|
|
10020
|
+
],
|
|
10021
|
+
},
|
|
10022
|
+
{
|
|
10023
|
+
datatype: "Filter",
|
|
10024
|
+
title: "WRAPROWS",
|
|
10025
|
+
syntax: "WRAPROWS(vector, wrap_count, [pad_with])",
|
|
10026
|
+
description: "Wraps a single row or column of values into rows of wrap_count values each; the last row is padded with pad_with (#N/A by default).",
|
|
10027
|
+
example: "WRAPROWS(A1:A10, 3)",
|
|
10028
|
+
usage: ["WRAPROWS(A1:A10, 3)", 'WRAPROWS(A1:A10, 3, "")'],
|
|
10029
|
+
parameters: [
|
|
10030
|
+
{
|
|
10031
|
+
title: "vector",
|
|
10032
|
+
description: "The single row or column to wrap.",
|
|
10033
|
+
},
|
|
10034
|
+
{
|
|
10035
|
+
title: "wrap_count",
|
|
10036
|
+
description: "Maximum number of values per row.",
|
|
10037
|
+
},
|
|
10038
|
+
{
|
|
10039
|
+
title: "pad_with [OPTIONAL]",
|
|
10040
|
+
description: "Value used to fill the last row. Defaults to #N/A.",
|
|
10041
|
+
},
|
|
10042
|
+
],
|
|
10043
|
+
},
|
|
10044
|
+
{
|
|
10045
|
+
datatype: "Filter",
|
|
10046
|
+
title: "WRAPCOLS",
|
|
10047
|
+
syntax: "WRAPCOLS(vector, wrap_count, [pad_with])",
|
|
10048
|
+
description: "Wraps a single row or column of values into columns of wrap_count values each; the last column is padded with pad_with (#N/A by default).",
|
|
10049
|
+
example: "WRAPCOLS(A1:A10, 3)",
|
|
10050
|
+
usage: ["WRAPCOLS(A1:A10, 3)", 'WRAPCOLS(A1:A10, 3, "")'],
|
|
10051
|
+
parameters: [
|
|
10052
|
+
{
|
|
10053
|
+
title: "vector",
|
|
10054
|
+
description: "The single row or column to wrap.",
|
|
10055
|
+
},
|
|
10056
|
+
{
|
|
10057
|
+
title: "wrap_count",
|
|
10058
|
+
description: "Maximum number of values per column.",
|
|
10059
|
+
},
|
|
10060
|
+
{
|
|
10061
|
+
title: "pad_with [OPTIONAL]",
|
|
10062
|
+
description: "Value used to fill the last column. Defaults to #N/A.",
|
|
10063
|
+
},
|
|
10064
|
+
],
|
|
10065
|
+
},
|
|
10066
|
+
{
|
|
10067
|
+
datatype: "Filter",
|
|
10068
|
+
title: "BYROW",
|
|
10069
|
+
syntax: "BYROW(array, lambda(row))",
|
|
10070
|
+
description: "Applies a LAMBDA to each row of an array and returns one result per row, as a column.",
|
|
10071
|
+
example: "BYROW(A1:C5, LAMBDA(row, SUM(row)))",
|
|
10072
|
+
usage: ["BYROW(A1:C5, LAMBDA(row, SUM(row)))", "BYROW(A1:C5, LAMBDA(row, MAX(row)))"],
|
|
10073
|
+
parameters: [
|
|
10074
|
+
{
|
|
10075
|
+
title: "array",
|
|
10076
|
+
description: "The range or array whose rows are processed.",
|
|
10077
|
+
},
|
|
10078
|
+
{
|
|
10079
|
+
title: "lambda(row)",
|
|
10080
|
+
description: "A LAMBDA with one parameter that receives a row and returns a single value.",
|
|
10081
|
+
},
|
|
10082
|
+
],
|
|
10083
|
+
},
|
|
10084
|
+
{
|
|
10085
|
+
datatype: "Filter",
|
|
10086
|
+
title: "BYCOL",
|
|
10087
|
+
syntax: "BYCOL(array, lambda(column))",
|
|
10088
|
+
description: "Applies a LAMBDA to each column of an array and returns one result per column, as a row.",
|
|
10089
|
+
example: "BYCOL(A1:C5, LAMBDA(col, SUM(col)))",
|
|
10090
|
+
usage: ["BYCOL(A1:C5, LAMBDA(col, SUM(col)))", "BYCOL(A1:C5, LAMBDA(col, MAX(col)))"],
|
|
10091
|
+
parameters: [
|
|
10092
|
+
{
|
|
10093
|
+
title: "array",
|
|
10094
|
+
description: "The range or array whose columns are processed.",
|
|
10095
|
+
},
|
|
10096
|
+
{
|
|
10097
|
+
title: "lambda(column)",
|
|
10098
|
+
description: "A LAMBDA with one parameter that receives a column and returns a single value.",
|
|
10099
|
+
},
|
|
10100
|
+
],
|
|
10101
|
+
},
|
|
10102
|
+
{
|
|
10103
|
+
datatype: "Filter",
|
|
10104
|
+
title: "MAP",
|
|
10105
|
+
syntax: "MAP(array1, [array2, …], lambda(value1, [value2, …]))",
|
|
10106
|
+
description: "Applies a LAMBDA to each value of one or more arrays and returns an array of the same shape.",
|
|
10107
|
+
example: "MAP(A1:A5, LAMBDA(v, v*2))",
|
|
10108
|
+
usage: ["MAP(A1:A5, LAMBDA(v, v*2))", "MAP(A1:A5, B1:B5, LAMBDA(a, b, a&b))"],
|
|
10109
|
+
parameters: [
|
|
10110
|
+
{
|
|
10111
|
+
title: "array1",
|
|
10112
|
+
description: "The range or array to map.",
|
|
10113
|
+
},
|
|
10114
|
+
{
|
|
10115
|
+
title: "array2, … [OPTIONAL]",
|
|
10116
|
+
description: "Additional arrays of the same shape, passed to the LAMBDA as further parameters.",
|
|
10117
|
+
},
|
|
10118
|
+
{
|
|
10119
|
+
title: "lambda(value1, [value2, …])",
|
|
10120
|
+
description: "A LAMBDA with one parameter per array that returns the new value.",
|
|
10121
|
+
},
|
|
10122
|
+
],
|
|
10123
|
+
},
|
|
10124
|
+
{
|
|
10125
|
+
datatype: "Filter",
|
|
10126
|
+
title: "REDUCE",
|
|
10127
|
+
syntax: "REDUCE([initial_value], array, lambda(accumulator, value))",
|
|
10128
|
+
description: "Folds an array into a single value by calling a LAMBDA with the running accumulator and each value in turn.",
|
|
10129
|
+
example: "REDUCE(0, A1:A5, LAMBDA(acc, v, acc+v))",
|
|
10130
|
+
usage: ["REDUCE(0, A1:A5, LAMBDA(acc, v, acc+v))", "REDUCE(1, A1:A5, LAMBDA(acc, v, acc*v))"],
|
|
10131
|
+
parameters: [
|
|
10132
|
+
{
|
|
10133
|
+
title: "initial_value [OPTIONAL]",
|
|
10134
|
+
description: "The accumulator's starting value.",
|
|
10135
|
+
},
|
|
10136
|
+
{
|
|
10137
|
+
title: "array",
|
|
10138
|
+
description: "The range or array to fold.",
|
|
10139
|
+
},
|
|
10140
|
+
{
|
|
10141
|
+
title: "lambda(accumulator, value)",
|
|
10142
|
+
description: "A LAMBDA with two parameters that returns the next accumulator.",
|
|
10143
|
+
},
|
|
10144
|
+
],
|
|
10145
|
+
},
|
|
10146
|
+
{
|
|
10147
|
+
datatype: "Filter",
|
|
10148
|
+
title: "SCAN",
|
|
10149
|
+
syntax: "SCAN([initial_value], array, lambda(accumulator, value))",
|
|
10150
|
+
description: "Like REDUCE, but returns every intermediate accumulator as an array of the same shape as the input.",
|
|
10151
|
+
example: "SCAN(0, A1:A5, LAMBDA(acc, v, acc+v))",
|
|
10152
|
+
usage: ["SCAN(0, A1:A5, LAMBDA(acc, v, acc+v))", 'SCAN("", A1:A5, LAMBDA(acc, v, acc&v))'],
|
|
10153
|
+
parameters: [
|
|
10154
|
+
{
|
|
10155
|
+
title: "initial_value [OPTIONAL]",
|
|
10156
|
+
description: "The accumulator's starting value.",
|
|
10157
|
+
},
|
|
10158
|
+
{
|
|
10159
|
+
title: "array",
|
|
10160
|
+
description: "The range or array to scan.",
|
|
10161
|
+
},
|
|
10162
|
+
{
|
|
10163
|
+
title: "lambda(accumulator, value)",
|
|
10164
|
+
description: "A LAMBDA with two parameters that returns the next accumulator.",
|
|
10165
|
+
},
|
|
10166
|
+
],
|
|
10167
|
+
},
|
|
10168
|
+
{
|
|
10169
|
+
datatype: "Filter",
|
|
10170
|
+
title: "MAKEARRAY",
|
|
10171
|
+
syntax: "MAKEARRAY(rows, columns, lambda(row, column))",
|
|
10172
|
+
description: "Builds an array of the given size by calling a LAMBDA with each row and column number.",
|
|
10173
|
+
example: "MAKEARRAY(3, 3, LAMBDA(r, c, r*c))",
|
|
10174
|
+
usage: ["MAKEARRAY(3, 3, LAMBDA(r, c, r*c))", 'MAKEARRAY(2, 2, LAMBDA(r, c, "R"&r&"C"&c))'],
|
|
10175
|
+
parameters: [
|
|
10176
|
+
{
|
|
10177
|
+
title: "rows",
|
|
10178
|
+
description: "Number of rows in the result.",
|
|
10179
|
+
},
|
|
10180
|
+
{
|
|
10181
|
+
title: "columns",
|
|
10182
|
+
description: "Number of columns in the result.",
|
|
10183
|
+
},
|
|
10184
|
+
{
|
|
10185
|
+
title: "lambda(row, column)",
|
|
10186
|
+
description: "A LAMBDA with two parameters that returns the value for that row and column (both 1-based).",
|
|
10187
|
+
},
|
|
10188
|
+
],
|
|
10189
|
+
},
|
|
10190
|
+
{
|
|
10191
|
+
datatype: "Text",
|
|
10192
|
+
title: "TEXTBEFORE",
|
|
10193
|
+
syntax: "TEXTBEFORE(text, delimiter, [instance_num], [match_mode], [match_end], [if_not_found])",
|
|
10194
|
+
description: "Returns the text that comes before the nth occurrence of a delimiter; a negative instance number counts occurrences from the end.",
|
|
10195
|
+
example: 'TEXTBEFORE("Red riding hood", " ")',
|
|
10196
|
+
usage: [
|
|
10197
|
+
'TEXTBEFORE("Red riding hood", " ")',
|
|
10198
|
+
'TEXTBEFORE("Red riding hood", " ", -1)',
|
|
10199
|
+
'TEXTBEFORE("a-b-c", "-", 2)',
|
|
10200
|
+
],
|
|
10201
|
+
parameters: [
|
|
10202
|
+
{
|
|
10203
|
+
title: "text",
|
|
10204
|
+
description: "The text to search in.",
|
|
10205
|
+
},
|
|
10206
|
+
{
|
|
10207
|
+
title: "delimiter",
|
|
10208
|
+
description: "The text (or array of texts) that marks the point before which to extract.",
|
|
10209
|
+
},
|
|
10210
|
+
{
|
|
10211
|
+
title: "instance_num [OPTIONAL]",
|
|
10212
|
+
description: "Which occurrence of the delimiter to use. Defaults to 1; negative counts from the end.",
|
|
10213
|
+
},
|
|
10214
|
+
{
|
|
10215
|
+
title: "match_mode [OPTIONAL]",
|
|
10216
|
+
description: "0 for case-sensitive (default) or 1 for case-insensitive delimiter matching.",
|
|
10217
|
+
},
|
|
10218
|
+
{
|
|
10219
|
+
title: "match_end [OPTIONAL]",
|
|
10220
|
+
description: "1 treats the end of the text as a delimiter. Defaults to 0.",
|
|
10221
|
+
},
|
|
10222
|
+
{
|
|
10223
|
+
title: "if_not_found [OPTIONAL]",
|
|
10224
|
+
description: "Value returned when the delimiter is not found. Defaults to #N/A.",
|
|
10225
|
+
},
|
|
10226
|
+
],
|
|
10227
|
+
},
|
|
10228
|
+
{
|
|
10229
|
+
datatype: "Text",
|
|
10230
|
+
title: "TEXTAFTER",
|
|
10231
|
+
syntax: "TEXTAFTER(text, delimiter, [instance_num], [match_mode], [match_end], [if_not_found])",
|
|
10232
|
+
description: "Returns the text that comes after the nth occurrence of a delimiter; a negative instance number counts occurrences from the end.",
|
|
10233
|
+
example: 'TEXTAFTER("Red riding hood", " ")',
|
|
10234
|
+
usage: [
|
|
10235
|
+
'TEXTAFTER("Red riding hood", " ")',
|
|
10236
|
+
'TEXTAFTER("Red riding hood", " ", -1)',
|
|
10237
|
+
'TEXTAFTER("a-b-c", "-", 2)',
|
|
10238
|
+
],
|
|
10239
|
+
parameters: [
|
|
10240
|
+
{
|
|
10241
|
+
title: "text",
|
|
10242
|
+
description: "The text to search in.",
|
|
10243
|
+
},
|
|
10244
|
+
{
|
|
10245
|
+
title: "delimiter",
|
|
10246
|
+
description: "The text (or array of texts) that marks the point after which to extract.",
|
|
10247
|
+
},
|
|
10248
|
+
{
|
|
10249
|
+
title: "instance_num [OPTIONAL]",
|
|
10250
|
+
description: "Which occurrence of the delimiter to use. Defaults to 1; negative counts from the end.",
|
|
10251
|
+
},
|
|
10252
|
+
{
|
|
10253
|
+
title: "match_mode [OPTIONAL]",
|
|
10254
|
+
description: "0 for case-sensitive (default) or 1 for case-insensitive delimiter matching.",
|
|
10255
|
+
},
|
|
10256
|
+
{
|
|
10257
|
+
title: "match_end [OPTIONAL]",
|
|
10258
|
+
description: "1 treats the start of the text as a delimiter. Defaults to 0.",
|
|
10259
|
+
},
|
|
10260
|
+
{
|
|
10261
|
+
title: "if_not_found [OPTIONAL]",
|
|
10262
|
+
description: "Value returned when the delimiter is not found. Defaults to #N/A.",
|
|
10263
|
+
},
|
|
10264
|
+
],
|
|
10265
|
+
},
|
|
10266
|
+
{
|
|
10267
|
+
datatype: "Filter",
|
|
10268
|
+
title: "GROUPBY",
|
|
10269
|
+
syntax: "GROUPBY(row_fields, values, function, [field_headers], [total_depth], [sort_order], [filter_array], [field_relationship])",
|
|
10270
|
+
description: "Groups the rows of values by the values in row_fields and aggregates each group with the given function, returning a summary table with totals.",
|
|
10271
|
+
example: "GROUPBY(A2:A20, C2:C20, SUM)",
|
|
10272
|
+
usage: ["GROUPBY(A2:A20, C2:C20, SUM)", "GROUPBY(A2:A20, C2:C20, AVERAGE, 0, 0, -2)"],
|
|
10273
|
+
parameters: [
|
|
10274
|
+
{
|
|
10275
|
+
title: "row_fields",
|
|
10276
|
+
description: "Column-oriented range or array containing the values to group by.",
|
|
10277
|
+
},
|
|
10278
|
+
{
|
|
10279
|
+
title: "values",
|
|
10280
|
+
description: "Column-oriented range or array containing the values to aggregate.",
|
|
10281
|
+
},
|
|
10282
|
+
{
|
|
10283
|
+
title: "function",
|
|
10284
|
+
description: "The aggregation to apply to each group: SUM, PERCENTOF, AVERAGE, MEDIAN, COUNT, COUNTA, MAX, MIN, PRODUCT, ARRAYTOTEXT, CONCAT, STDEV.S, STDEV.P, VAR.S, VAR.P, MODE.SNGL, or a LAMBDA.",
|
|
10285
|
+
},
|
|
10286
|
+
{
|
|
10287
|
+
title: "field_headers [OPTIONAL]",
|
|
10288
|
+
description: "0 no headers, 1 headers in the data but not shown, 2 no headers but generate them, 3 headers in the data and shown. Inferred from the data when omitted.",
|
|
10289
|
+
},
|
|
10290
|
+
{
|
|
10291
|
+
title: "total_depth [OPTIONAL]",
|
|
10292
|
+
description: "0 no totals, 1 grand totals (default), 2 grand totals and subtotals; negative values place the totals above the data.",
|
|
10293
|
+
},
|
|
10294
|
+
{
|
|
10295
|
+
title: "sort_order [OPTIONAL]",
|
|
10296
|
+
description: "Column number to sort the result by; negative sorts descending.",
|
|
10297
|
+
},
|
|
10298
|
+
{
|
|
10299
|
+
title: "filter_array [OPTIONAL]",
|
|
10300
|
+
description: "Column-oriented array of TRUE/FALSE values selecting the rows to include.",
|
|
10301
|
+
},
|
|
10302
|
+
{
|
|
10303
|
+
title: "field_relationship [OPTIONAL]",
|
|
10304
|
+
description: "With more than one row field: 0 for a hierarchy (default) or 1 for a table.",
|
|
10305
|
+
},
|
|
10306
|
+
],
|
|
10307
|
+
},
|
|
10308
|
+
{
|
|
10309
|
+
datatype: "Filter",
|
|
10310
|
+
title: "PIVOTBY",
|
|
10311
|
+
syntax: "PIVOTBY(row_fields, col_fields, values, function, [field_headers], [row_total_depth], [row_sort_order], [col_total_depth], [col_sort_order], [filter_array], [relative_to])",
|
|
10312
|
+
description: "Groups the rows of values by row_fields down the side and col_fields across the top, aggregating each cell with the given function, like a pivot table without the pivot.",
|
|
10313
|
+
example: "PIVOTBY(A2:A20, B2:B20, C2:C20, SUM)",
|
|
10314
|
+
usage: [
|
|
10315
|
+
"PIVOTBY(A2:A20, B2:B20, C2:C20, SUM)",
|
|
10316
|
+
"PIVOTBY(A2:A20, B2:B20, C2:C20, PERCENTOF, 0, 0, 0, 0, 0, , 0)",
|
|
10317
|
+
],
|
|
10318
|
+
parameters: [
|
|
10319
|
+
{
|
|
10320
|
+
title: "row_fields",
|
|
10321
|
+
description: "Column-oriented range or array containing the values that become rows.",
|
|
10322
|
+
},
|
|
10323
|
+
{
|
|
10324
|
+
title: "col_fields",
|
|
10325
|
+
description: "Column-oriented range or array containing the values that become columns.",
|
|
10326
|
+
},
|
|
10327
|
+
{
|
|
10328
|
+
title: "values",
|
|
10329
|
+
description: "Column-oriented range or array containing the values to aggregate.",
|
|
10330
|
+
},
|
|
10331
|
+
{
|
|
10332
|
+
title: "function",
|
|
10333
|
+
description: "The aggregation to apply to each cell: SUM, PERCENTOF, AVERAGE, MEDIAN, COUNT, COUNTA, MAX, MIN, PRODUCT, ARRAYTOTEXT, CONCAT, STDEV.S, STDEV.P, VAR.S, VAR.P, MODE.SNGL, or a LAMBDA.",
|
|
10334
|
+
},
|
|
10335
|
+
{
|
|
10336
|
+
title: "field_headers [OPTIONAL]",
|
|
10337
|
+
description: "0 no headers, 1 headers in the data but not shown, 2 no headers but generate them, 3 headers in the data and shown. Inferred from the data when omitted.",
|
|
10338
|
+
},
|
|
10339
|
+
{
|
|
10340
|
+
title: "row_total_depth [OPTIONAL]",
|
|
10341
|
+
description: "0 no row totals, 1 grand totals (default), 2 grand totals and subtotals; negative values place the totals above the data.",
|
|
10342
|
+
},
|
|
10343
|
+
{
|
|
10344
|
+
title: "row_sort_order [OPTIONAL]",
|
|
10345
|
+
description: "Column number to sort the rows by; negative sorts descending.",
|
|
10346
|
+
},
|
|
10347
|
+
{
|
|
10348
|
+
title: "col_total_depth [OPTIONAL]",
|
|
10349
|
+
description: "0 no column totals, 1 grand totals (default), 2 grand totals and subtotals; negative values place the totals before the data.",
|
|
10350
|
+
},
|
|
10351
|
+
{
|
|
10352
|
+
title: "col_sort_order [OPTIONAL]",
|
|
10353
|
+
description: "Row number to sort the columns by; negative sorts descending.",
|
|
10354
|
+
},
|
|
10355
|
+
{
|
|
10356
|
+
title: "filter_array [OPTIONAL]",
|
|
10357
|
+
description: "Column-oriented array of TRUE/FALSE values selecting the rows to include.",
|
|
10358
|
+
},
|
|
10359
|
+
{
|
|
10360
|
+
title: "relative_to [OPTIONAL]",
|
|
10361
|
+
description: "For PERCENTOF: 0 column totals (default), 1 row totals, 2 grand total, 3 parent column total, 4 parent row total.",
|
|
10362
|
+
},
|
|
10363
|
+
],
|
|
10364
|
+
},
|
|
10365
|
+
{
|
|
10366
|
+
datatype: "Database",
|
|
10367
|
+
title: "CUBEKPIMEMBER",
|
|
10368
|
+
syntax: "CUBEKPIMEMBER(connection, kpi_name, kpi_property, [caption])",
|
|
10369
|
+
description: "Returns a key performance indicator (KPI) property from an OLAP cube. Athena has no connection to this provider, so the call returns #NAME?, as Excel does without a cube connection.",
|
|
10370
|
+
example: "CUBEKPIMEMBER(\"Sales\",\"MySalesKPI\",1)",
|
|
10371
|
+
usage: ["CUBEKPIMEMBER(\"Sales\",\"MySalesKPI\",1)"],
|
|
10372
|
+
parameters: [
|
|
10373
|
+
{
|
|
10374
|
+
title: "connection",
|
|
10375
|
+
description: "The name of the workbook connection to the cube.",
|
|
10376
|
+
},
|
|
10377
|
+
{
|
|
10378
|
+
title: "kpi_name",
|
|
10379
|
+
description: "The name of the KPI in the cube.",
|
|
10380
|
+
},
|
|
10381
|
+
{
|
|
10382
|
+
title: "kpi_property",
|
|
10383
|
+
description: "The KPI component returned (1 value, 2 goal, 3 status, 4 trend, 5 weight, 6 current time member).",
|
|
10384
|
+
},
|
|
10385
|
+
{
|
|
10386
|
+
title: "caption [OPTIONAL]",
|
|
10387
|
+
description: "Text shown in the cell instead of the KPI name.",
|
|
10388
|
+
},
|
|
10389
|
+
],
|
|
10390
|
+
},
|
|
10391
|
+
{
|
|
10392
|
+
datatype: "Database",
|
|
10393
|
+
title: "CUBEMEMBER",
|
|
10394
|
+
syntax: "CUBEMEMBER(connection, member_expression, [caption])",
|
|
10395
|
+
description: "Returns a member or tuple from an OLAP cube. Athena has no connection to this provider, so the call returns #NAME?, as Excel does without a cube connection.",
|
|
10396
|
+
example: "CUBEMEMBER(\"Sales\",\"[Time].[Fiscal].[2024]\")",
|
|
10397
|
+
usage: ["CUBEMEMBER(\"Sales\",\"[Time].[Fiscal].[2024]\")"],
|
|
10398
|
+
parameters: [
|
|
10399
|
+
{
|
|
10400
|
+
title: "connection",
|
|
10401
|
+
description: "The name of the workbook connection to the cube.",
|
|
10402
|
+
},
|
|
10403
|
+
{
|
|
10404
|
+
title: "member_expression",
|
|
10405
|
+
description: "An MDX expression that evaluates to a unique member or tuple.",
|
|
10406
|
+
},
|
|
10407
|
+
{
|
|
10408
|
+
title: "caption [OPTIONAL]",
|
|
10409
|
+
description: "Text shown in the cell instead of the member caption.",
|
|
10410
|
+
},
|
|
10411
|
+
],
|
|
10412
|
+
},
|
|
10413
|
+
{
|
|
10414
|
+
datatype: "Database",
|
|
10415
|
+
title: "CUBEMEMBERPROPERTY",
|
|
10416
|
+
syntax: "CUBEMEMBERPROPERTY(connection, member_expression, property)",
|
|
10417
|
+
description: "Returns the value of a member property from an OLAP cube. Athena has no connection to this provider, so the call returns #NAME?, as Excel does without a cube connection.",
|
|
10418
|
+
example: "CUBEMEMBERPROPERTY(\"Sales\",\"[Store].[MyFavoriteStore]\",\"[Store].[Store Name].[Store Sqft]\")",
|
|
10419
|
+
usage: ["CUBEMEMBERPROPERTY(\"Sales\",\"[Store].[MyFavoriteStore]\",\"[Store].[Store Name].[Store Sqft]\")"],
|
|
10420
|
+
parameters: [
|
|
10421
|
+
{
|
|
10422
|
+
title: "connection",
|
|
10423
|
+
description: "The name of the workbook connection to the cube.",
|
|
10424
|
+
},
|
|
10425
|
+
{
|
|
10426
|
+
title: "member_expression",
|
|
10427
|
+
description: "An MDX expression for the member.",
|
|
10428
|
+
},
|
|
10429
|
+
{
|
|
10430
|
+
title: "property",
|
|
10431
|
+
description: "The name of the property to return.",
|
|
10432
|
+
},
|
|
10433
|
+
],
|
|
10434
|
+
},
|
|
10435
|
+
{
|
|
10436
|
+
datatype: "Database",
|
|
10437
|
+
title: "CUBERANKEDMEMBER",
|
|
10438
|
+
syntax: "CUBERANKEDMEMBER(connection, set_expression, rank, [caption])",
|
|
10439
|
+
description: "Returns the nth, or ranked, member of a set from an OLAP cube. Athena has no connection to this provider, so the call returns #NAME?, as Excel does without a cube connection.",
|
|
10440
|
+
example: "CUBERANKEDMEMBER(\"Sales\",$D$4,1,\"Top Month\")",
|
|
10441
|
+
usage: ["CUBERANKEDMEMBER(\"Sales\",$D$4,1,\"Top Month\")"],
|
|
10442
|
+
parameters: [
|
|
10443
|
+
{
|
|
10444
|
+
title: "connection",
|
|
10445
|
+
description: "The name of the workbook connection to the cube.",
|
|
10446
|
+
},
|
|
10447
|
+
{
|
|
10448
|
+
title: "set_expression",
|
|
10449
|
+
description: "A set expression or a reference to a CUBESET cell.",
|
|
10450
|
+
},
|
|
10451
|
+
{
|
|
10452
|
+
title: "rank",
|
|
10453
|
+
description: "The position of the member to return.",
|
|
10454
|
+
},
|
|
10455
|
+
{
|
|
10456
|
+
title: "caption [OPTIONAL]",
|
|
10457
|
+
description: "Text shown in the cell instead of the member caption.",
|
|
10458
|
+
},
|
|
10459
|
+
],
|
|
10460
|
+
},
|
|
10461
|
+
{
|
|
10462
|
+
datatype: "Database",
|
|
10463
|
+
title: "CUBESET",
|
|
10464
|
+
syntax: "CUBESET(connection, set_expression, [caption], [sort_order], [sort_by])",
|
|
10465
|
+
description: "Defines a calculated set of members or tuples on an OLAP cube. Athena has no connection to this provider, so the call returns #NAME?, as Excel does without a cube connection.",
|
|
10466
|
+
example: "CUBESET(\"Sales\",\"[Product].[All Products].Children\",\"Products\",1,\"[Measures].[Sales Amount]\")",
|
|
10467
|
+
usage: ["CUBESET(\"Sales\",\"[Product].[All Products].Children\",\"Products\",1,\"[Measures].[Sales Amount]\")"],
|
|
10468
|
+
parameters: [
|
|
10469
|
+
{
|
|
10470
|
+
title: "connection",
|
|
10471
|
+
description: "The name of the workbook connection to the cube.",
|
|
10472
|
+
},
|
|
10473
|
+
{
|
|
10474
|
+
title: "set_expression",
|
|
10475
|
+
description: "An MDX expression that results in a set.",
|
|
10476
|
+
},
|
|
10477
|
+
{
|
|
10478
|
+
title: "caption [OPTIONAL]",
|
|
10479
|
+
description: "Text shown in the cell.",
|
|
10480
|
+
},
|
|
10481
|
+
{
|
|
10482
|
+
title: "sort_order [OPTIONAL]",
|
|
10483
|
+
description: "How the set is sorted (0 none to 6 descending natural).",
|
|
10484
|
+
},
|
|
10485
|
+
{
|
|
10486
|
+
title: "sort_by [OPTIONAL]",
|
|
10487
|
+
description: "The value to sort by.",
|
|
10488
|
+
},
|
|
10489
|
+
],
|
|
10490
|
+
},
|
|
10491
|
+
{
|
|
10492
|
+
datatype: "Database",
|
|
10493
|
+
title: "CUBESETCOUNT",
|
|
10494
|
+
syntax: "CUBESETCOUNT(set)",
|
|
10495
|
+
description: "Returns the number of items in a cube set. Athena has no connection to this provider, so the call returns #NAME?, as Excel does without a cube connection.",
|
|
10496
|
+
example: "CUBESETCOUNT(CUBESET(\"Sales\",\"[Product].[All Products].Children\"))",
|
|
10497
|
+
usage: ["CUBESETCOUNT(CUBESET(\"Sales\",\"[Product].[All Products].Children\"))"],
|
|
10498
|
+
parameters: [
|
|
10499
|
+
{
|
|
10500
|
+
title: "set",
|
|
10501
|
+
description: "A CUBESET result or a reference to a CUBESET cell.",
|
|
10502
|
+
},
|
|
10503
|
+
],
|
|
10504
|
+
},
|
|
10505
|
+
{
|
|
10506
|
+
datatype: "Database",
|
|
10507
|
+
title: "CUBEVALUE",
|
|
10508
|
+
syntax: "CUBEVALUE(connection, [member_expression1], ...)",
|
|
10509
|
+
description: "Returns an aggregated value from an OLAP cube. Athena has no connection to this provider, so the call returns #NAME?, as Excel does without a cube connection.",
|
|
10510
|
+
example: "CUBEVALUE(\"Sales\",\"[Measures].[Profit]\",\"[Time].[2024]\")",
|
|
10511
|
+
usage: ["CUBEVALUE(\"Sales\",\"[Measures].[Profit]\",\"[Time].[2024]\")"],
|
|
10512
|
+
parameters: [
|
|
10513
|
+
{
|
|
10514
|
+
title: "connection",
|
|
10515
|
+
description: "The name of the workbook connection to the cube.",
|
|
10516
|
+
},
|
|
10517
|
+
{
|
|
10518
|
+
title: "member_expression1 [OPTIONAL]",
|
|
10519
|
+
description: "An MDX expression for a member or tuple; more may follow.",
|
|
10520
|
+
},
|
|
10521
|
+
],
|
|
10522
|
+
},
|
|
10523
|
+
{
|
|
10524
|
+
datatype: "Lookup",
|
|
10525
|
+
title: "RTD",
|
|
10526
|
+
syntax: "RTD(prog_id, server, topic1, [topic2], ...)",
|
|
10527
|
+
description: "Retrieves real-time data from a program that supports COM automation. Athena has no real-time data server, so the call returns #N/A, as Excel does when the server is not installed.",
|
|
10528
|
+
example: "RTD(\"mytest.rtd\",,\"Price\")",
|
|
10529
|
+
usage: ["RTD(\"mytest.rtd\",,\"Price\")"],
|
|
10530
|
+
parameters: [
|
|
10531
|
+
{
|
|
10532
|
+
title: "prog_id",
|
|
10533
|
+
description: "The registered ProgID of the RTD server.",
|
|
10534
|
+
},
|
|
10535
|
+
{
|
|
10536
|
+
title: "server",
|
|
10537
|
+
description: "The server that runs the RTD server; blank for the local machine.",
|
|
10538
|
+
},
|
|
10539
|
+
{
|
|
10540
|
+
title: "topic1",
|
|
10541
|
+
description: "The data to retrieve; up to 253 topics.",
|
|
10542
|
+
},
|
|
10543
|
+
],
|
|
10544
|
+
},
|
|
10545
|
+
{
|
|
10546
|
+
datatype: "Info",
|
|
10547
|
+
title: "STOCKHISTORY",
|
|
10548
|
+
syntax: "STOCKHISTORY(stock, start_date, [end_date], [interval], [headers], [property0], ...)",
|
|
10549
|
+
description: "Retrieves historical data about a financial instrument as an array. Athena has no connection to the stock data service, so the call returns #CONNECT!.",
|
|
10550
|
+
example: "STOCKHISTORY(\"MSFT\",\"1/1/2024\",\"1/31/2024\")",
|
|
10551
|
+
usage: ["STOCKHISTORY(\"MSFT\",\"1/1/2024\",\"1/31/2024\")"],
|
|
10552
|
+
parameters: [
|
|
10553
|
+
{
|
|
10554
|
+
title: "stock",
|
|
10555
|
+
description: "A ticker symbol in quotes or a Stocks data type.",
|
|
10556
|
+
},
|
|
10557
|
+
{
|
|
10558
|
+
title: "start_date",
|
|
10559
|
+
description: "The earliest date to retrieve.",
|
|
10560
|
+
},
|
|
10561
|
+
{
|
|
10562
|
+
title: "end_date [OPTIONAL]",
|
|
10563
|
+
description: "The latest date to retrieve; defaults to start_date.",
|
|
10564
|
+
},
|
|
10565
|
+
{
|
|
10566
|
+
title: "interval [OPTIONAL]",
|
|
10567
|
+
description: "0 daily (default), 1 weekly, 2 monthly.",
|
|
10568
|
+
},
|
|
10569
|
+
{
|
|
10570
|
+
title: "headers [OPTIONAL]",
|
|
10571
|
+
description: "0 no headers, 1 headers (default), 2 instrument identifier and headers.",
|
|
10572
|
+
},
|
|
10573
|
+
{
|
|
10574
|
+
title: "property0 [OPTIONAL]",
|
|
10575
|
+
description: "Columns to return: 0 Date, 1 Close, 2 Open, 3 High, 4 Low, 5 Volume.",
|
|
10576
|
+
},
|
|
10577
|
+
],
|
|
10578
|
+
},
|
|
10579
|
+
{
|
|
10580
|
+
datatype: "Text",
|
|
10581
|
+
title: "TRANSLATE",
|
|
10582
|
+
syntax: "TRANSLATE(text, [source_language], [target_language])",
|
|
10583
|
+
description: "Translates text from one language to another. Athena has no connection to the translation service, so the call returns #CONNECT!.",
|
|
10584
|
+
example: "TRANSLATE(\"Hello\",\"en\",\"fr\")",
|
|
10585
|
+
usage: ["TRANSLATE(\"Hello\",\"en\",\"fr\")"],
|
|
10586
|
+
parameters: [
|
|
10587
|
+
{
|
|
10588
|
+
title: "text",
|
|
10589
|
+
description: "The text to translate.",
|
|
10590
|
+
},
|
|
10591
|
+
{
|
|
10592
|
+
title: "source_language [OPTIONAL]",
|
|
10593
|
+
description: "Language code of the text; detected when omitted.",
|
|
10594
|
+
},
|
|
10595
|
+
{
|
|
10596
|
+
title: "target_language [OPTIONAL]",
|
|
10597
|
+
description: "Language code to translate into.",
|
|
10598
|
+
},
|
|
10599
|
+
],
|
|
10600
|
+
},
|
|
10601
|
+
{
|
|
10602
|
+
datatype: "Text",
|
|
10603
|
+
title: "DETECTLANGUAGE",
|
|
10604
|
+
syntax: "DETECTLANGUAGE(text)",
|
|
10605
|
+
description: "Identifies the language of a text. Athena has no connection to the translation service, so the call returns #CONNECT!.",
|
|
10606
|
+
example: "DETECTLANGUAGE(\"Bonjour\")",
|
|
10607
|
+
usage: ["DETECTLANGUAGE(\"Bonjour\")"],
|
|
10608
|
+
parameters: [
|
|
10609
|
+
{
|
|
10610
|
+
title: "text",
|
|
10611
|
+
description: "The text whose language to detect.",
|
|
10612
|
+
},
|
|
10613
|
+
],
|
|
10614
|
+
},
|
|
10615
|
+
{
|
|
10616
|
+
datatype: "Financial",
|
|
10617
|
+
title: "EUROCONVERT",
|
|
10618
|
+
syntax: "EUROCONVERT(number, source, target, [full_precision], [triangulation_precision])",
|
|
10619
|
+
description: "Converts a number to euros, from euros to a euro member currency, or between member currencies through the euro, at the fixed EU conversion rates.",
|
|
10620
|
+
example: "EUROCONVERT(1.2,\"DEM\",\"EUR\")",
|
|
10621
|
+
usage: ["EUROCONVERT(1.2,\"DEM\",\"EUR\")"],
|
|
10622
|
+
parameters: [
|
|
10623
|
+
{
|
|
10624
|
+
title: "number",
|
|
10625
|
+
description: "The amount to convert.",
|
|
10626
|
+
},
|
|
10627
|
+
{
|
|
10628
|
+
title: "source",
|
|
10629
|
+
description: "ISO code of the source currency: EUR, BEF, LUF, DEM, ESP, FRF, IEP, ITL, NLG, ATS, PTE, FIM, GRD or SIT.",
|
|
10630
|
+
},
|
|
10631
|
+
{
|
|
10632
|
+
title: "target",
|
|
10633
|
+
description: "ISO code of the target currency.",
|
|
10634
|
+
},
|
|
10635
|
+
{
|
|
10636
|
+
title: "full_precision [OPTIONAL]",
|
|
10637
|
+
description: "TRUE keeps every digit; FALSE (default) rounds to the target currency's decimals.",
|
|
10638
|
+
},
|
|
10639
|
+
{
|
|
10640
|
+
title: "triangulation_precision [OPTIONAL]",
|
|
10641
|
+
description: "Decimals (3 or more) for the intermediate euro value.",
|
|
10642
|
+
},
|
|
10643
|
+
],
|
|
10644
|
+
},
|
|
10645
|
+
{
|
|
10646
|
+
datatype: "Web",
|
|
10647
|
+
title: "IMPORTTEXT",
|
|
10648
|
+
syntax: "IMPORTTEXT(path, [delimiter], [skip_rows], [take_rows], [encoding], [locale])",
|
|
10649
|
+
description: "Imports a text file (CSV, TSV, TXT) as an array. Athena cannot read files from a local path, so the call returns #BLOCKED!.",
|
|
10650
|
+
example: "IMPORTTEXT(\"C:\\\\data\\\\sales.txt\",\",\")",
|
|
10651
|
+
usage: ["IMPORTTEXT(\"C:\\\\data\\\\sales.txt\",\",\")"],
|
|
10652
|
+
parameters: [
|
|
10653
|
+
{
|
|
10654
|
+
title: "path",
|
|
10655
|
+
description: "The file path or URL of the text file.",
|
|
10656
|
+
},
|
|
10657
|
+
{
|
|
10658
|
+
title: "delimiter [OPTIONAL]",
|
|
10659
|
+
description: "The column delimiter; tab by default.",
|
|
10660
|
+
},
|
|
10661
|
+
{
|
|
10662
|
+
title: "skip_rows [OPTIONAL]",
|
|
10663
|
+
description: "Rows to skip from the start (negative: from the end).",
|
|
10664
|
+
},
|
|
10665
|
+
{
|
|
10666
|
+
title: "take_rows [OPTIONAL]",
|
|
10667
|
+
description: "Rows to return (negative: from the end).",
|
|
10668
|
+
},
|
|
10669
|
+
{
|
|
10670
|
+
title: "encoding [OPTIONAL]",
|
|
10671
|
+
description: "The file encoding; UTF-8 by default.",
|
|
10672
|
+
},
|
|
10673
|
+
{
|
|
10674
|
+
title: "locale [OPTIONAL]",
|
|
10675
|
+
description: "The locale for numbers and dates.",
|
|
10676
|
+
},
|
|
10677
|
+
],
|
|
10678
|
+
},
|
|
10679
|
+
{
|
|
10680
|
+
datatype: "Web",
|
|
10681
|
+
title: "IMPORTCSV",
|
|
10682
|
+
syntax: "IMPORTCSV(path, [skip_rows], [take_rows], [locale])",
|
|
10683
|
+
description: "Imports a CSV file as an array. Athena cannot read files from a local path, so the call returns #BLOCKED!.",
|
|
10684
|
+
example: "IMPORTCSV(\"C:\\\\data\\\\sales.csv\")",
|
|
10685
|
+
usage: ["IMPORTCSV(\"C:\\\\data\\\\sales.csv\")"],
|
|
10686
|
+
parameters: [
|
|
10687
|
+
{
|
|
10688
|
+
title: "path",
|
|
10689
|
+
description: "The file path or URL of the CSV file.",
|
|
10690
|
+
},
|
|
10691
|
+
{
|
|
10692
|
+
title: "skip_rows [OPTIONAL]",
|
|
10693
|
+
description: "Rows to skip from the start (negative: from the end).",
|
|
10694
|
+
},
|
|
10695
|
+
{
|
|
10696
|
+
title: "take_rows [OPTIONAL]",
|
|
10697
|
+
description: "Rows to return (negative: from the end).",
|
|
10698
|
+
},
|
|
10699
|
+
{
|
|
10700
|
+
title: "locale [OPTIONAL]",
|
|
10701
|
+
description: "The locale for numbers and dates.",
|
|
10702
|
+
},
|
|
10703
|
+
],
|
|
10704
|
+
},
|
|
10705
|
+
{
|
|
10706
|
+
datatype: "Info",
|
|
10707
|
+
title: "PY",
|
|
10708
|
+
syntax: "PY(python_code, return_type)",
|
|
10709
|
+
description: "Runs Python code (Python in Excel). Athena has no Python in Excel runtime, so the call returns #BLOCKED!.",
|
|
10710
|
+
example: "PY(\"1+1\",0)",
|
|
10711
|
+
usage: ["PY(\"1+1\",0)"],
|
|
10712
|
+
parameters: [
|
|
10713
|
+
{
|
|
10714
|
+
title: "python_code",
|
|
10715
|
+
description: "The Python code to run.",
|
|
10716
|
+
},
|
|
10717
|
+
{
|
|
10718
|
+
title: "return_type",
|
|
10719
|
+
description: "0 returns an Excel value, 1 a Python object.",
|
|
10720
|
+
},
|
|
10721
|
+
],
|
|
10722
|
+
},
|
|
10723
|
+
{
|
|
10724
|
+
datatype: "Info",
|
|
10725
|
+
title: "FIELDVALUE",
|
|
10726
|
+
syntax: "FIELDVALUE(value, field_name)",
|
|
10727
|
+
description: "Returns a field from a linked data type value, the same as value.field_name. Athena has no linked data types, so the call returns #FIELD!.",
|
|
10728
|
+
example: "FIELDVALUE(A2,\"Price\")",
|
|
10729
|
+
usage: ["FIELDVALUE(A2,\"Price\")"],
|
|
10730
|
+
parameters: [
|
|
10731
|
+
{
|
|
10732
|
+
title: "value",
|
|
10733
|
+
description: "A cell holding a linked data type.",
|
|
10734
|
+
},
|
|
10735
|
+
{
|
|
10736
|
+
title: "field_name",
|
|
10737
|
+
description: "The name of the field to return.",
|
|
10738
|
+
},
|
|
10739
|
+
],
|
|
10740
|
+
},
|
|
9808
10741
|
];
|