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.

Basic Usage

derive value: NEGATE(MyValue) as:'oppositeOfMyValue'

Output: The opposite of the value in the MyValue column is stored in a new column oppositeOfMyValue.

Syntax

derive value:NEGATE(value1)

ArgumentRequired?Data TypeDescription
value1YstringThe 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 TypeExample Value
YesLiteral, function, or column reference returning an Integer or Decimal value15

Examples

Example - Numeric Functions

This example demonstrate the following numeric functions:

Source:

ValueAValueB
82
104
1510
56

Transform:

Execute the following transforms:

derive value:ADD(ValueA, ValueB) as:'add'

derive value:SUBTRACT(ValueA, ValueB) as:'subtract'

derive value:MULTIPLY(ValueA, ValueB) as:'multiply'

derive value:DIVIDE(ValueA, ValueB) as:'divide'

derive value:MOD(ValueA, ValueB) as:'mod'

derive value:NEGATE(ValueA) as:'negativeA'

Results:

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

ValueAValueBnegativeAmoddividemultiplysubtractadd
82-80416610
104-1022.540614
1510-1551.5150525
56-550.83333333330-111

Was this page helpful? Let us know how we did:

Send feedback about...

Google Cloud Dataprep Documentation