Date Shift Operator

The Date Shift Operator component calculates a new date by adding a period of time to an existing date property or by subtracting a period of time from an existing date property. The new date is saved in a new date property. The time unit is expressed in seconds, minutes, hours, or days. You use this component to change an existing date into an earlier or a later date.

Example

In a chargeable item class called “Telephone Service”, you want to give a customer a time-credit of six seconds for each call. To define the payable period, you use the Date Shift component to recalculate the start date of the customer’s call.

Note: You can easily calculate the local time based on GMT time if you know the GMT offset. You enter the consumption date as the original date to which you add the numerical property “GMT Offset” representing the period of time in hours. The calculation result determines the local time that is saved in the computed property. You can also use the local time in the subbranch of the price plan.

Identification area

Name: Type the name of the component (mandatory).

Description: Allows you to type the description of the component (optional).

Definition tab

Date Property Name: Provides the list of date properties. Select a date property.

Computed Property Name: Type the name of the new date property that retrieves the calculation result.

Operation: Provides the list of operations. The default option is Subtraction. Select one of the following operations:

Duration: Allows you to type the period of time that is added to or subtracted from a numerical property, or allows you to select a numerical property that represents the period of time.

Note: Whether you type the period of time or select a numerical property, if the period of time is a decimal number, the fractional part of the decimal number is truncated. Only the integer part is added to or subtracted from the date property. For example, adding 1.5 hours to August 28, 2007 2:13:48 PM gives the result August 28, 2007 3:13:48 PM, or subtracting 2.10 hours to August 28, 2007 2:13:48 PM gives the result August 28, 2007 0:13:48 PM.

Duration Unit: Provides the list of time units. The default option is seconds. Select one of the following time units: