NEGATE Function

Returns the opposite of the value that is the first argument. Equivalent to the - operator placed in front of the argument.

The argument can be a literal Integer or Decimal number, a function returning a number, or a reference to a column containing numeric values.

Note

Within an expression, you might choose to use the corresponding operator, instead of this function. For more information, see Numeric Operators.

Wrangle vs. SQL: This function is part of Wrangle, a proprietary data transformation language. Wrangle is not SQL. For more information, see Wrangle Language.

Basic Usage

negate(MyValue)

Output: Returns the opposite of the value in the MyValue column.

Syntax and Arguments

negate(value1)

Argument	Required?	Data Type	Description
value1	Y	string	The first value must be an Integer or Decimal literal, column reference, or expression that evaluates to one of those two numeric types.

For more information on syntax standards, see Language Documentation Syntax Notes.

value1

Integer or Decimal expressions, column references or literals.

Missing or mismatched values generate missing string results.

Usage Notes:

Required?	Data Type	Example Value
Yes	Literal, function, or column reference returning an Integer or Decimal value	15

Examples

Tip

For additional examples, see Common Tasks.

Example - Numeric Functions

This example demonstrates how to use numeric functions to perform computations in your recipe steps.

Functions:

Item	Description
ADD Function	Returns the value of summing the first argument and the second argument. Equivalent to the `+` operator.
MOD Function	Returns the modulo value, which is the remainder of dividing the first argument by the second argument. Equivalent to the `%` operator.
NEGATE Function	Returns the opposite of the value that is the first argument. Equivalent to the `-` operator placed in front of the argument.
SUBTRACT Function	Returns the value of subtracting the second argument from the first argument. Equivalent to the `-` operator.
MULTIPLY Function	Returns the value of multiplying the first argument by the second argument. Equivalent to the `*` operator.
DIVIDE Function	Returns the value of dividing the first argument by the second argument. Equivalent to the `/` operator.
LCM Function	Returns the least common multiple shared by the first and second arguments.

Source:

ValueA	ValueB
8	2
10	4
15	10
5	6

Transformation:

Execute the following transformation steps:

Transformation Name	`New formula`
Parameter: Formula type	Single row formula
Parameter: Formula	ADD(ValueA, ValueB)
Parameter: New column name	'add'

Transformation Name	`New formula`
Parameter: Formula type	Single row formula
Parameter: Formula	SUBTRACT(ValueA, ValueB)
Parameter: New column name	'subtract'

Transformation Name	`New formula`
Parameter: Formula type	Single row formula
Parameter: Formula	MULTIPLY(ValueA, ValueB)
Parameter: New column name	'multiply'

Transformation Name	`New formula`
Parameter: Formula type	Single row formula
Parameter: Formula	DIVIDE(ValueA, ValueB)
Parameter: New column name	'divide'

Transformation Name	`New formula`
Parameter: Formula type	Single row formula
Parameter: Formula	MOD(ValueA, ValueB)
Parameter: New column name	'mod'

Transformation Name	`New formula`
Parameter: Formula type	Single row formula
Parameter: Formula	NEGATE(ValueA)
Parameter: New column name	'negativeA'

Transformation Name	`New formula`
Parameter: Formula type	Single row formula
Parameter: Formula	LCM(ValueA, ValueB)
Parameter: New column name	'lcm'

Results:

With a bit of cleanup, your dataset results might look like the following:

ValueA	ValueB	lcm	negativeA	mod	divide	multiply	subtract	add
8	2	8	-8	0	4	16	6	10
10	4	20	-10	2	2.5	40	6	14
15	10	30	-15	5	1.5	150	5	25
5	6	30	-5	5	0.833333333	30	-1	11

In this section: