@rowsncolumns/functions 14.0.31 → 14.0.33

package/dist/cjs/function-descriptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"function-descriptions.d.ts","sourceRoot":"","sources":["../../function-descriptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,EAigVpD,CAAC"}
+{"version":3,"file":"function-descriptions.d.ts","sourceRoot":"","sources":["../../function-descriptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,EA8iVpD,CAAC"}

package/dist/cjs/function-descriptions.js

@@ -7067,6 +7067,28 @@ exports.functionDescriptions = [
             },
         ],
     },
+    {
+        datatype: "Filter",
+        title: "TRIMRANGE",
+        syntax: "TRIMRANGE(range, [trim_rows], [trim_cols])",
+        description: "Excludes the blank rows and columns at the edges of a range or array, so a formula over a whole column works on the data actually present.",
+        example: "TRIMRANGE(A1:A100)",
+        usage: ["TRIMRANGE(A:A)", "TRIMRANGE(A1:E10, 2)", "TRIMRANGE(A1:E10, 3, 0)"],
+        parameters: [
+            {
+                title: "range",
+                description: "The range or array to trim.",
+            },
+            {
+                title: "trim_rows [OPTIONAL]",
+                description: "0 keeps every row, 1 trims leading blank rows, 2 trims trailing blank rows, 3 (default) trims both.",
+            },
+            {
+                title: "trim_cols [OPTIONAL]",
+                description: "0 keeps every column, 1 trims leading blank columns, 2 trims trailing blank columns, 3 (default) trims both.",
+            },
+        ],
+    },
     {
         datatype: "Filter",
         title: "EXPAND",
@@ -7452,6 +7474,24 @@ exports.functionDescriptions = [
             },
         ],
     },
+    {
+        datatype: "Math",
+        title: "PERCENTOF",
+        syntax: "PERCENTOF(data_subset, data_all)",
+        description: "Returns the share of a subset within a whole: SUM(data_subset) divided by SUM(data_all).",
+        example: "PERCENTOF(A1:A2, A1:A10)",
+        usage: ["PERCENTOF(A1:A2, A1:A10)", "PERCENTOF(B5, B1:B10)"],
+        parameters: [
+            {
+                title: "data_subset",
+                description: "The values whose total is the numerator.",
+            },
+            {
+                title: "data_all",
+                description: "The values whose total is the denominator; a total of zero returns #DIV/0!.",
+            },
+        ],
+    },
     {
         datatype: "Math",
         title: "SUMSQ",

package/dist/esm/function-descriptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"function-descriptions.d.ts","sourceRoot":"","sources":["../../function-descriptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,EAigVpD,CAAC"}
+{"version":3,"file":"function-descriptions.d.ts","sourceRoot":"","sources":["../../function-descriptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,EA8iVpD,CAAC"}

package/dist/esm/function-descriptions.js

@@ -7064,6 +7064,28 @@ export const functionDescriptions = [
             },
         ],
     },
+    {
+        datatype: "Filter",
+        title: "TRIMRANGE",
+        syntax: "TRIMRANGE(range, [trim_rows], [trim_cols])",
+        description: "Excludes the blank rows and columns at the edges of a range or array, so a formula over a whole column works on the data actually present.",
+        example: "TRIMRANGE(A1:A100)",
+        usage: ["TRIMRANGE(A:A)", "TRIMRANGE(A1:E10, 2)", "TRIMRANGE(A1:E10, 3, 0)"],
+        parameters: [
+            {
+                title: "range",
+                description: "The range or array to trim.",
+            },
+            {
+                title: "trim_rows [OPTIONAL]",
+                description: "0 keeps every row, 1 trims leading blank rows, 2 trims trailing blank rows, 3 (default) trims both.",
+            },
+            {
+                title: "trim_cols [OPTIONAL]",
+                description: "0 keeps every column, 1 trims leading blank columns, 2 trims trailing blank columns, 3 (default) trims both.",
+            },
+        ],
+    },
     {
         datatype: "Filter",
         title: "EXPAND",
@@ -7449,6 +7471,24 @@ export const functionDescriptions = [
             },
         ],
     },
+    {
+        datatype: "Math",
+        title: "PERCENTOF",
+        syntax: "PERCENTOF(data_subset, data_all)",
+        description: "Returns the share of a subset within a whole: SUM(data_subset) divided by SUM(data_all).",
+        example: "PERCENTOF(A1:A2, A1:A10)",
+        usage: ["PERCENTOF(A1:A2, A1:A10)", "PERCENTOF(B5, B1:B10)"],
+        parameters: [
+            {
+                title: "data_subset",
+                description: "The values whose total is the numerator.",
+            },
+            {
+                title: "data_all",
+                description: "The values whose total is the denominator; a total of zero returns #DIV/0!.",
+            },
+        ],
+    },
     {
         datatype: "Math",
         title: "SUMSQ",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rowsncolumns/functions",
-  "version": "14.0.31",
+  "version": "14.0.33",
   "author": "Vinay M",
   "license": "SEE LICENSE IN LICENSE.md",
   "main": "./dist/cjs/index.js",
@@ -32,18 +32,18 @@
     "url": "https://github.com/rowsncolumns/spreadsheet/issues"
   },
   "devDependencies": {
-    "@rowsncolumns/common-types": ">=5.2.31",
-    "@rowsncolumns/calculator": ">=7.2.31",
-    "@rowsncolumns/fast-formula-parser": ">=6.2.36",
-    "@rowsncolumns/utils": ">=9.2.40",
-    "@rowsncolumns/toolkit": ">=24.4.3"
+    "@rowsncolumns/common-types": ">=5.2.32",
+    "@rowsncolumns/calculator": ">=7.2.32",
+    "@rowsncolumns/fast-formula-parser": ">=6.2.38",
+    "@rowsncolumns/utils": ">=9.2.43",
+    "@rowsncolumns/toolkit": ">=24.4.4"
   },
   "peerDependencies": {
-    "@rowsncolumns/common-types": ">=5.2.31",
-    "@rowsncolumns/calculator": ">=7.2.31",
-    "@rowsncolumns/fast-formula-parser": ">=6.2.36",
-    "@rowsncolumns/utils": ">=9.2.40",
-    "@rowsncolumns/toolkit": ">=24.4.3"
+    "@rowsncolumns/common-types": ">=5.2.32",
+    "@rowsncolumns/calculator": ">=7.2.32",
+    "@rowsncolumns/fast-formula-parser": ">=6.2.38",
+    "@rowsncolumns/utils": ">=9.2.43",
+    "@rowsncolumns/toolkit": ">=24.4.4"
   },
   "dependencies": {
     "xlsx": "^0.18.5"