Date Math

Block Group: Date Time Operations
Icon:Date Math block icon

The Date Math block adds time to or subtracts time from the input date and time and returns the serial number that represents the result.

One use of the Date Math block is to calculate maturity dates. Another use is to calculate due dates that occur on the same day of the month as the date of issue.

For information on using dataflow blocks, see Dataflow.

Input/Output Properties

The following properties of the Date Math block can take input and give output.

  • input (number or date time string)
  • op (enum)
  • year (number)
  • month (number)
  • day (number)
  • hour (number)
  • minute (number)
  • second (number)
  • millisecond (number)

input specifies the serial number or any supported date time string as outlined here.

op specifies the operator that the Date Math block uses to perform calculations on the input date. The value of the op property can be one of the following:

  • After: The values of the other inputs are added to the input value.
  • Before: The values of the other inputs are subtracted from the input value.

year specifies the number of years to add or subtract, as a number with one to four digits.

month specifies the number of months to add or subtract.

day specifies the number of days to add or subtract.

hour specifies the number of hours to add or subtract.

minute specifies the number of minutes to add or subtract.

second specifies the number of seconds to add or subtract.

millisecond specifies the number of milliseconds to add or subtract.

Output Property

The following property of the Date Math block can give output but cannot take input.

  • output (number)

output returns the result of the operation.


The following image shows two examples of the Date Math block. In the leftmost Date Math block, one month is added to the input date. In the rightmost Date Math block, one month, ten days, one hour, and five minutes are subtracted from the input date.

Date Math block examples