---
schema_version: "1"
id: 7d4622d890a447988ddb49440d243c3b23a530d5bcdc680332128443973d5ec3
title: duration
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/dataweave/2.5/dw-periods-functions-duration.md
canonical_url: https://docs.mulesoft.com/jp/dataweave/2.5/dw-periods-functions-duration
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 882e78e926e02a9c33bb093c9dd3ec0477f4343695f7172ba5af7efedc7b7564
description: MuleSoft Documentation Site
release: "2.5"
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
}
```