Use the Add component
Increase or decrease the time or date by the value you specify as part of a Workflow with the Add component in RPA Desktop Design Studio.
Before you begin
Role required: none
About this task
You can configure the properties for the Add component. For more information about these properties, see Properties of the DateTime components.
Procedure
-
In the Toolbox pane, navigate to Utilities > DateTime.
-
Drag the Add component to the Design surface.
-
To configure the input fields, see Configure port properties.
-
Connect the data and control ports of the Add component to the corresponding ports of the other components as described in the following table.
|
Port type |
Purpose of connection |
Mandatory? |
|---|---|---|
|
Data In (SourceDate) |
Passes the source date, which is the date or time that the Add component increases or decreases by the value you specify, from a previously executed component. |
Yes |
|
Data In (Type) |
Passes the unit of time from a previously executed component. You can provide the following values:- Year
|
Yes |
|
Data In (Value) |
Passes the numeric value by which you want to change the source date, from a previously executed component. For example, if you provide 5 and the source date 10/8/2019, then the new source date will be 10/13/2019. |
Yes |
|
Data Out |
Returns the updated date and time. |
Yes.To preview the data, right-click the Return field and click Preview Data. |
|
Control In |
Connects to the Control Out port of one or more components. |
Yes |
|
Control Out |
Connects to the Control In port of any other component. |
No. Connecting the port is optional. |
Parent Topic:DateTime
--- title: Use the Add component description: Increase or decrease the time or date by the value you specify as part of a Workflow with the Add component in RPA Desktop Design Studio. locale: en-US canonical_url: https://www.servicenow.com/docs/r/australia/integrate-applications/use-datetime-add.html release: australia topic_type: task last_updated: "2026-09-10" reading_time_minutes: 1 breadcrumb: [DateTime, Utilities, Automation components, RPA Desktop Design Studio, Robotic Process Automation \(RPA\) Hub, Workflow Data Fabric] --- # Use the Add component Increase or decrease the time or date by the value you specify as part of a Workflow with the Add component in RPA Desktop Design Studio. ## Before you begin Role required: none ## About this task You can configure the properties for the Add component. For more information about these properties, see [Properties of the DateTime components](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/util-datetime-prop.md). ## Procedure 1. In the Toolbox pane, navigate to **Utilities** > **DateTime**. 2. Drag the Add component to the Design surface. 3. To configure the input fields, see [Configure port properties](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/configure-input-port-properties.md). 4. Connect the data and control ports of the Add component to the corresponding ports of the other components as described in the following table. <table id="table_jnw_jn1_krb"><thead><tr><th> Port type </th><th> Purpose of connection </th><th> Mandatory? </th></tr></thead><tbody><tr><td> Data In \(SourceDate\) </td><td> Passes the source date, which is the date or time that the Add component increases or decreases by the value you specify, from a previously executed component. </td><td> Yes </td></tr><tr><td> Data In \(Type\) </td><td> Passes the unit of time from a previously executed component. You can provide the following values:- Year - Month - Day - Hour - Minute - Second - Millisecond - Tick </td><td> Yes </td></tr><tr><td> Data In \(Value\) </td><td> Passes the numeric value by which you want to change the source date, from a previously executed component. For example, if you provide 5 and the source date 10/8/2019, then the new source date will be 10/13/2019. </td><td> Yes </td></tr><tr><td> Data Out </td><td> Returns the updated date and time. </td><td> Yes.To preview the data, right-click the **Return** field and click **Preview Data**. </td></tr><tr><td> Control In </td><td> Connects to the Control Out port of one or more components. </td><td> Yes </td></tr><tr><td> Control Out </td><td> Connects to the Control In port of any other component. </td><td> No. Connecting the port is optional. </td></tr></tbody> </table>5. To test the component, under the **DESIGN** tab, click **Run**. **Parent Topic:**[DateTime](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/datetime-utility.md)
| title | Use the Add component |
| description | Increase or decrease the time or date by the value you specify as part of a Workflow with the Add component in RPA Desktop Design Studio. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/integrate-applications/use-datetime-add.html |
| release | australia |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 1 |
| breadcrumb | DateTimeUtilitiesAutomation componentsRPA Desktop Design StudioRobotic Process Automation \(RPA\) HubWorkflow Data Fabric |