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

> Reference material for the TO_OCT function

# TO_OCT

Converts a value (`<expression>`) of type `INTEGER` or `BIGINT` to its equivalent octal representation.

## Syntax

```sql theme={"theme":{"light":"css-variables","dark":"css-variables"}}
TO_OCT(<expression>)
```

## Parameters

| Parameter      | Description                                                                      | Supported input types |
| :------------- | :------------------------------------------------------------------------------- | :-------------------- |
| `<expression>` | A value expression evaluating to `INTEGER` or `BIGINT` that should be converted. | `INTEGER`, `BIGINT`   |

## Return Type

`TEXT`

* Returns `NULL` if input is `NULL`

## Remarks

The function returns the octal representation of the input number as a text string.
Negative numbers are displayed as the octal representation of their binary two's complement form.
Leading zeros are omitted, but the output is at least one digit long.

## Example

The following examples convert integer values to their octal representations:

<div className="query-window">
  ```
  SELECT TO_OCT(42) as result
  ```

  | result <span>text</span> |
  | :----------------------- |
  | 52                       |

  <p><span>Rows: 1</span><span>Execution time: 5.01ms</span></p>
</div>

<div className="query-window">
  ```
  SELECT TO_OCT(-1) as result
  ```

  | result <span>text</span> |
  | :----------------------- |
  | 37777777777              |

  <p><span>Rows: 1</span><span>Execution time: 5.19ms</span></p>
</div>

<div className="query-window">
  ```
  SELECT TO_OCT(0) as result
  ```

  | result <span>text</span> |
  | :----------------------- |
  | 0                        |

  <p><span>Rows: 1</span><span>Execution time: 5.25ms</span></p>
</div>

<div className="query-window">
  ```
  SELECT TO_OCT(NULL) as result
  ```

  | result <span>text null</span> |
  | :---------------------------- |
  | NULL                          |

  <p><span>Rows: 1</span><span>Execution time: 5.37ms</span></p>
</div>