@univerjs/sheets-formula 0.1.16 → 0.2.0

package/lib/locale/en-US.json

@@ -1155,7 +1155,7 @@
         }
       },
       "DATEVALUE": {
-        "description": "Converts a date in the form of text to a serial number",
+        "description": "Converts a date in the form of text to a serial number.",
         "abstract": "Converts a date in the form of text to a serial number",
         "links": [
           {
@@ -1164,13 +1164,9 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
-          },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "dateText": {
+            "name": "date_text",
+            "detail": "Text that represents a date in an Excel date format, or a reference to a cell that contains text that represents a date in an Excel date format. For example, \"1/30/2008\" or \"30-Jan-2008\" are text strings within quotation marks that represent dates.\nUsing the default date system in Microsoft Excel for Windows, the date_text argument must represent a date between January 1, 1900 and December 31, 9999. The DATEVALUE function returns the #VALUE! error value if the value of the date_text argument falls outside of this range.\nIf the year portion of the date_text argument is omitted, the DATEVALUE function uses the current year from your computer's built-in clock. Time information in the date_text argument is ignored."
           }
         }
       },
@@ -1387,7 +1383,7 @@
         }
       },
       "NOW": {
-        "description": "Returns the serial number of the current date and time",
+        "description": "Returns the serial number of the current date and time.",
         "abstract": "Returns the serial number of the current date and time",
         "links": [
           {
@@ -1395,16 +1391,7 @@
             "url": "https://support.microsoft.com/en-us/office/now-function-3337fd29-145a-4347-b2e6-20c904739c46"
           }
         ],
-        "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
-          },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
-          }
-        }
+        "functionParameter": {}
       },
       "SECOND": {
         "description": "Converts a serial number to a second",
@@ -1427,7 +1414,7 @@
         }
       },
       "TIME": {
-        "description": "Returns the serial number of a particular time",
+        "description": "Returns the serial number of a particular time.",
         "abstract": "Returns the serial number of a particular time",
         "links": [
           {
@@ -1436,18 +1423,22 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
+          "hour": {
+            "name": "hour",
+            "detail": "A number from 0 (zero) to 32767 representing the hour. Any value greater than 23 will be divided by 24 and the remainder will be treated as the hour value. For example, TIME(27,0,0) = TIME(3,0,0) = .125 or 3:00 AM."
           },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "minute": {
+            "name": "minute",
+            "detail": "A number from 0 to 32767 representing the minute. Any value greater than 59 will be converted to hours and minutes. For example, TIME(0,750,0) = TIME(12,30,0) = .520833 or 12:30 PM."
+          },
+          "second": {
+            "name": "second",
+            "detail": "A number from 0 to 32767 representing the second. Any value greater than 59 will be converted to hours, minutes, and seconds. For example, TIME(0,0,2000) = TIME(0,33,22) = .023148 or 12:33:20 AM."
           }
         }
       },
       "TIMEVALUE": {
-        "description": "Converts a time in the form of text to a serial number",
+        "description": "Converts a time in the form of text to a serial number.",
         "abstract": "Converts a time in the form of text to a serial number",
         "links": [
           {
@@ -1456,13 +1447,9 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
-          },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "timeText": {
+            "name": "time_text",
+            "detail": "A text string that represents a time in any one of the Microsoft Excel time formats; for example, \"6:45 PM\" and \"18:45\" text strings within quotation marks that represent time."
           }
         }
       },
@@ -1718,7 +1705,7 @@
         }
       },
       "ASIN": {
-        "description": "Returns the arcsine of a number",
+        "description": "Returns the arcsine of a number.",
         "abstract": "Returns the arcsine of a number",
         "links": [
           {
@@ -1727,18 +1714,14 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
-          },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "number": {
+            "name": "number",
+            "detail": "The sine of the angle you want and must be from -1 to 1."
           }
         }
       },
       "ASINH": {
-        "description": "Returns the inverse hyperbolic sine of a number",
+        "description": "Returns the inverse hyperbolic sine of a number.",
         "abstract": "Returns the inverse hyperbolic sine of a number",
         "links": [
           {
@@ -1747,18 +1730,14 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
-          },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "number": {
+            "name": "number",
+            "detail": "Any real number."
           }
         }
       },
       "ATAN": {
-        "description": "Returns the arctangent of a number",
+        "description": "Returns the arctangent of a number.",
         "abstract": "Returns the arctangent of a number",
         "links": [
           {
@@ -1767,18 +1746,14 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
-          },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "number": {
+            "name": "number",
+            "detail": "The tangent of the angle you want."
           }
         }
       },
       "ATAN2": {
-        "description": "Returns the arctangent from x- and y-coordinates",
+        "description": "Returns the arctangent from x- and y-coordinates.",
         "abstract": "Returns the arctangent from x- and y-coordinates",
         "links": [
           {
@@ -1787,18 +1762,18 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
+          "xNum": {
+            "name": "x_num",
+            "detail": "The x-coordinate of the point."
           },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "yNum": {
+            "name": "y_num",
+            "detail": "The y-coordinate of the point."
           }
         }
       },
       "ATANH": {
-        "description": "Returns the inverse hyperbolic tangent of a number",
+        "description": "Returns the inverse hyperbolic tangent of a number.",
         "abstract": "Returns the inverse hyperbolic tangent of a number",
         "links": [
           {
@@ -1807,13 +1782,9 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
-          },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "number": {
+            "name": "number",
+            "detail": "Any real number between 1 and -1."
           }
         }
       },
@@ -1938,7 +1909,7 @@
         }
       },
       "COS": {
-        "description": "Returns the cosine of a number",
+        "description": "Returns the cosine of a number.",
         "abstract": "Returns the cosine of a number",
         "links": [
           {
@@ -1947,13 +1918,9 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
-          },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "number": {
+            "name": "number",
+            "detail": "The angle in radians for which you want the cosine."
           }
         }
       },
