> ## Documentation Index
> Fetch the complete documentation index at: https://docs.respell.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Converters Reference

<Warning>We're reworking our converters; some of these may be out of date!</Warning>

Below is a reference for the converters available for each variable type. If you want a new converter, please reach out to us at [hello@respell.ai](mailto:hello@respell.ai) or on our Slack community!

## Text

| Converter | Target Type | Description | Example |
| --------- | ----------- | ----------- | ------- |
| -         | -           | -           | -       |

## Email

| Converter | Target Type | Description                        | Example                                                                                     |
| --------- | ----------- | ---------------------------------- | ------------------------------------------------------------------------------------------- |
| Text      | Text        | Converts the email to a text type. | [hello@respell.ai](mailto:hello@respell.ai) → ”[hello@respell.ai](mailto:hello@respell.ai)” |

## Phone Number

| Converter | Target Type | Description                               | Example                       |
| --------- | ----------- | ----------------------------------------- | ----------------------------- |
| Text      | Text        | Converts the phone number to a text type. | 123-456-7890 → ”123-456-7890” |

## URL

| Converter | Target Type | Description                      | Example                                                                                |
| --------- | ----------- | -------------------------------- | -------------------------------------------------------------------------------------- |
| Text      | Text        | Converts the URL to a text type. | [https://respell.ai](https://respell.ai) → ”[https://respell.ai”](https://respell.ai”) |

## Integer

| Converter           | Target Type | Description                                                                      | Example                |
| ------------------- | ----------- | -------------------------------------------------------------------------------- | ---------------------- |
| Absolute Value      | Integer     | Takes the absolute value of the provided integer.                                | 4 → 4<br />-5 → 5      |
| Reverse Sign        | Integer     | Reverses the sign of the provided integer.                                       | 4 → -4<br />-5 → 5     |
| Absolute Value Text | Text        | Takes the absolute value of the provided integer and converts it to a text type. | 4 → “4”<br />-5 → “5”  |
| Reverse Sign Text   | Text        | Reverses the sign of the provided integer and converts it to a text type.        | 4 → “-4”<br />-5 → “5” |
| Text                | Text        | Converts the integer to a text type.                                             | 4 → “4”<br />-5 → “-5” |

## Decimal

| Converter           | Target Type | Description                                                                      | Example                                                                    |
| ------------------- | ----------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| Absolute Value      | Decimal     | Takes the absolute value of the provided decimal.                                | 4 → 4<br />-5 → 5                                                          |
| Reverse Sign        | Decimal     | Reverses the sign of the provided decimal.                                       | 4 → -4<br />-5 → 5                                                         |
| Round               | Decimal     | Rounds the decimal to the nearest integer.                                       | 3.14 → 3<br />3.88 → 4<br />-3.14 → -3<br />-3.88 → -4                     |
| Ceiling             | Decimal     | Rounds the decimal to the next highest integer.                                  | 3.14 → 4<br />3.88 → 4<br />-3.14 → -3<br />-3.88 → -3                     |
| Floor               | Decimal     | Rounds the decimal to the next lowest integer.                                   | 3.14 → 3<br />3.88 → 3<br />-3.14 → -4<br />-3.88 → -4                     |
| Absolute Value Text | Text        | Takes the absolute value of the provided decimal and converts it to a text type. | 4 → ”4”<br />-5 → ”5”                                                      |
| Reverse Sign Text   | Text        | Reverses the sign of the provided decimal and converts it to a text type.        | 4 → ”-4”<br />-5 → ”5”                                                     |
| Round Text          | Text        | Rounds the decimal to the nearest integer and converts it to a text type.        | 3.14 → ”3”<br />3.88 → ”4”<br />-3.14 → ”-3”<br />-3.88 → ”-4”             |
| Ceiling Text        | Text        | Rounds the decimal to the next highest integer and converts it to a text type.   | 3.14 → ”4”<br />3.88 → ”4”<br />-3.14 → ”-3”<br />-3.88 → ”-3”             |
| Floor Text          | Text        | Rounds the decimal to the next lowest integer and converts it to a text type.    | 3.14 → ”3”<br />3.88 → ”3”<br />-3.14 → ”-4”<br />-3.88 → ”-4”             |
| Text                | Text        | Converts the decimal to a text type.                                             | 3.14 → “3.14”<br />3.88 → ”3.88”<br />-3.14 → ”-3.14”<br />-3.88 → ”-3.88” |

## Boolean

| Converter     | Target Type | Description                                                               | Example                            |
| ------------- | ----------- | ------------------------------------------------------------------------- | ---------------------------------- |
| Opposite      | Boolean     | Changes the boolean to the opposite value.                                | true → false<br />false → true     |
| Opposite Text | Text        | Changes the boolean to the opposite value and converts it to a text type. | true → “false”<br />false → “true” |
| Text          | Text        | Converts the boolean to a text type.                                      | true → “true”<br />false → “false” |

## Datetime

| Converter | Target Type | Description                                       | Example                                       |
| --------- | ----------- | ------------------------------------------------- | --------------------------------------------- |
| ISO Text  | Text        | Converts the datetime to an ISO format text type. | 12/28/2024 12:01 → ”2024-28-12T12:01:00.000Z” |
| Text      | Text        | Converts the datetime to a text type.             | 12/28/2024 12:01 → ”12/28/2024 12:01”         |

## Date

| Converter | Target Type | Description                                   | Example                                 |
| --------- | ----------- | --------------------------------------------- | --------------------------------------- |
| ISO Text  | Text        | Converts the date to an ISO format text type. | 12/28/2024 → ”2024-28-12T00:00:00.000Z” |
| Text      | Text        | Converts the date to a text type.             | 12/28/2024 → "12/28/2024”               |

## Time

| Converter | Target Type | Description                                   | Example                 |
| --------- | ----------- | --------------------------------------------- | ----------------------- |
| ISO Text  | Text        | Converts the time to an ISO format text type. | 12:01 → ”12:01:00.000Z” |
| Text      | Text        | Converts the time to a text type.             | 12:01 → ”12:01”         |

## Object

| Converter | Target Type | Description                                                                      | Example                                                                                                         |
| --------- | ----------- | -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| JSON      | Text        | Converts the object to a text type in stringified, 2-space indented JSON format. | \{<br />  “a”: 12345,<br />  “b”: “text”,<br />}<br />→<br />”\{<br />  “a”: 12345,<br />  “b”: “text”,<br />}” |
| Text      | Text        | Converts the object to a text type in YAML format.                               | \{<br />“a”: 12345,<br />“b”: “text”,<br />}<br />→<br />"a: 12345<br />b: text"                                |

## Code

| Converter | Target Type | Description                       | Example                                                                                                                             |
| --------- | ----------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Text      | Text        | Converts the code to a text type. | if (running) \{<br />  console.log(”hello world”);<br />};<br />→<br />”if (running) \{<br />  console.log(”hello world”);<br />};” |

<Warning>The converters below are under construction. Please check back later.</Warning>

## Document

| Converter | Target Type | Description                       | Example         |
| --------- | ----------- | --------------------------------- | --------------- |
| Text      | Text        | Converts the time to a text type. | 12:01 → ”12:01” |

## Spreadsheet

| Converter | Target Type | Description                       | Example         |
| --------- | ----------- | --------------------------------- | --------------- |
| Text      | Text        | Converts the time to a text type. | 12:01 → ”12:01” |

## Audio

| Converter | Target Type | Description                       | Example         |
| --------- | ----------- | --------------------------------- | --------------- |
| Text      | Text        | Converts the time to a text type. | 12:01 → ”12:01” |

## Image

| Converter | Target Type | Description                       | Example         |
| --------- | ----------- | --------------------------------- | --------------- |
| Text      | Text        | Converts the time to a text type. | 12:01 → ”12:01” |

## Video

| Converter | Target Type | Description                       | Example         |
| --------- | ----------- | --------------------------------- | --------------- |
| Text      | Text        | Converts the time to a text type. | 12:01 → ”12:01” |
