Merge pull request #99137 from ecfan/formatNumber

Add missing formatNumber function

Author: PRMerger6

articles/logic-apps/workflow-definition-language-functions-reference.md

@@ -104,6 +104,7 @@ String functions work only on strings.
 | --------------- | ---- |
 | [concat](../logic-apps/workflow-definition-language-functions-reference.md#concat) | Combine two or more strings, and return the combined string. |
 | [endsWith](../logic-apps/workflow-definition-language-functions-reference.md#endswith) | Check whether a string ends with the specified substring. |
+| [formatNumber](../logic-apps/workflow-definition-language-functions-reference.md#formatNumber) | Return a number as a string based on the specified format |
 | [guid](../logic-apps/workflow-definition-language-functions-reference.md#guid) | Generate a globally unique identifier (GUID) as a string. |
 | [indexOf](../logic-apps/workflow-definition-language-functions-reference.md#indexof) | Return the starting position for a substring. |
 | [lastIndexOf](../logic-apps/workflow-definition-language-functions-reference.md#lastindexof) | Return the starting position for the last occurrence of a substring. |
@@ -2084,6 +2085,60 @@ formDataValue('Send_an_email', 'Subject')
 
 And returns the subject text as a string, for example: `"Hello world"`
 
+<a name="formatNumber"></a>
+
+### formatNumber
+
+Return a number as a string that's based on the specified format.
+
+```text
+formatNumber(<number>, <format>, <locale>?)
+```
+
+| Parameter | Required | Type | Description |
+| --------- | -------- | ---- | ----------- |
+| <*number*> | Yes | Integer or Double | The value that you want to format. |
+| <*format*> | Yes | String | A composite format string that specifies the format that you want to use. For the supported numeric format strings, see [Standard numeric format strings](https://docs.microsoft.com/dotnet/standard/base-types/standard-numeric-format-strings), which are supported by `number.ToString(<format>, <locale>)`. |
+| <*locale*> | No | String | The locale to use as supported by `number.ToString(<format>, <locale>)`. If not specified, the default value is `en-us`. |
+|||||
+
+| Return value | Type | Description |
+| ------------ | ---- | ----------- |
+| <*formatted-number*> | String | The specified number as a string in the format that you specified. You can cast this return value to an `int` or `float`. |
+||||
+
+*Example 1*
+
+Suppose that you want to format the number `1234567890`. This example formats that number as the string "1,234,567,890.00".
+
+```
+formatNumber(1234567890, "{0:0,0.00}", "en-us")
+```
+
+*Example 2"
+
+Suppose that you want to format the number `1234567890`. This example formats the number to the string "1.234.567.890,00".
+
+```
+formatNumber(1234567890, "{0:0,0.00}", "is-is")
+```
+
+*Example 3*
+
+Suppose that you want to format the number `17.35`. This example formats the number to the string "$17.35".
+
+```
+formatNumber(17.36, "{0:C2}")
+```
+
+*Example 4*
+
+Suppose that you want to format the number `17.35`. This example formats the number to the string "17,35 kr".
+
+```
+formatNumber(17.36, "{0:C2}", "is-is")
+```
+
 <a name="getFutureTime"></a>
 
 ### getFutureTime