Skip to main content
Go to the Studio
Date and time

Remove Date

Remove Date

Decrements a date by subtracting an amount of time in a defined unit, returning the new resulting date. Ideal for calculating past dates, previous periods or retroactive time windows — such as "30 days ago" or "last 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. This field is only shown when Use a relative date is set to No and the date to be formatted is of the free text type.

Date to be formatted​

Enter the base date from which the time will be subtracted from. This field is only shown when Use a relative date is set to No.

Quantity​

Enter the amount of time that will be subtracted from the base date.

Time unit​

Select the unit of the amount provided. The options include days, weeks, months, years, hours, minutes and seconds.

Output date format​

Select the format in which the resulting date will be returned.

Output language​

Choose the language of the output date — for example Brazil Portuguese, producing an output such as 17 de abril de 2026.

Date settings​

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

Returns​

Custom code​

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

Field selection​

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

Rules and Conditions​

  • The Quantity, Time unit and Output date format fields are required.
  • When Use a relative date is No, the Input format date and Date fields are also required.
  • The Date settings field is optional — use it to exclude holidays from the calculation.