Skip to content

Add CAST to DECIMAL with parameters to OQL docs #9986

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Aug 27, 2025
Merged

Add CAST to DECIMAL with parameters to OQL docs #9986

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
bd8feb4
Add CAST to DECIMAL with parameters to OQL docs
dahfjkg Aug 15, 2025
e581364
Proofread
MarkvanMents Aug 26, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 31 additions & 4 deletions content/en/docs/refguide/modeling/domain-model/oql/oql-expression-syntax.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -725,9 +725,9 @@ The table below describes which `CAST` conversions are supported:

| From \ To | BOOLEAN | DATETIME | DECIMAL | INTEGER | LONG | STRING (unlimited) | STRING (limited) |
|------| :------: | :------: | :------: | :------: | :------: | :------: | :------: |
| BOOLEAN | ✔ | ✘ | ✘ | ✘ | ✘ | ✔* | ✔*¹ |
| DATETIME | ✘ | ✔ | ✘ | ✘ | ✘ | ✔* | ✔*² |
| DECIMAL | ✘ | ✘ | ✔* | ✔* | ✔* | ✔* | ✔*² |
| BOOLEAN | ✔ | ✘ | ✘ | ✘ | ✘ | ✔*³ | ✔*¹ ³ |
| DATETIME | ✘ | ✔ | ✘ | ✘ | ✘ | ✔*³ | ✔*² ³ |
| DECIMAL⁴ | ✘ | ✘ | ✔* | ✔* | ✔* | ✔* | ✔*² |
| INTEGER | ✘ | ✘ | ✔ | ✔ | ✔ | ✔ | ✔ |
| LONG | ✘ | ✘ | ✔ | ✔ | ✔ | ✔ | ✔ |
| STRING | ✘ | ✘ | ✔ | ✔ | ✔ | ✔ | ✔ |
Expand All @@ -736,7 +736,19 @@ The table below describes which `CAST` conversions are supported:

²The conversion of DATETIME and DECIMAL to STRING (limited) is supported only if the value fully fits into the string length. The conversion can fail if the resulting string length is less than 20.

Converting `DATETIME` or `BOOLEAN` to `STRING` returns different format per database.
³Converting `DATETIME` or `BOOLEAN` to `STRING` returns different format per database.

⁴See [`DECIMAL` precision](#dec-prec), below, for further information.

##### `DECIMAL` precision{#dec-prec}

`DECIMAL` data type can have precision and scale as parameters. This will have the following impact on the way data is converted:

* `DECIMAL(<precision>, <scale>)` – when both parameters are specified, those values are used as precision and scale of the resulting data type
* `DECIMAL(<precision>)` – when only precision is specified, scale is set to 0. The resulting data type in that case is `DECIMAL(<precision>, 0)`
* `DECIMAL` – when no parameters are specified, default values are used. Precision is set to 28, and scale is set to 8: `DECIMAL(28, 8)`

If the original value has more digits in the fractional part than required scale, the fractional part is rounded to the required scale. In that case, rounding is done according to the database configuration.

#### Examples

Expand All @@ -758,6 +770,21 @@ SELECT (Number : 2) as Normal, (Cast(Number AS DECIMAL) : 2) as Casted FROM Sale
| 1 | 1.0 |
| 1 | 1.5 |

In the case of conversion to `DECIMAL`, scale and precision can be specified

```sql
SELECT
CAST('123.0987654321' AS DECIMAL) AS default_decimal,
CAST('123.0987654321' AS DECIMAL(20)) AS decimal_precision,
CAST('123.0987654321' AS DECIMAL(20, 6)) AS decimal_precision_scale
FROM Sales.Order
LIMIT 1
```

| default_decimal | decimal_precision | decimal_precision_scale |
|------:|-------:|-------:|
| 123.09876543 | 123 | 123.098765 |

### COALESCE {#coalesce-expression}

Returns the value of the first `expression` that is not NULL. Can be used with columns.
Expand Down