# subtract — DuckDB 2.0.0

No description supplied by the engine.

- Reference: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/
- JSON: /products/haybarn/functions/api/v1/duckdb-2.0.0/functions/subtract.json
- Snapshot ID: duckdb-2.0.0
- Engine: duckdb v2.0.0
- Source ID: d54cbbe3df
- Binary SHA-256: 4d5d001f4b0a16c16f1bc83338153a70bec7e58f0cae0eec4b44b9b9afa0bef0
- Captured: 2026-11-06T18:35:28.343Z
- Source: https://github.com/duckdb/duckdb/releases/tag/v2.0.0
- Loaded extensions: autocomplete, core_functions, icu, json, parquet, shell
- Alias of: -

## Interpretation

- Choose a snapshot matching the target engine and build. The default is captured from the published Haybarn WASM package used by the browser playground. Historical native snapshots are also available.
- Availability is an observation in the recorded build and extension profile, not a guarantee of support in every installation or in WASM.
- Types and descriptions are declarations from duckdb_functions(). Binding can specialize result types. Null means not supplied by the catalog; do not invent defaults, optionality, argument mode, or table output columns.
- Raw parameter arrays preserve catalog order for scalar/aggregate/macro functions. Raw table arguments are alphabetical. Use callingConvention for engine-confirmed positional order and named arguments; null modes are unrecorded. Named does not mean optional. Macro defaults and special named variadic behavior are not supplied by duckdb_functions().
- Catalog examples are source material and may require data or extensions. runnableExamples contains separately verified SQL for the pinned WASM package; sample-data adaptations and guide examples are labeled separately.
- Guide annotations and recipes are separate editorial content. The browser runner always uses Haybarn WASM 2.0.0-rc12, independently of the documentation snapshot.
- All URLs beginning with / are relative to the origin hosting this document. Exports require no JavaScript, cookies, API key, or browser engine.

## Overloads

### overload-6c8d535e9063c824

Kind: scalar. Parameter order: catalog-order.

```text
subtract(x: BIGINT) → BIGINT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-6c8d535e9063c824

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| x | BIGINT | not recorded |

Declared return type: BIGINT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-28bd6acc0b3c5151

Kind: scalar. Parameter order: catalog-order.

```text
subtract(x: BIGNUM) → BIGNUM
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-28bd6acc0b3c5151

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| x | BIGNUM | not recorded |

Declared return type: BIGNUM. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-98ccb13242e57726

Kind: scalar. Parameter order: catalog-order.

```text
subtract(x: DECIMAL) → DECIMAL
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-98ccb13242e57726

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| x | DECIMAL | not recorded |

Declared return type: DECIMAL. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-70d32664d6cf3e7c

Kind: scalar. Parameter order: catalog-order.

```text
subtract(x: DOUBLE) → DOUBLE
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-70d32664d6cf3e7c

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| x | DOUBLE | not recorded |

Declared return type: DOUBLE. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-c5940d86e5d292c5

Kind: scalar. Parameter order: catalog-order.

```text
subtract(x: FLOAT) → FLOAT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-c5940d86e5d292c5

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| x | FLOAT | not recorded |

Declared return type: FLOAT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-61e1c926c79b0cee

Kind: scalar. Parameter order: catalog-order.

```text
subtract(x: HUGEINT) → HUGEINT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-61e1c926c79b0cee

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| x | HUGEINT | not recorded |

Declared return type: HUGEINT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-9eeb8cd2ff1ec666

Kind: scalar. Parameter order: catalog-order.

```text
subtract(x: INTEGER) → INTEGER
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-9eeb8cd2ff1ec666

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| x | INTEGER | not recorded |

Declared return type: INTEGER. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-9fc14bcdd54de671

Kind: scalar. Parameter order: catalog-order.

```text
subtract(x: INTERVAL) → INTERVAL
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-9fc14bcdd54de671

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| x | INTERVAL | not recorded |

Declared return type: INTERVAL. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-bd9fda60dc5662a1

Kind: scalar. Parameter order: catalog-order.

```text
subtract(x: SMALLINT) → SMALLINT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-bd9fda60dc5662a1

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| x | SMALLINT | not recorded |

Declared return type: SMALLINT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-e128083afe3d1899

Kind: scalar. Parameter order: catalog-order.

```text
subtract(x: TINYINT) → TINYINT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-e128083afe3d1899

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| x | TINYINT | not recorded |

Declared return type: TINYINT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-9688c5f3c4a79578

