Subtract Date Time activity

An activity that subtracts time from a specified date and time.


Subtract Date Time activity

Configure the Subtract Date Time activity

To configure the Subtract Date Time activity, do the procedure in this topic.

Good to Know

How to Start

  1. Open Process Builder.

    For information about how to open this screen, refer to Process Builder.


    Open Process Builder
  2. In Process Builder, in the Activity Library, open the Utilities tab.

    Open Utilities tab
  3. On the Utilities tab, drag the Subtract Date Time activity onto your process.

    Drag Subtract Date Time activity

Procedure

  1. Complete the fields on the General Configuration screen.
  2. Click Subtract Date Time Subtract Date Time icon.
  3. Complete the fields on the Subtract Date Time screen.

    For more information, refer to Subtract Time from a Specified Date and Time.

  4. (Optional) Click Advanced Advanced icon > Email Notifications E-mail Notifications icon.

    For more information, refer to Email Notifications screen (Process Activities).

General Configuration

Specifies the basic settings for the Subtract Date Time activity.

Figure: General Configuration screen

General Configuration screen

Fields

Field NameDefinition

Display Name

Description:
Specifies the activity name that shows in your process.
Allowed Values:
One line of text (a string).

Accepted:

  • Letters
  • Numbers
  • Spaces
Default Value:
None
Accepts Variables:
No
Example:
This is a common configuration field that is used in many examples. Refer to:
  • Examples - Step-by-step use case examples, information about what types of examples are provided in the AgilePoint NX Product Documentation, and other resources where you can find more examples.

Description

Description:
Specifies an optional text description for your activity.
Allowed Values:
More than one line of text.
Default Value:
None
Accepts Variables:
No

Subtract Date Time

Specifies the settings to subtract time from your specified date and time.

Figure: Subtract Date Time screen

Subtract Date Time screen

Fields

Field NameDefinition

Input Date Time

Description:
Specifies the reference date for your date calculation.
Allowed Values:
  • Custom Attributes - Specifies a process data variable that stores the date-time value and your date-time format.

    You can use App Data screen to specify a process data variable.

    You can also use a custom date-time format. For more information, refer to Customize Your Date-Time Format.

  • Static - Specifies a static date and time.
  • Now - The date and time the system activity starts at runtime.
Default Value:
Custom Attributes
Example:
Refer to:

Subtract

Description:
Specifies the time to subtract from the Input Date Time.
Allowed Values:
  • An integer, or a process data variable that stores an integer.

    You can use App Data screen to specify a process data variable.

  • The time unit.

    Options are:

    • Seconds
    • Minutes
    • Hours
    • Days
    • Weeks
    • Months
    • Years
Default Value:
Days
Accepts Variables:
Yes
Example:
If the value is set to 10, and the time unit is set to Days, 10 Days are added or subtracted.

My Organization's Business Time

Description:
Specifies to use your work calendar for date calculations.
To Open this Field:
  1. On the Email Notifications screen, click the Reminder tab.
Allowed Values:
  • Deselected - Uses your work calendar for calculations.
  • Selected - Does not use your work calendar for calculations.
Default Value:
Deselected
Example:
The Business Time field is set as selected, and business hours of work calendar are configured as 9 AM to 5 PM. If the task with completion time 8 hours is entered at 1 PM on Monday, then the task must be completed by 12 PM on Tuesday.

Date String

Description:
Specifies the process data variable that stores the result received from the date calculations if it is in the Date Time format.

The results of the date calculations that changes from the Date Time format to a String. The format of the string is specified in the list.

Allowed Values:
A process data variable that stores the result in the selected String format.
Default Value:
None
Accepts Variables:
Yes
Example:
Refer to:

Test Mode

Description:
Lets you see if your settings give the necessary result before you run the process.
Allowed Values:
  • Deselected - Test mode is disabled.
  • Selected - Test mode is enabled.
Default Value:
Deselected

Test

Function:
Runs a test to validate the specified date-time settings.