Convert Date Format activity

An activity that changes the data format for a date-time value.


Convert Date Format activity

Configure the Convert Date Format activity

To configure the Convert Date Format activity, do the procedure in this topic.

Examples

Good to Know

How to Start

  1. On the Application Explorer screen, do one of these:
  2. Do one of these:
    • Add an activity:
      1. In the Process Builder, in the Activity Library, open the Utilities Utilities icon tab.
      2. On the Utilities Utilities icon tab, drag the Convert Date Format Convert Date Format icon activity onto your process.
    • Change an activity:
      1. In your process, double-click your activity.

Procedure

  1. Complete the fields on the General Configuration screen.

    For more information, refer to Configure General Options for a System Activity.

  2. Click Convert Date Format Convert Date Format icon.
  3. Complete the fields on the Convert Date screen.

    For more information, refer to Change the Data Format for a Date and Time.

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

    For more information, refer to Configure E-mail Notifications for Any Activity.

General Configuration

Specifies the basic settings for the Convert Date Format activity.

Figure: General Configuration screen

General Configuration screen

Fields

Field Name Definition

Display Name

Function:
Specifies the activity name that shows in your process.
Accepted Values:
One line of text that can have spaces.
Default Value:
None
Accepts Process Data 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

Function:
Specifies an optional text description for your activity.
Accepted Values:
More than one line of text.
Default Value:
None
Accepts Process Data Variables:
No

Convert Date

Specifies the settings to change the date-time data format.

Figure: Convert Date screen

Convert Date screen

Fields

Field Name Definition

Input Date Time

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

    You can use Process 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:

Change Input Date Time to Output format

Function:
Specifies if the date format entered for the Input Date Time field changes to the format in the Date String field.

The DateTime data type for Input Date Time changes to a string data type in the format given in the list. It is then stored in the process data variable that shows in the Date String field.

This field indicates that the activity is operating. It is a read-only field. It is not possible to deselect this option.

Accepted Values:
  • Selected - The value for Input Date Time changes to the output format.
Default Value:
Selected

Date String

Function:
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.

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

Test Mode

Function:
Lets you see if your settings give the necessary result before you run the process.
Accepted 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.