Format Value

Build a formatted string using one or more input values. This includes adding various types of formatting to numbers and dates/times, and converting them to a string.

Inputs

Input		Value
`formatString`	Required	A format string, using .NET composite formatting. For instance, "Today is {0:dddd dd MMMM}" would convert a date input in `formatInput1` into day of week, day and month; the result `formattedValue` might read "Today is Thursday 3 May".
`formatInput#`	Optional	Inputs for the format string. In the format string, `formatInput1` will be referenced as `{0}`, `formatInput2` as `{1}`, etc. While these are optional, you will typically want to have at least one format input.

Outputs

Key	Value
`formattedValue`	The resulting formatted value after the format string is resolved.

Usage

Two uses for this action are:

Formatting a number or date in some way (e.g. expressing a number as a currency or expressing a date as dd/mm/yyyy). This is often useful when an input in a GoFormz form or a third-party field is expected in a certain format.
Combining multiple inputs into a single string. This can be useful for constructing a descriptive sentence summarizing a transaction, for instance.

In the example below, we illustrate both these uses by combining several inputs from a completed form into a more readable summary string, and formatting each input appropriately along the way. The inputs here are a date field and two numeric fields from the completed form, and the formatString reads "On {0:D}, purchased {1:C2} of equipment at a {2:P1} discount." This means the date is converted to long form that includes the day of the week, the first number is converted to currency with 2 decimal points, and the second number is converted to percent with 1 decimal point. So the result formattedValue may read something like "On Thursday, May 3, 2018, purchased $107,063.25 of equipment at a 15.9% discount." In this example, the formatted string is then sent to a Salesforce object via the Salesforce: Update Object action.