Kind: scalar. Parameter order: catalog-order.

```text
subtract(x: UBIGINT) → UBIGINT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-9688c5f3c4a79578

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| x | UBIGINT | not recorded |

Declared return type: UBIGINT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-ea0ca2a29162f728

Kind: scalar. Parameter order: catalog-order.

```text
subtract(x: UHUGEINT) → UHUGEINT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-ea0ca2a29162f728

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| x | UHUGEINT | not recorded |

Declared return type: UHUGEINT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-d086fc5a9b313cc1

Kind: scalar. Parameter order: catalog-order.

```text
subtract(x: UINTEGER) → UINTEGER
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-d086fc5a9b313cc1

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| x | UINTEGER | not recorded |

Declared return type: UINTEGER. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-b8f665eb201fe4dd

Kind: scalar. Parameter order: catalog-order.

```text
subtract(x: USMALLINT) → USMALLINT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-b8f665eb201fe4dd

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| x | USMALLINT | not recorded |

Declared return type: USMALLINT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-41f3d8b2e26b7650

Kind: scalar. Parameter order: catalog-order.

```text
subtract(x: UTINYINT) → UTINYINT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-41f3d8b2e26b7650

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| x | UTINYINT | not recorded |

Declared return type: UTINYINT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-e7f9cc14633feb25

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: BIGINT, right: BIGINT) → BIGINT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-e7f9cc14633feb25

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | BIGINT | not recorded |
| right | BIGINT | not recorded |

Declared return type: BIGINT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-cf725398206a35b5

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: BIGNUM, right: BIGNUM) → BIGNUM
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-cf725398206a35b5

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | BIGNUM | not recorded |
| right | BIGNUM | not recorded |

Declared return type: BIGNUM. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-20c41bbbcbc3d5a8

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: DATE, right: DATE) → BIGINT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-20c41bbbcbc3d5a8

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | DATE | not recorded |
| right | DATE | not recorded |

Declared return type: BIGINT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-1b5a8feb10601523

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: DATE, right: INTEGER) → DATE
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-1b5a8feb10601523

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | DATE | not recorded |
| right | INTEGER | not recorded |

Declared return type: DATE. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-3a594c6f74f2e65f

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: DATE, right: INTERVAL) → TIMESTAMP
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-3a594c6f74f2e65f

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | DATE | not recorded |
| right | INTERVAL | not recorded |

Declared return type: TIMESTAMP. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-d4902161ad1fc398

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: DECIMAL, right: DECIMAL) → DECIMAL
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-d4902161ad1fc398

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | DECIMAL | not recorded |
| right | DECIMAL | not recorded |

Declared return type: DECIMAL. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-901ae3272c23e1c7

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: DOUBLE, right: DOUBLE) → DOUBLE
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-901ae3272c23e1c7

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | DOUBLE | not recorded |
| right | DOUBLE | not recorded |

Declared return type: DOUBLE. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-3481a39e6bc71016

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: FLOAT, right: FLOAT) → FLOAT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-3481a39e6bc71016

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | FLOAT | not recorded |
| right | FLOAT | not recorded |

Declared return type: FLOAT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-8adbe48eaae44522

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: HUGEINT, right: HUGEINT) → HUGEINT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-8adbe48eaae44522

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | HUGEINT | not recorded |
| right | HUGEINT | not recorded |

Declared return type: HUGEINT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-17e54e90a9de6dbc

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: INTEGER, right: INTEGER) → INTEGER
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-17e54e90a9de6dbc

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | INTEGER | not recorded |
| right | INTEGER | not recorded |

Declared return type: INTEGER. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-c35dc1406b161dbc

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: INTERVAL, right: INTERVAL) → INTERVAL
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-c35dc1406b161dbc

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | INTERVAL | not recorded |
| right | INTERVAL | not recorded |

Declared return type: INTERVAL. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-2080c9584fb0567f

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: SMALLINT, right: SMALLINT) → SMALLINT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-2080c9584fb0567f

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | SMALLINT | not recorded |
| right | SMALLINT | not recorded |

Declared return type: SMALLINT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-903d17faedf47e1d

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: TIME WITH TIME ZONE, right: INTERVAL) → TIME WITH TIME ZONE
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-903d17faedf47e1d

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | TIME WITH TIME ZONE | not recorded |
| right | INTERVAL | not recorded |

Declared return type: TIME WITH TIME ZONE. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-0583a77c1d4d6322

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: TIME, right: INTERVAL) → TIME
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-0583a77c1d4d6322

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | TIME | not recorded |
| right | INTERVAL | not recorded |

Declared return type: TIME. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-eda09c754c7ef212

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: TIMESTAMP, right: INTERVAL) → TIMESTAMP
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-eda09c754c7ef212

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | TIMESTAMP | not recorded |
| right | INTERVAL | not recorded |

Declared return type: TIMESTAMP. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-e23e40e396945db2

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: TIMESTAMP, right: TIMESTAMP) → INTERVAL
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-e23e40e396945db2

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | TIMESTAMP | not recorded |
| right | TIMESTAMP | not recorded |

Declared return type: INTERVAL. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-fb26306c7ae1b859

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: TINYINT, right: TINYINT) → TINYINT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-fb26306c7ae1b859

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | TINYINT | not recorded |
| right | TINYINT | not recorded |

Declared return type: TINYINT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-60a3297ce68e9b09

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: UBIGINT, right: UBIGINT) → UBIGINT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-60a3297ce68e9b09

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | UBIGINT | not recorded |
| right | UBIGINT | not recorded |

Declared return type: UBIGINT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-e7c624e0219c5697

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: UHUGEINT, right: UHUGEINT) → UHUGEINT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-e7c624e0219c5697

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | UHUGEINT | not recorded |
| right | UHUGEINT | not recorded |

Declared return type: UHUGEINT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-24c8cb8fde950519

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: UINTEGER, right: UINTEGER) → UINTEGER
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-24c8cb8fde950519

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | UINTEGER | not recorded |
| right | UINTEGER | not recorded |

Declared return type: UINTEGER. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-974c210fee86f535

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: USMALLINT, right: USMALLINT) → USMALLINT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-974c210fee86f535

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | USMALLINT | not recorded |
| right | USMALLINT | not recorded |

Declared return type: USMALLINT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.

### overload-32b35fb7676316ba

Kind: scalar. Parameter order: catalog-order.

```text
subtract(left: UTINYINT, right: UTINYINT) → UTINYINT
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/subtract/#overload-32b35fb7676316ba

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| left | UTINYINT | not recorded |
| right | UTINYINT | not recorded |

