Description
The tools object provides a collection of general purpose tools that can be useful during app development and testing.
Properties
Below is a list of properties supported by this object.
| Name | Description | Desktop | Web | Avatars |
|---|---|---|---|---|
| now | Returns the current date and time in local (host device) format | Yes | Yes | Yes |
| nowUtc | Returns the current date and time in UTC format | Yes | Yes | Yes |
| date | Returns the current date in local (host device) format | Yes | Yes | Yes |
| dateUtc | Returns the current date in UTC format | Yes | Yes | Yes |
| dateText | Returns the current date in Text-based, MM/dd/yyyy format | Yes | Yes | Yes |
| time | Returns the current time in local (host device) format | Yes | Yes | Yes |
| timeUtc | Returns the current time in UTC format | Yes | Yes | Yes |
| time12Text | Returns the current time in Text-based, 12-hour format | Yes | Yes | Yes |
| time24Text | Returns the current time in Text-based, 24-hour format | Yes | Yes | Yes |
Functions
Below is a list of functions supported by this object.
| Name | Description | Desktop | Web | Avatars |
|---|---|---|---|---|
| addYears | Adds or subtracts a specified # of years from the current date | Yes | Yes | Yes |
| addMonths | Adds or subtracts a specified # of months from the current date | Yes | Yes | Yes |
| addDays | Adds or subtracts a specified # of days from the current date | Yes | Yes | Yes |
| addHours | Adds or subtracts a specified # of hours from the current time | Yes | Yes | Yes |
| addMinutes | Adds or subtracts a specified # of minutes from the current time | Yes | Yes | Yes |
| addSeconds | Adds or subtracts a specified # of seconds from the current time | Yes | Yes | Yes |
| addMilliseconds | Adds or subtracts a specified # of milliseconds from the current time | Yes | Yes | Yes |
| findByRange | Finds an item in an array whose range includes a specified value | Yes | Yes | Yes |
| findByScale | Finds an item in an array whose value is closest to a specified value without going over | Yes | Yes | Yes |
| flatten | Returns a string of all items in the passed array, separated by the specified separator | Yes | Yes | Yes |
| format | Applies a text formatting expression to an object | Yes | Yes | Yes |
| minMax | Restricts a specified numeric value to a specified numeric range | Yes | Yes | Yes |
| newId | Creates and returns a new globally unique identifier (GUID) | Yes | Yes | Yes |
| series | Converts an array of JSON objects into a new array of JSON objects that represents a data series | Yes | Yes | Yes |
| xmlFind | Returns a value at the specified XML element location | Yes | Yes | Yes |
| xmlFindArray | Returns an array of child values at the specified parent XML element location | Yes | Yes | Yes |
Remarks
None.