CSM 10.4 Documentation

Home

Numeric Modifiers

A numeric token displays or performs a mathematical calculation using a string of tokens and mathematical symbols (example: Calculate the total cost of labor of a Labor Cost Item by multiplying the work hours by the monetary rate).

The format of the numeric value must be taken into consideration when applying numeric modifiers to tokens.

The following modifiers can be applied to numeric tokens.

Absolute Value

Returns the absolute value of the original.

Example:

  • Original token: -42
  • Modifier: Absolute Value
  • Result: 42
Format

See Numeric Modifier Formats.

Hours to Time Format

Converts hours to a specified time format:

  • DD:HH:MM:SS
  • DD:HH:MM
  • HH:MM:SS
  • HH:MM

Math

Allows for simple math operators to be applied against the value in the token.

Note: Users cannot use values from other tokens as part of the calculation. To use values from other tokens in the calculation, use a Numeric Expression.

The math modifier supports these operators:

  • Add: Adds a specific amount to the value.
  • Subtract: Subtracts a specific amount from the value.
  • Multiple: Multiplies the value by a specific amount.
  • Divide: Divides the value by a specific amount.
  • Absolute Value: If the value is negative, the value is made positive. Positive values will remain unchanged.
  • Modulo: Returns the remainder of a division calculation. Examples:
    • 10%3 returns 1
    • 5%3 returns 2
    • 3%10 returns 3

    In the last example, 3 is returned because the 3 divided by 10 is 0, with 3 as the remainder.

Minutes to Time Format

Converts minutes to a specified time format:

  • DD:HH:MM:SS
  • DD:HH:MM
  • HH:MM:SS
  • HH:MM

Number to Logical

Converts a number to a logical value. This is useful when formatting a result based on whether the value is 0 or not.

The value 0 will be converted to False. Any other value will be converted to True.

Round

Rounds a number to a specified number of decimal places.

Example:

  • Original token: 33.75
  • Modifier: Round (0 places)
  • Result: 34
Seconds to Time Format

Converts seconds to a specified time format.

  • DD:HH:MM:SS
  • DD:HH:MM
  • HH:MM:SS
  • HH:MM

Truncate

Removes the decimal component of a number.

Example:

  • Original token: 33.75
  • Modifier: Truncate
  • Result: 33

Was this article useful?