Declared return type: UTINYINT. Variadic argument type: none declared.
Stability: CONSISTENT. Declared side effects: false.


## Guide recipes

No guide recipes.

## Engine catalog examples

Source examples may require additional data or extensions. Expressions are wrapped in SELECT; execution verification is not recorded.

No catalog examples.

## Additional DuckDB documentation

- [Numeric Functions](https://duckdb.org/docs/current/sql/functions/numeric#subtractx-y)

## Observed availability

| Snapshot | Observed | Overloads | JSON |
| --- | --- | --- | --- |
| haybarn-2.0.0-rc12 | present | 37 | [reference](/products/haybarn/functions/api/v1/haybarn-2.0.0-rc12/functions/subtract.json) |
| haybarn-2.0.0-rc11 | present | 37 | [reference](/products/haybarn/functions/api/v1/haybarn-2.0.0-rc11/functions/subtract.json) |
| haybarn-2.0.0-rc8 | present | 37 | [reference](/products/haybarn/functions/api/v1/haybarn-2.0.0-rc8/functions/subtract.json) |
| haybarn-1.5.5-rc3 | present | 37 | [reference](/products/haybarn/functions/api/v1/haybarn-1.5.5-rc3/functions/subtract.json) |
| haybarn-1.5.6-rc6 | present | 37 | [reference](/products/haybarn/functions/api/v1/haybarn-1.5.6-rc6/functions/subtract.json) |
| duckdb-2.0.0 | present | 37 | [reference](/products/haybarn/functions/api/v1/duckdb-2.0.0/functions/subtract.json) |
| duckdb-1.5.6 | present | 37 | [reference](/products/haybarn/functions/api/v1/duckdb-1.5.6/functions/subtract.json) |
| duckdb-1.5.5 | present | 37 | [reference](/products/haybarn/functions/api/v1/duckdb-1.5.5/functions/subtract.json) |
| duckdb-1.4.4 | present | 37 | [reference](/products/haybarn/functions/api/v1/duckdb-1.4.4/functions/subtract.json) |
| duckdb-1.3.2 | present | 35 | [reference](/products/haybarn/functions/api/v1/duckdb-1.3.2/functions/subtract.json) |

Engine catalog documentation is derived from MIT-licensed Haybarn and DuckDB. [Notices](/third-party-notices.txt).
