Skip to main content
Docs
Go to the Studio
Roberty Studio
RPADate and time

Add Date

Add Date

Increments a date by adding an amount of time in a defined unit, returning the new resulting date. Ideal for calculating future deadlines, due dates or upcoming periods — such as "in 30 days" or "next month". It can take holidays into account in the calculation when it is linked to a Date and time settings action.


Options​

Use a date relative to the robot's execution?​

Defines whether the base date will be the current date at the moment of the execution. Select Yes to use the current date automatically, or No to provide a specific date.

Input format date​

Select the format of the base date provided: Traditional (31/12/2024), In full (31 de dezembro de 2024) or International (2024-12-31). This field is only shown when Use a date relative to the robot's execution? is set to No.

Date to be formatted​

Enter the base date to which the time will be added. This field is only shown when Use a date relative to the robot's execution? is set to No.

Quantity​

Enter the amount of time that will be added to the base date.

Time unit​

Select the unit of the amount provided: Day, Week, Month or Year.

Output date format​

Select the format in which the resulting date will be returned: Traditional (31/12/2024), In full (31 de dezembro de 2024) or International (2024-12-31).

Select the date settings​

Select a Date and time settings action so that holidays are taken into account in the calculation. This field is optional.

Output language​

Choose the language of the output date — Brazil Portuguese or English. For example, Brazil Portuguese produces an output such as 17 de abril de 2026.

Returns​

Javascript code​

js
actions["action-id"].value // resulting date after the time is added (Text)

Field selection​

  • value — new date with the time added, in the output format selected (Text)

Rules and Conditions​

  • The Quantity field is required.
  • When Use a date relative to the robot's execution? is No, the date provided must match the format selected in Input format date.
  • The Select the date settings field is optional — when provided, the days configured as holidays are skipped in the calculation.