---
schema_version: "1"
id: 6ad526ee1f262b46656e577c619665cb4165f4b891b6f713e05839a8fafc4207
title: duration
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/dataweave/2.4/dw-periods-functions-duration.md
canonical_url: https://docs.mulesoft.com/jp/dataweave/2.4/dw-periods-functions-duration
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 4bf2f8f5e77415639b5b53eac252330ef83685aa4d531f15b992639e2e363276
description: MuleSoft Documentation Site
release: "2.4"
latest: false
---
# duration

## [](#duration1)duration(period: { days?: Number, hours?: Number, minutes?: Number, seconds?: Number }​): Period

日数、時間数、分数、または秒数を表す Period (期間) 値を作成します。

_DataWeave バージョン 2.4.0 で導入されました。_​

### [](#パラメーター)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">​<code>period</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">​<code>{days:4, hours:11, minutes:45, seconds: 55}</code>​ などのオブジェクト。
             キー-値のペアは省略可能であり、任意の順序で指定できます。空のオブジェクト (​<code>{}</code>​) では、Period (期間) 値 ​<code>"PT0S"</code>​ (0 秒) を返します。各キーのデフォルト値は ​<code>0</code>​ です。有効な値は整数または小数で、正でも負でも問題ありません。キー名は選択可能です。</p></td>
</tr>
</tbody>
</table>

### [](#例)例

次の例では、さまざまな入力での ​`duration`​ の動作を示します。

#### [](#ソース)ソース

```DataWeave
%dw 2.0
import * from dw::core::Periods
output application/json
---
{
   dayAfterDateTime: |2020-10-05T20:22:34.385Z| + duration({days: 1}),
   dayAndHourBeforeDateTime: |2020-10-05T20:22:34.385Z| - duration({days: 1, hours: 1}),
   pointInTimeBefore: |2020-10-05T20:22:34.385Z| - duration({days: 1, hours: 1, minutes: 20, seconds: 10}),
   emptyDuration: duration({}),
   constructDuration: duration({days:4, hours:11, minutes:28}),
   selectHoursFromDuration: duration({days:4, hours:11, minutes:28}).hours,
   decimalAsPeriod:  duration({seconds: 30.5}),
   addNegativeValue: duration({ minutes : 1 }) + duration({ seconds : -1 })
}
```

#### [](#出力)出力

```Json
{
   "dayAfterDateTime": "2020-10-06T20:22:34.385Z",
   "dayAndHourBeforeDateTime": "2020-10-04T19:22:34.385Z",
   "pointInTimeBefore": "2020-10-04T19:02:24.385Z",
   "emptyDuration": "PT0S",
   "constructDuration": "PT107H28M",
   "selectHoursFromDuration": 11,
   "decimalAsPeriod": "PT30.5S",
   "addNegativeValue": 59
}
```