DateTime Services Configuration Window

This window enables you to configure date calculations.



Field Definitions

Field Name Definition
Input DateTime

Specifies 1 or 2 dates to use as input values. You can select a Custom Attribute, a Static date and time, or the date and time Now (when the DateTime AgilePart is initiated).

Add

Specifies an amount of time to add to the Input DateTime.

Subtract

Specifies an amount of time to subtract from the Input DateTime.

Compare Difference

Indicates whether to compare the difference between the two Input DateTime values.

Return

Specifies whether to pass the earlier or later value based on the comparison.

Change Input DateTime to Output Format

Indicates that the Input DateTime format will be converted to the Output.

Business Time

Specifies that the AgilePoint work calendar is taken into account for calculations.

Calculation Type

Specifies whether to calculate or compare the difference between Input DateTime 1 and Input DateTime 2. You can specify the following types of calculations:


  • Real - The actual difference between the two input DateTimes. The result depends on the setting for the Result option.
  • Relative - This setting is useful for situations such as when an action is allowed once per month. The "real" difference between the last day of one month and the first day of following month is 0 months. However, in "relative" mode, this difference is calculated as one month because the dates are in adjacent months. This returns the relative number of time units (days, weeks, months, years) between the two input DateTimes. For example, the Relative differences between Sat 29-Dec-2007 23:59:59 and Wed 02-Jan-2008 00:00:00 are 4 days or 1 week or 1 month or 1 year, depending upon the time unit specified.
Result

Specifies the type of value to return for calculations where the Calculation Type is Real:


  • Decimal - Returns the difference as is, including any decimals.
  • Whole Number - Returns the integer part of the result by removing the decimal part.
  • Rounded - Rounds up (>=0.5) or rounds down (<0.5) the result.
Result Boolean

If Compare Difference is enabled, the difference will be evaluated as a Boolean (True/False) result, and the Boolean value will be associated with the text that appears in this field.

Date String

If based on the operation performed, the output is of type DateTime, the result will be converted to a string and stored in the format provided in the Format list, and stored associated with the text that appears in this field.

Difference

If Compare Difference is enabled, the difference will be stored as a NameValue where the name is the text that appears in this field, and the value is the output value.