Skip to main content
Version: 8.1


This function is used by Ignition's Expression language.


This expression returns a formatted string using the specified format string and arguments. Mainly, this expression is used for building dynamic string objects.

Refer to Data Type Formatting Reference for formatting elements.


stringFormat(format, [args, ...])

  • Parameters

    • String format - A string that contains formatting elements in it (%s, %d, %i).

    • String args - The arguments to use in the format. Must match the number of formatting elements in the string. [optional]

  • Results

    • String - The new formatted string.


Code Snippet
stringFormat("The boolean value is: %b", null) //Returns The boolean value is: False.
Code Snippet
stringFormat("Hello %s", "world") //returns "Hello world"
Code Snippet
stringFormat("%s, %s, %s", 1, 2, 3) //returns "1, 2, 3"
Code Snippet
stringFormat("%d, %d, %d", 4, 5, 6) //returns "4, 5, 6"
Code Snippet
stringFormat("Today is: %tA", now()) //Returns Today is: Tuesday.
Code Snippet
stringFormat("The current month is: %tB", now()) //Returns The current month is: June.