---
category: [, Administration & Integrations, Platform and Product Extensions, Platform and Product Extensions/Integration, Administration & Integrations/Custom Integrations & Apps, Platform and Product Extensions/Workday Extend]
keyword: [Extend, PMD Scripting, Scripts]
nav: wcp_docs
parent_url: /wcp_docs/
title: add (precision, duration)
layout: subsection
---

## <a id="section_m3p_myb_5db"></a>Description

Adds a duration to a date with the given precision. If the given duration is null, returns original date.

## <a id="section_cyq_j1m_zsb"></a>Return Type

`Date`

## <a id="section_instanceMethodSyntax"></a>Instance Method Syntax

```
thisDate.add(precision, duration)
```

<table><thead><tr><th>Parameter</th><th>Description</th></tr></thead><tbody><tr><td>precision</td><td>The unit of measure for the duration. Valid values (case-sensitive): <ul><li>YEAR
</li><li>MONTH
</li><li>DAY
</li><li>HOUR
</li><li>MINUTE
</li><li>SECOND
</li><li>MILLISECOND
</li></ul></td></tr><tr><td>duration</td><td>The duration to add to the given date, using precision as its unit of measure.</td></tr></tbody></table><br/>

<b>Example</b>

Assume <i>aDateWidget.value</i> contains <i>03/01/2022 08:30:00</i>.

```
{
    "type": "date",
    "id": "newDate",
    "label": "New Date",
    "datePrecision": "SECOND",
    "dateFormat": "MM/dd/yyyy hh:mm:ss",
    "value": "<% aDateWidget.value.add('HOUR', 1).format('MM/dd/yyyy hh:mm:ss') %>"
}
```

The <i>newDate</i> displays <i>03/01/2022 09:30:00 AM</i>.

## <a id="section_dz5_pwg_5d"></a>Namespace Function Syntax

```
date:add(date, precision, duration)
```

<table><thead><tr><th>Parameter</th><th>Description</th></tr></thead><tbody><tr><td>date</td><td>A Date object to add to, typically the value of a date or time tag.</td></tr><tr><td>precision</td><td>The unit of measure for the duration. Valid values (case-sensitive): <ul><li>YEAR
</li><li>MONTH
</li><li>DAY
</li><li>HOUR
</li><li>MINUTE
</li><li>SECOND
</li><li>MILLISECOND
</li></ul></td></tr><tr><td>duration</td><td>The duration to add to the given date, using precision as its unit of measure.</td></tr></tbody></table><br/>

<b>Examples</b>

Assume <i>dateId</i> is the id of a date widget whose value is 2018-05-29 12:47:30

`date:add(dateId.value, 'HOUR', 1)`

Returns: `2018-05-29 13:47:30`

This next example converts a date string to a Date object:

`date:add(date:parseDateString('2016-10-31'), 'DAY', 10)`

Returns: `2016-11-10`