verticapy.vDataColumn.sub#

vDataColumn.sub(x: int | float | Decimal) → vDataFrame#

Subtracts the input element from the vDataColumn.

Parameters#

x: PythonNumber: If the vDataColumn type is date (date, datetime …), the parameter ‘x’ represents the number of seconds, otherwise it represents a number.

Returns#

vDataFrame: self._parent

Examples#

Let’s begin by importing VerticaPy.

import verticapy as vp

Hint

By assigning an alias to verticapy, we mitigate the risk of code collisions with other libraries. This precaution is necessary because verticapy uses commonly known function names like “average” and “median”, which can potentially lead to naming conflicts. The use of an alias ensures that the functions from verticapy are used as intended without interfering with functions from other libraries.

Let us create a dummy dataset with negative values:

vdf = vp.vDataFrame({"val" : [10, -10, 20, -2]})

	123 val Integer 100%
1	10
2	-10
3	20
4	-2

We can conveniently substract 5 from all the values in a column:

vdf["val"].sub(5)

	123 val Integer 100%
1	5
2	-15
3	15
4	-7

Note

While the same task can be accomplished using pure SQL (see below), adopting a Pythonic approach can offer greater convenience and help avoid potential syntax errors.

vdf["val"] = "val - 5"