> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> すべての範囲（数値軸上の区間）のユニオンの全長を計算します。

# intervalLengthSum

<div id="intervalLengthSum">
  ## intervalLengthSum
</div>

導入バージョン: v21.7.0

複数の数値範囲を受け取り、重なっている部分をすべて 1 つの連続した範囲としてまとめた場合の全長を計算します。

<Note>
  引数は同じデータ型である必要があります。
  そうでない場合は、例外がスローされます。
</Note>

**構文**

```sql theme={null}
intervalLengthSum(start, end)
```

**引数**

* `start` — 区間の開始値。[`(U)Int32/64`](/ja/reference/data-types/int-uint) または [`Float*`](/ja/reference/data-types/float) または [`DateTime`](/ja/reference/data-types/datetime) または [`Date`](/ja/reference/data-types/date)
* `end` — 区間の終了値。[`(U)Int32/64`](/ja/reference/data-types/int-uint) または [`Float*`](/ja/reference/data-types/float) または [`DateTime`](/ja/reference/data-types/datetime) または [`Date`](/ja/reference/data-types/date)

**戻り値**

すべての範囲のユニオンの全長 (数値軸上のセグメント) を返します。引数の型に応じて、戻り値の型は UInt64 または Float64 になります。[`UInt64`](/ja/reference/data-types/int-uint) または [`Float64`](/ja/reference/data-types/float)

**使用例**

**Float32 の例**

```sql title=Query theme={null}
CREATE TABLE fl_interval (id String, start Float32, end Float32) ENGINE = Memory;
INSERT INTO fl_interval VALUES ('a', 1.1, 2.9), ('a', 2.5, 3.2), ('a', 4, 5);

SELECT id, intervalLengthSum(start, end), toTypeName(intervalLengthSum(start, end)) FROM fl_interval GROUP BY id ORDER BY id;
```

```response title=Response theme={null}
┌─id─┬─intervalLengthSum(start, end)─┬─toTypeName(intervalLengthSum(start, end))─┐
│ a  │                           3.1 │ Float64                                   │
└────┴───────────────────────────────┴───────────────────────────────────────────┘
```

**DateTimeの例**

```sql title=Query theme={null}
CREATE TABLE dt_interval (id String, start DateTime, end DateTime) ENGINE = Memory;
INSERT INTO dt_interval VALUES ('a', '2020-01-01 01:12:30', '2020-01-01 02:10:10'), ('a', '2020-01-01 02:05:30', '2020-01-01 02:50:31'), ('a', '2020-01-01 03:11:22', '2020-01-01 03:23:31');

SELECT id, intervalLengthSum(start, end), toTypeName(intervalLengthSum(start, end)) FROM dt_interval GROUP BY id ORDER BY id;
```

```response title=Response theme={null}
┌─id─┬─intervalLengthSum(start, end)─┬─toTypeName(intervalLengthSum(start, end))─┐
│ a  │                          6610 │ UInt64                                    │
└────┴───────────────────────────────┴───────────────────────────────────────────┘
```

**日付の例**

```sql title=Query theme={null}
CREATE TABLE date_interval (id String, start Date, end Date) ENGINE = Memory;
INSERT INTO date_interval VALUES ('a', '2020-01-01', '2020-01-04'), ('a', '2020-01-12', '2020-01-18');

SELECT id, intervalLengthSum(start, end), toTypeName(intervalLengthSum(start, end)) FROM date_interval GROUP BY id ORDER BY id;
```

```response title=Response theme={null}
┌─id─┬─intervalLengthSum(start, end)─┬─toTypeName(intervalLengthSum(start, end))─┐
│ a  │                             9 │ UInt64                                    │
└────┴───────────────────────────────┴───────────────────────────────────────────┘
```