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

# CASCADEDATEINTERVALV2

> YiDA の日付範囲ピッカーコンポーネントで、開始日と終了日の差分を算出する CASCADEDATEINTERVALV2 関数の使い方を解説します。フォームやワークフロー設計での利用シーン、単位指定（日・時・秒）、パラメータ、実例まで詳しく紹介します。

CASCADEDATEINTERVALV2 関数は、日付範囲ピッカーコンポーネントの開始日と終了日の差分を算出します。

## 対応プロダクトシーン

CASCADEDATEINTERVALV2 関数は、以下の YiDA シーンで利用できます。

* フォーム（メインフォームフィールド）
* フォーム（業務関連ルール）
* フォーム（バリデーション）
* ワークフロー設計（バリデーションルール）
* ワークフロー設計（関連アクション）
* 統合と自動化
* 作業フローノード
* コネクタ

## フォーマット

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
CASCADEDATEINTERVALV2(日付コンポーネント, type, オフセット)
```

## 属性説明

| **属性**    | **必須** | **説明**                                               |
| --------- | ------ | ---------------------------------------------------- |
| timestamp | はい     | 日付範囲コンポーネント。                                         |
| type      | はい     | 差分の単位。有効な値：<br />• d：日<br />• **h**：時<br />• **s**：秒 |
| オフセット     | はい     | 単位の長さに基づくオフセット。正の数または負の数を指定できます。                     |

## 戻り値

| **戻り値のタイプ** | **説明**      |
| ----------- | ----------- |
| 数値          | 2 つの日付間の差分。 |

## 例

* 例 1：

日付フォーマットが `YYYY-MM-DD` の日付範囲で、開始日が `2023-12-01`、終了日が `2023-12-31` の場合。

数式は 31 を返します。

* 例 2：

日付フォーマットが `YYYY-MM-DD HH:mm:ss` の日付範囲で、開始時刻が `2023-12-01 09:30:00`、終了時刻が `2023-12-01 18:00:00` の場合。

数式は 8.5 を返します。

## 試してみる

日付範囲ピッカーコンポーネントの開始日と終了日の差分を算出します。