Status
Tech review

Style guide



Short description

Converts numbers and lists to plain text.

Output




This is one of the most commonly used functions in JWT.

Whenever any type of list is returned by a field code or parser function (e.g. subtasks()) and you are using the Advanced text parsing mode, the toString() function converts the output to a readable format.

This is especially helpful if you want to Test your expression.


This function converts the decimal representation of a number (or timestamp) to plain text. 


 toString(number) #Output: Text



Parser expressionDescription


toString(3.141592)


This example returns the following text:

"3.141592"



Parameters used in this function

ParameterInput (data type)Description
number

Any given number or numerical field code.



This function returns a




Variant where you can additionally define the number of decimal places.


 toString(number, decimalPlaces) #Output: Text



Parser expressionDescription


toString(3.141592, 2)


This example returns the following text:

"3.14"



Parameters used in this function

ParameterInput (data type)Description
number

Any given number.
decimalPlaces

Any natural number.



This function returns a



Number list

This function converts any number list to plain text.

A comma-separated text with the decimal representation of each numeric value will be returned.


 toString(numberList) #Output: Text



Parser expressionDescription


toString([1, 2, 3, 4.0])


This example returns the following text: "1, 2, 3, 4"



Parameters used in this function

ParameterInput (data type)Description
numberList

Any given number list.



This function returns a




Variant where you can additionally define the number of decimal places.


 toString(numberList, decimalPlaces) #Output: Text



Parser expressionDescription


toString([1.123, 2.452, 3.64612], 2)


This example returns the following text:

"1.12, 2.45, 3.65"



Parameters used in this function

ParameterInput (data type)Description
numberList

Any given number list.
decimalPlaces

Any given number.



This function returns a




Variant where you can additionally define a specific separator.


 toString(numberList, decimalPlaces, separator) #Output: Text



Parser expressionDescription


toString([1.123, 2.452, 3.64612], 2, " : ")


This example returns the following text:

"1.12 : 2.45 : 3.65"



Parameters used in this function

ParameterInput (data type)Description
numberList

Any given number list.
decimalPlaces

Any natural number.
separator

Any separator character.



This function returns a



Text list

This function converts any text list to plain text.

A comma-separated text with each value will be returned.


 toString(textList) #Output: Text



Parser expressionDescription


toString(["Hello", " ", "world", "!"])


This example returns the following text:

"Hello, , world, !"


toString(fieldValue(%{issue.reporter}, subtasks()))


This example returns the user names of all sub-task reporters, e.g.:

"b.smith, a.grant"

To achieve this the following functions are used:



Parameters used in this function

ParameterInput (data type)Description
textList

Any given text list.



This function returns a




Variant where you can additionally define a specific separator.


toString(textList, separator) #Output: Text



Parser expressionDescription


toString(["blue", "red", "green"], "; ")


This example returns the following text:

"blue; red; green"



Parameters used in this function

ParameterInput (data type)Description
textList

Any given text list.
separator

Any separator character.



This function returns a



Issue list

Converts an issue list to a comma-separated text containing issue keys.


toString(issueList) #Output: Text



Parser expressionDescription


toString(subtasks())


This example might return:

 "CRM-5, CRM-6 "

To achieve this the following functions are used:



Parameters used in this function

ParameterInput (data type)Description
issueList

Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).



This function returns a




Variant where you can additionally define a specific separator.


toString(issueList, separator) #Output: Text



Parser expressionDescription


 toString(subtasks(), " " )


This example might return: 

"CRM-5 CRM-6 CRM-7"


 toString(subtasks(), ";" )


This example might return: 

"CRM-5;CRM-6;CRM-7"



Parameters used in this function

ParameterInput (data type)Description
issueList

Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).
separator

Any separator character.



This function returns a