Page History

Versions Compared

Old Version 2

changes.mady.by.user Christian Czaia

Saved on May 20, 2020

compared with

New Version Current

changes.mady.by.user Iheb Kharab

Saved on Jan 06, 2022

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

Image AddedNumber 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

Page properties

hidden	true

Status

Tech review

Status

title	todo

Style guide

Status

title	todo

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<Short, generic description of the parser function(s) (if multiple parameters are available)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 separatorDetailed description of the parser function.

Code Block

language	bash
title	Syntax
linenumbers	true

function toString(firstParameternumberList, secondParameterdecimalPlaces, thirdParameterseparator) #Output: NumberText

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

timeInValue(%{issue.summary}, ^% ~~ "ERROR" OR ^% ~~ "WARNING") / {HOUR}

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

Image AddedText 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

timeInValuecomponentscount(toStringList(^%, "," > 1 / {HOUR} number of hours the field components of the current issue contained more than one selected component.

This example uses the functions:

count()

xxxx

Parser expression

Description

Code Block

language	bash
linenumbers	true

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

This example returns the text:

"Hello, , world, !"This example returns the number of hours the field summary of the current issue contained any of the words "ERROR" or "WARNING", ignoring the case.

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:

Info

UI Expand

title	Additional information

Parameters used in this function

firstParameter

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

string

Parameter Input (data type) Description

textList

number

The input has to be a valid timestamp...

secondParameter

Status

title

subtle	true

text list

Any given text list.

separator

Parameter description. Read more about Working with lists

thirdParameter

Status

subtle	true
title	text

Parameter descriptionAny separator character.

UI Expand

title	Output

The This function returns a

Status


subtle	true
title	textnumber

Image AddedIssue list

UI Text Box

size	medium
type	tip		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

Image AddedUse 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	toString()
Map
Notes

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

If there is more to say, say it or link to related functions...

Are you looking for a more detailed representation? You might want to have a look at the function formatDuration()...

Content

Space Tools

Versions Compared

Old Version 2

New Version Current

Key

Image AddedNumber list

Image AddedText list

Image AddedIssue list

Image AddedUse cases and examples