@@ -3178,7 +3145,7 @@
         }
       },
       "TAN": {
-        "description": "Returns the tangent of a number",
+        "description": "Returns the tangent of a number.",
         "abstract": "Returns the tangent of a number",
         "links": [
           {
@@ -3187,18 +3154,14 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
-          },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "number": {
+            "name": "number",
+            "detail": "The angle in radians for which you want the tangent."
           }
         }
       },
       "TANH": {
-        "description": "Returns the hyperbolic tangent of a number",
+        "description": "Returns the hyperbolic tangent of a number.",
         "abstract": "Returns the hyperbolic tangent of a number",
         "links": [
           {
@@ -3207,13 +3170,9 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
-          },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "number": {
+            "name": "number",
+            "detail": "Any real number."
           }
         }
       },
@@ -3238,7 +3197,7 @@
         }
       },
       "AVEDEV": {
-        "description": "Returns the average of the absolute deviations of data points from their mean",
+        "description": "Returns the average of the absolute deviations of data points from their mean.",
         "abstract": "Returns the average of the absolute deviations of data points from their mean",
         "links": [
           {
@@ -3249,11 +3208,11 @@
         "functionParameter": {
           "number1": {
             "name": "number1",
-            "detail": "first"
+            "detail": "The first number, cell reference, or range for which you want the average."
           },
           "number2": {
             "name": "number2",
-            "detail": "second"
+            "detail": "Additional numbers, cell references or ranges for which you want the average, up to a maximum of 255."
           }
         }
       },
@@ -3278,7 +3237,7 @@
         }
       },
       "AVERAGEA": {
-        "description": "Returns the average of its arguments, including numbers, text, and logical values",
+        "description": "Returns the average of its arguments, including numbers, text, and logical values.",
         "abstract": "Returns the average of its arguments, including numbers, text, and logical values",
         "links": [
           {
@@ -3287,18 +3246,18 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
+          "value1": {
+            "name": "value1",
+            "detail": "The first number, cell reference, or range for which you want the average."
           },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "value2": {
+            "name": "value2",
+            "detail": "Additional numbers, cell references or ranges for which you want the average, up to a maximum of 255."
           }
         }
       },
       "AVERAGEIF": {
-        "description": "Returns the average (arithmetic mean) of all the cells in a range that meet a given criteria",
+        "description": "Returns the average (arithmetic mean) of all the cells in a range that meet a given criteria.",
         "abstract": "Returns the average (arithmetic mean) of all the cells in a range that meet a given criteria",
         "links": [
           {
@@ -3307,18 +3266,22 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
+          "range": {
+            "name": "range",
+            "detail": "One or more cells to average, including numbers or names, arrays, or references that contain numbers."
           },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "criteria": {
+            "name": "criteria",
+            "detail": "The criteria in the form of a number, expression, cell reference, or text that defines which cells are averaged. For example, criteria can be expressed as 32, \"32\", \">32\", \"apples\", or B4."
+          },
+          "averageRange": {
+            "name": "average_range",
+            "detail": "The actual set of cells to average. If omitted, range is used."
           }
         }
       },
       "AVERAGEIFS": {
-        "description": "Returns the average (arithmetic mean) of all cells that meet multiple criteria",
+        "description": "Returns the average (arithmetic mean) of all cells that meet multiple criteria.",
         "abstract": "Returns the average (arithmetic mean) of all cells that meet multiple criteria",
         "links": [
           {
@@ -3327,13 +3290,25 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
+          "averageRange": {
+            "name": "average_range",
+            "detail": "One or more cells to average, including numbers or names, arrays, or references that contain numbers."
           },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "criteriaRange1": {
+            "name": "criteria_range1",
+            "detail": "Is the set of cells to evaluate with the criteria."
+          },
+          "criteria1": {
+            "name": "criteria1",
+            "detail": "Used to define the cells for which the average will be calculated. For example, the criteria can be expressed as 32, \"32\", \">32\", \"apple\", or B4"
+          },
+          "criteriaRange2": {
+            "name": "criteria_range2",
+            "detail": "Additional ranges. You can enter up to 127 range."
+          },
+          "criteria2": {
+            "name": "criteria2",
+            "detail": "Additional associated criteria. You can enter up to 127 criteria."
           }
         }
       },
@@ -3638,7 +3613,7 @@
         }
       },
       "COUNTBLANK": {
-        "description": "Counts the number of blank cells within a range",
+        "description": "Counts the number of blank cells within a range.",
         "abstract": "Counts the number of blank cells within a range",
         "links": [
           {
@@ -3647,18 +3622,14 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
-          },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "range": {
+            "name": "range",
+            "detail": "The range from which you want to count the blank cells."
           }
         }
       },
       "COUNTIF": {
-        "description": "Counts the number of cells within a range that meet the given criteria",
+        "description": "Counts the number of cells within a range that meet the given criteria.",
         "abstract": "Counts the number of cells within a range that meet the given criteria",
         "links": [
           {
@@ -3667,18 +3638,18 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
+          "range": {
+            "name": "range",
+            "detail": "The group of cells you want to count. Range can contain numbers, arrays, a named range, or references that contain numbers. Blank and text values are ignored."
           },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "criteria": {
+            "name": "criteria",
+            "detail": "A number, expression, cell reference, or text string that determines which cells will be counted.\nFor example, you can use a number like 32, a comparison like \">32\", a cell like B4, or a word like \"apples\".\nCOUNTIF uses only a single criteria. Use COUNTIFS if you want to use multiple criteria."
           }
         }
       },
       "COUNTIFS": {
-        "description": "Counts the number of cells within a range that meet multiple criteria",
+        "description": "Counts the number of cells within a range that meet multiple criteria.",
         "abstract": "Counts the number of cells within a range that meet multiple criteria",
         "links": [
           {
@@ -3687,13 +3658,21 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
+          "criteriaRange1": {
+            "name": "criteria_range1",
+            "detail": "The first range in which to evaluate the associated criteria."
           },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "criteria1": {
+            "name": "criteria1",
+            "detail": "The criteria in the form of a number, expression, cell reference, or text that define which cells will be counted. For example, criteria can be expressed as 32, \">32\", B4, \"apples\", or \"32\"."
+          },
+          "criteriaRange2": {
+            "name": "criteria_range2",
+            "detail": "Additional ranges. You can enter up to 127 range."
+          },
+          "criteria2": {
+            "name": "criteria2",
+            "detail": "Additional associated criteria. You can enter up to 127 criteria."
           }
         }
       },
@@ -4418,7 +4397,7 @@
         }
       },
       "MAXA": {
-        "description": "Returns the maximum value in a list of arguments, including numbers, text, and logical values",
+        "description": "Returns the maximum value in a list of arguments, including numbers, text, and logical values.",
         "abstract": "Returns the maximum value in a list of arguments, including numbers, text, and logical values",
         "links": [
           {
@@ -4427,18 +4406,18 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
+          "value1": {
+            "name": "value1",
+            "detail": "The first number argument for which you want to find the largest value."
           },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "value2": {
+            "name": "value2",
+            "detail": "Number arguments 2 to 255 for which you want to find the largest value."
           }
         }
       },
       "MAXIFS": {
-        "description": "Returns the maximum value among cells specified by a given set of conditions or criteria",
+        "description": "Returns the maximum value among cells specified by a given set of conditions or criteria.",
         "abstract": "Returns the maximum value among cells specified by a given set of conditions or criteria",
         "links": [
           {
@@ -4461,11 +4440,11 @@
           },
           "criteriaRange2": {
             "name": "criteriaRange2",
-            "detail": "Additional ranges. You can enter up to 127 range pairs."
+            "detail": "Additional ranges. You can enter up to 127 ranges."
           },
           "criteria2": {
             "name": "criteria2",
-            "detail": "Additional associated criteria. You can enter up to 127 criteria pairs."
+            "detail": "Additional associated criteria. You can enter up to 127 criteria."
           }
         }
       },
@@ -4519,19 +4498,19 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
+          "value1": {
+            "name": "value1",
+            "detail": "The first number, cell reference, or range to calculate the minimum value from."
           },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "value2": {
+            "name": "value2",
+            "detail": "Additional numbers, cell references or ranges to calculate the minimum value from, up to a maximum of 255."
           }
         }
       },
       "MINIFS": {
         "description": "Returns the minimum value among cells specified by a given set of conditions or criteria.",
-        "abstract": "Returns the minimum value among cells specified by a given set of conditions or criteria.",
+        "abstract": "Returns the minimum value among cells specified by a given set of conditions or criteria",
         "links": [
           {
             "title": "Instruction",
@@ -4539,13 +4518,25 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
+          "minRange": {
+            "name": "min_range",
+            "detail": "The actual range of cells in which the minimum value will be determined."
           },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "criteriaRange1": {
+            "name": "criteria_range1",
+            "detail": "Is the set of cells to evaluate with the criteria."
+          },
+          "criteria1": {
+            "name": "criteria1",
+            "detail": "Is the criteria in the form of a number, expression, or text that defines which cells will be evaluated as minimum. The same set of criteria works for the MAXIFS, SUMIFS and AVERAGEIFS functions."
+          },
+          "criteriaRange2": {
+            "name": "criteria_range2",
+            "detail": "Additional ranges. You can enter up to 127 range."
+          },
+          "criteria2": {
+            "name": "criteria2",
+            "detail": "Additional associated criteria. You can enter up to 127 criteria."
           }
         }
       },
@@ -5522,7 +5513,7 @@
         }
       },
       "CHOOSE": {
-        "description": "Chooses a value from a list of values",
+        "description": "Chooses a value from a list of values.",
         "abstract": "Chooses a value from a list of values",
         "links": [
           {
@@ -5531,13 +5522,17 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
+          "indexNum": {
+            "name": "index_num",
+            "detail": "Specifies which value argument is selected. Index_num must be a number between 1 and 254, or a formula or reference to a cell containing a number between 1 and 254.\nIf index_num is 1, CHOOSE returns value1; if it is 2, CHOOSE returns value2; and so on.\nIf index_num is less than 1 or greater than the number of the last value in the list, CHOOSE returns the #VALUE! error value.\nIf index_num is a fraction, it is truncated to the lowest integer before being used."
           },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "value1": {
+            "name": "value1",
+            "detail": "CHOOSE selects a value or an action to perform based on index_num. The arguments can be numbers, cell references, defined names, formulas, functions, or text."
+          },
+          "value2": {
+            "name": "value2",
+            "detail": "1 to 254 value arguments."
           }
         }
       },
@@ -6635,7 +6630,7 @@
       },
       "CONCAT": {
         "description": "Combines the text from multiple ranges and/or strings, but it doesn't provide the delimiter or IgnoreEmpty arguments.",
-        "abstract": "Combines the text from multiple ranges and/or strings, but it doesn't provide the delimiter or IgnoreEmpty arguments.",
+        "abstract": "Combines the text from multiple ranges and/or strings, but it doesn't provide the delimiter or IgnoreEmpty arguments",
         "links": [
           {
             "title": "Instruction",
@@ -6643,13 +6638,13 @@
           }
         ],
         "functionParameter": {
-          "number1": {
-            "name": "number1",
-            "detail": "first"
+          "text1": {
+            "name": "text1",
+            "detail": "Text item to be joined. A string, or array of strings, such as a range of cells."
           },
-          "number2": {
-            "name": "number2",
-            "detail": "second"
+          "text2": {
+            "name": "text2",
+            "detail": "Additional text items to be joined. There can be a maximum of 253 text arguments for the text items. Each can be a string, or array of strings, such as a range of cells."
           }
         }
       },