Text Functions

Functions for formatting text values. These are commonly used in the labeling and popup profiles.

---

Concatenate

Concatenate( values, separator?, format? ) -> Text

Concatenates values together and returns a text value.

Name	Type	Description
values	Text[]	An array of text values to concatenate.
separator	Text	optional Separator to use for concatenation if values parameter is an array. Or text to concatenate, if a single value is provided for the first parameter. If not provided will be empty.
format	Text	optional Formatting text for dates or numbers. This parameter is available in Arcade version 1.3 and later. See the list of possible values below. Value Description 0 Digit # Digit, omitting leading/trailing zeros D Day of the month, not padded (1 - 31). DD Day of the month, padded (01 - 31). DDD Ordinal day of the year (1 - 365). d Day of the week (1 - 7) ddd Abbreviated day of the week (e.g. Mon) dddd Full day of the week (e.g. Monday). M Month number (1 - 12) MM Month number, padded (01 - 12). MMM Abbreviated month name (e.g. Jan). MMMM Full month name (e.g. January) m Minutes, not padded (0 - 59). mm Minutes, padded (00 - 59). Y Full year YY Two-digit year h Civilian hours, not padded (0 - 12) hh Civilian hours, padded (00 - 12) H Military hours, not padded (0 - 24) HH Military hours, padded (00 - 24) s Seconds, not padded (0 - 59) ss Seconds, padded (00 - 59)

Returns: Text

Example

prints 'red/blue/green'

Concatenate(['red', 'blue', 'green'], '/')

---

Find

Find( searchText, text, startpos? ) -> Number

Finds a string of characters within a text value. Wildcards are NOT supported. A returned value of -1 indicates no results were found.

Name	Type	Description
searchText	Text	The character string to search for.
text	Text	The text to search.
startpos	Number	optional The zero-based index of the location in the text to search from.

Returns: Number

Example

prints 6

Find('380', 'Esri, 380 New York Street', 0)

---

Left

Left( value, charCount ) -> Text

Returns the specified number of characters from the beginning of a text value.

Name	Type	Description
value	Text | Array | Number | Boolean	The text from which to get characters.
charCount	Number	The number of characters to get from the beginning of the text.

Returns: Text

Example

prints 'the'

Left('the quick brown fox', 3)

---

Lower

Lower( value ) -> Text

Makes a text value lower case.

Name	Type	Description
value	Text	The text to be made lowercase.

Returns: Text

Example

prints 'hello'

Lower('HELLO')

---

Mid

Mid( value, startpos, charCount ) -> Text

Gets a number of characters from the middle of a text value.

Name	Type	Description
value	Text | Array | Number | Boolean	The text from which to get characters.
startpos	Number	The starting position from which to get the text. 0 is the first position.
charCount	Number	The number of characters to extract.

Returns: Text

Example

prints 'quick'

Mid('the quick brown fox', 4, 5)

---

Proper

Proper( value, applyTo? ) -> Text

Converts a text value to title case. By default, the beginning of every word is capitalized. The option firstword will capitalize only the first word.

Name	Type	Description
value	Text	The text to convert to title case.
applyTo	Text	optional A text value specifying the type of capitalization to be performed. By default every word is capitalized. This parameter accepts one of two values: everyword or firstword.

Returns: Text

Example

prints 'The Quick Brown Fox'

Proper('the quick brown fox', 'everyword')

---

Replace

Replace( value, searchText, replacementText, allOccurrences? ) -> Text

Replaces a string within a text value or an element within an array. Defaults to replacing all occurrences.

Name	Type	Description
value	Text | Array | Number | Boolean	The value in which to make replacements.
searchText	Text	The text to search for.
replacementText	Text	The replacement text.
allOccurrences	Boolean	optional Indicates if all occurrences of the searchText should be replaced in the text. Defaults to true.

Returns: Text

Example

prints 'the quick red fox'

Replace('the quick brown fox', 'brown', 'red')

---

Right

Right( value, charCount ) -> Text

Returns the specified number of characters from the end of a text value.

Name	Type	Description
value	Text | Array | Number | Boolean	The text from which to get characters.
charCount	Number	The number of characters to get from the end of the text value.

Returns: Text

Example

prints 'fox'

Right('the quick brown fox', 3)

---

Split

Split( value, separator, limit?, removeEmpty? ) -> Text[]

Splits a text value into an array.

Name	Type	Description
value	Text	The text value to be split.
separator	Text	The separator used to split the text.
limit	Number	optional An integer that specifies the number of splits. The default is -1, which indicates an unlimited number of splits.
removeEmpty	Boolean	optional Indicates whether to remove empty values. By default this is false.

Returns: Text[]

Example

returns '[red,green]'

Split('red,green,blue,orange', ',', 2)

Splits the paragraph at each space an unlimited number of times. Returns an array of the words in the paragraph.

Split(paragraph, ' ', -1, true)

---

Trim

Trim( value ) -> Text

Removes spaces from the beginning or end of an input text value.

Name	Type	Description
value	Text	The text to be trimmed.

Returns: Text

Example

prints 'hello world'

Trim('   hello world')

---

Upper

Upper( value ) -> Text

Makes text upper case.

Name	Type	Description
value	Text	The text value to be made uppercase.

Returns: Text

Example

prints 'HELLO'

Upper('Hello')

---

UrlEncode

UrlEncode( url ) -> Text

Since version 1.7

Encodes a URL by replacing each instance of certain characters by one, two, three, or four escape sequences representing the UTF-8 encoding of the character.

Name	Type	Description
url	Text | Dictionary	The URL to be encoded.

Returns: Text

Example

Encodes the URL provided

var urlsource ='arcgis-survey123://?';
var params = {
  itemID:'36ff9e8c13e042a58cfce4ad87f55d19',
  center: '43.567,-117.380'
};
return urlsource  + UrlEncode(params);
//arcgis-survey123://?center=43.567%2C-117.380&itemID=36ff9e8c13e042a58cfce4ad87f55d19

---