Page History

Versions Compared

Key

This line was added.
This line was removed.
Formatting was changed.

UI Text Box

size	medium
type	info

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

UI Text Box

type	tip

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.

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(number) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

toString(3.141592)

This example returns the text:

"3.141592"

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

number

Status


subtle	true
title	number

Any given number or numerical field code.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

UI Text Box

size	medium
type	info

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

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(number, decimalPlaces) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

toString(3.141592, 2)

This example returns the text:

"3.14"

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

number

Status


subtle	true
title	number

Any given number.

decimalPlaces

Status


subtle	true
title	number

Any positive number.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

Number list

UI Text Box

size	medium
type	info

This function converts any number list into plain text.

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

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(numberList) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

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

This example returns the text:

"1, 2, 3, 4"

UI Expand

title	Additional information

Parameters used in this function

Parameter

Input (data type)

Description

numberList

Status


subtle	true
title	number list

Any given number list.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

UI Text Box

size	medium
type	info

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

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(numberList, decimalPlaces) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

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

This example returns the text:

"1.12, 2.45, 3.65"

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

numberList

Status


subtle	true
title	number list

Any given number list.

decimalPlaces

Status


subtle	true
title	number

Any positive number.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

UI Text Box

size	medium
type	info

Variant where you can additionally define a specific separator.

Code Block

language	bash
title	Syntax
linenumbers	true

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

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

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

This example returns the text:

"1.12 : 2.45 : 3.65"

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

numberList

Status


subtle	true
title	number list

Any given number list.

decimalPlaces

Status


subtle	true
title	number

Any positive number.

separator

Status

subtle	true
title	text

Any separator character.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

Text list

UI Text Box

size	medium
type	info

This function converts any text list into plain text.

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

Code Block

language	bash
title	Syntax
linenumbers	true

 toString(textList) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

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

This example returns the text:

"Hello, , world, !"

Code Block

language	bash
linenumbers	true

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:

UI Expand

title	Additional information

Parameters used in this function

Parameter

Input (data type)

Description

textList

Status


subtle	true
title	text list

Any given text list.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

UI Text Box

size	medium
type	info

Variant where you can additionally define a specific separator.

Code Block

language	bash
title	Syntax
linenumbers	true

toString(textList, separator) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

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

This example returns the text:

"blue; red; green"

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

textList

Status


subtle	true
title	text list

Any given text list.

separator

Status

subtle	true
title	text

Any separator character.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

Issue list

UI Text Box

size	medium
type	info

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

Code Block

language	bash
title	Syntax
linenumbers	true

toString(issueList) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

toString(subtasks())

This example might return:

"CRM-5, CRM-6 "

To achieve this the following functions are used:

subtasks()

UI Expand

title	Additional information

Parameters used in this function

Parameter

Input (data type)

Description

issueList

Status


subtle	true
title	issue list

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

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

UI Text Box

size	medium
type	info

Variant where you can additionally define a specific separator.

Code Block

language	bash
title	Syntax
linenumbers	true

toString(issueList, separator) #Output: Text

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

 toString(subtasks(), " ")

This example might return:

"CRM-5 CRM-6 CRM-7"

Code Block

language	bash
linenumbers	true

 toString(subtasks(), ";")

This example might return:

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

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

issueList

Status


subtle	true
title	issue list

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

separator

Status


subtle	true
title	text

Any separator character.

UI Expand

title	Output

This function returns a

Status


subtle	true
title	text

Use cases and examples

Page properties report

firstcolumn	Use case
headings	JWT feature, Workflow function, Field type, Automated action, Parser functions
cql	label = "parser_func_tostring" and space = currentSpace()

Page properties

hidden	true
id	1

Parser function cloud

Map

Notes

Workaround

Code Block

language	bash

%{union(linkedIssues("is blocked by", linkedIssues("is blocked by")), linkedIssues("is blocked by"))}

Using our General parser we can access the current issue's linked issues and theirs linked issues.

Page properties

hidden	true

Status

Tech review

Status

colour	Green
title	done

Style guide

Status

colour	Green
title	done

Status

title	todo

Status

colour	Yellow
title	Ready for review

Status

colour	Green
title	done

Status

colour	Red
title	flagged

Page properties

hidden	true

Short description

Converts numbers and lists into plain text.

Output

Status


subtle	true
title	text

Available since

Label

Status


colour	Red
title	staff pick

Content

Space Tools

Versions Compared

Old Version 21

New Version 22

Key

Number list

Text list

Issue list

Use cases and examples

Workaround