

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 数学函数
<a name="recipe-actions.functions.math"></a>

以下为与配方操作配合使用的数学函数的参考主题。

**Topics**
+ [ABSOLUTE](recipe-actions.functions.ABSOLUTE.md)
+ [ADD](recipe-actions.functions.ADD.md)
+ [CEILING](recipe-actions.functions.CEILING.md)
+ [DEGREES](recipe-actions.functions.DEGREES.md)
+ [DIVIDE](recipe-actions.functions.DIVIDE.md)
+ [EXPONENT](recipe-actions.functions.EXPONENT.md)
+ [FLOOR](recipe-actions.functions.FLOOR.md)
+ [IS\$1EVEN](recipe-actions.functions.ISEVEN.md)
+ [IS\$1ODD](recipe-actions.functions.ISODD.md)
+ [LN](recipe-actions.functions.LN.md)
+ [LOG](recipe-actions.functions.LOG.md)
+ [MOD](recipe-actions.functions.MOD.md)
+ [MULTIPLY](recipe-actions.functions.MULTIPLY.md)
+ [NEGATE](recipe-actions.functions.NEGATE.md)
+ [PI](recipe-actions.functions.PI.md)
+ [POWER](recipe-actions.functions.POWER.md)
+ [RADIANS](recipe-actions.functions.RADIANS.md)
+ [RANDOM](recipe-actions.functions.RANDOM.md)
+ [RANDOM\$1BETWEEN](recipe-actions.functions.RANDOM_BETWEEN.md)
+ [ROUND](recipe-actions.functions.ROUND.md)
+ [SIGN](recipe-actions.functions.SIGN.md)
+ [SQUARE\$1ROOT](recipe-actions.functions.SQUARE_ROOT.md)
+ [SUBTRACT](recipe-actions.functions.SUBTRACT.md)

# ABSOLUTE
<a name="recipe-actions.functions.ABSOLUTE"></a>

在新列中返回输入数字的绝对值。*绝对值*是指数字与零的距离，无论是正数还是负数

**参数**
+ `sourceColumn`：现有列的名称。
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "ABSOLUTE",
        "Parameters": {
            "sourceColumn": "freezingTemps",
            "targetColumn": "absValueOfFreezingTemps"
        }
    }
}
```

# ADD
<a name="recipe-actions.functions.ADD"></a>

 在新列中使用（`sourceColumn1` \$1 `sourceColumn2`）或（`sourceColumn1` \$1 `value1`）对输入列值进行求和。

**参数**
+ `sourceColumn1`：现有列的名称。
+ `value1`：数值。
+ `sourceColumn2`：现有列的名称。
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "ADD",
        "Parameters": {
            "sourceColumn1": "weight_kg",
            "sourceColumn2": "height_cm",
            "targetColumn": "weight_plus_height"
        }
    }
}
```

# CEILING
<a name="recipe-actions.functions.CEILING"></a>

在新列中返回大于或等于输入十进制数字的最小整数。

**参数**
+ `sourceColumn`：现有列的名称。
+ `value1`：数值。
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "CEILING",
        "Parameters": {
            "sourceColumn": "weight_kg",
            "targetColumn": "weight_kg_CEILING"
        }
    }
}
```

# DEGREES
<a name="recipe-actions.functions.DEGREES"></a>

将角度的弧度转换为度数，并在新列中返回结果。

**参数**
+ `sourceColumn`：现有列的名称。
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "DEGREES",
        "Parameters": {
            "sourceColumn": "height_cm",
            "targetColumn": "height_cm_DEGREES"
        }
    }
}
```

# DIVIDE
<a name="recipe-actions.functions.DIVIDE"></a>

将一个输入数字除以另一个输入数字，然后在新列中返回结果。

**参数**
+ `sourceColumn1`：现有列的名称。
+ `value1`：数值。
+ `sourceColumn2`：现有列的名称。
+ `value2`：数值。
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "DIVIDE",
        "Parameters": {
            "sourceColumn1": "height_cm",
            "targetColumn": "divide_by_2",
            "value2": "2"
        }
    }
}
```

# EXPONENT
<a name="recipe-actions.functions.EXPONENT"></a>

在新列中返回以欧拉数为底、*n* 次幂的计算结果。

**参数**
+ `sourceColumn`：现有列的名称。
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "EXPONENT",
        "Parameters": {
            "sourceColumn": "age",
            "targetColumn": "age_EXPONENT"
        }
    }
}
```

# FLOOR
<a name="recipe-actions.functions.FLOOR"></a>

在新列中返回大于或等于输入数字的最大整数。

**参数**
+ `sourceColumn1`：现有列的名称。
+ `value`：数值。
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "FLOOR",
        "Parameters": {
            "targetColumn": "FLOOR Column 1",
            "value": "42"
        }
    }
}
```

# IS\$1EVEN
<a name="recipe-actions.functions.ISEVEN"></a>

在新列中返回布尔值，用于指示源列或值是否为偶数。如果源列或值为十进制，则结果为 false。

**参数**
+ `sourceColumn`：现有列的名称。
+ `targetColumn`：要创建的新列的名称。
+ `trueString`：指示值是否为偶数的字符串。
+ `falseString`：指示值是否*不*为偶数的字符串。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "IS_EVEN",
        "Parameters": {
            "falseString": "Value is odd",
            "sourceColumn": "height_cm",
            "targetColumn": "height_cm_IS_EVEN",
            "trueString": "Value is even"
        }
    }
}
```

# IS\$1ODD
<a name="recipe-actions.functions.ISODD"></a>

在新列中返回布尔值，用于指示源列或值是否为奇数。如果源列或值为十进制，则结果为 false。

**参数**
+ `sourceColumn`：现有列的名称。
+ `targetColumn`：要创建的新列的名称。
+ `trueString`：指示值是否为奇数的字符串。
+ `falseString`：指示值是否*不*为奇数的字符串。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "IS_ODD",
        "Parameters": {
            "falseString": "Value is even",
            "sourceColumn": "weight_kg",
            "targetColumn": "weight_kg_IS_ODD",
            "trueString": "Value is odd"
        }
    }
}
```

# LN
<a name="recipe-actions.functions.LN"></a>

在新列中返回值的自然对数（欧拉数）。

**参数**
+ `sourceColumn`：现有列的名称。
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "LN",
        "Parameters": {
            "sourceColumn": "weight_kg",
            "targetColumn": "weight_kg_LN"
        }
    }
}
```

# LOG
<a name="recipe-actions.functions.LOG"></a>

在新列中返回值的对数。

**参数**
+ `sourceColumn`：现有列的名称。
+ `targetColumn`：要创建的新列的名称。
+ `base`：对数的底。默认值为 10。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "LOG",
        "Parameters": {
            "base": "10",
            "sourceColumn": "age",
            "targetColumn": "age_LOG"
        }
    }
}
```

# MOD
<a name="recipe-actions.functions.MOD"></a>

在新列中返回一个数字相对于另一个数字的百分比。

**参数**
+ `sourceColumn1`：现有列的名称。
+ `sourceColumn2`：现有列的名称。
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "MOD",
        "Parameters": {
            "sourceColumn1": "start_date",
            "sourceColumn2": "end_date",
            "targetColumn": "MOD Column 1"
        }
    }
}
```

# MULTIPLY
<a name="recipe-actions.functions.MULTIPLY"></a>

将两个数字相乘并在新列中返回结果。

**参数**
+ `sourceColumn1`：现有列的名称。
+ `value1`：数值。
+ `sourceColumn2`：现有列的名称。
+ `value2`：数值。
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "MULTIPLY",
        "Parameters": {
            "sourceColumn1": "hourly_rate",
            "sourceColumn2": "hours",
            "targetColumn": "total_pay"
        }
    }
}
```

# NEGATE
<a name="recipe-actions.functions.NEGATE"></a>

对一个值取反并在新列中返回结果。

**参数**
+ `sourceColumn`：现有列的名称。
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "NEGATE",
        "Parameters": {
            "sourceColumn": "age",
            "targetColumn": "age_NEGATE"
        }
    }
}
```

# PI
<a name="recipe-actions.functions.PI"></a>

在新列中返回 pi 的值（3.141592653589793）。

**参数**
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "PI",
        "Parameters": {
            "targetColumn": "PI Column 1"
        }
    }
}
```

# POWER
<a name="recipe-actions.functions.POWER"></a>

在新列中返回一个数字的指数次幂的值。

**参数**
+ `sourceColumn`：现有列的名称。
+ `value`：要求其幂值的数字。
+ `targetColumn`：要创建的新列的名称。
+ `exponent`：将求值的幂次。

**注意**  
您可以指定 `sourceColumn` 或 `value`，但不能同时指定两者。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "POWER",
        "Parameters": {
            "exponent": "3",
            "sourceColumn": "age",
            "targetColumn": "age_cubed"
        }
    }
}
```

# RADIANS
<a name="recipe-actions.functions.RADIANS"></a>

将度数转换为弧度（除以 180/pi），并在新列中返回值。

**参数**
+ `sourceColumn`：现有列的名称。
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "RADIANS",
        "Parameters": {
            "sourceColumn": "weight_kg",
            "targetColumn": "weight_kg_RADIANS"
        }
    }
}
```

# RANDOM
<a name="recipe-actions.functions.RANDOM"></a>

在新列中返回 0 和 1 之间的随机数。

**参数**
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "RANDOM",
        "Parameters": {
            "targetColumn": "RANDOM Column 1"
        }
    }
}
```

# RANDOM\$1BETWEEN
<a name="recipe-actions.functions.RANDOM_BETWEEN"></a>

在新列中，返回一个介于指定下限（含）和指定上限（含）之间的随机数。

**参数**
+ `lowerBound`：随机数范围的下限。
+ `upperBound`：随机数范围的上限。
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "RANDOM_BETWEEN",
        "Parameters": {
            "lowerBound": "1",
            "targetColumn": "RANDOM_BETWEEN Column 1",
            "upperBound": "100"
        }
    }
}
```

# ROUND
<a name="recipe-actions.functions.ROUND"></a>

在新列中将数值四舍五入到最接近的整数。当小数部分等于或大于 0.5 时，向上舍入。

**参数**
+ `sourceColumn`：现有列的名称。
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "ROUND",
        "Parameters": {
            "sourceColumn": "rating",
            "targetColumn": "rating_ROUND"
        }
    }
}
```

# SIGN
<a name="recipe-actions.functions.SIGN"></a>

返回一个新列，在值小于 0 时返回 -1；在值为 0 时返回 0；在值大于 0 时返回 \$11。

**参数**
+ `sourceColumn`：现有列的名称。
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "SIGN",
        "Parameters": {
            "sourceColumn": "age",
            "targetColumn": "age_SIGN"
        }
    }
}
```

# SQUARE\$1ROOT
<a name="recipe-actions.functions.SQUARE_ROOT"></a>

在新列中返回值的平方根。

**参数**
+ `sourceColumn`：现有列的名称。
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "SQUARE_ROOT",
        "Parameters": {
            "sourceColumn": "age",
            "targetColumn": "age_SQUARE_ROOT"
        }
    }
}
```

# SUBTRACT
<a name="recipe-actions.functions.SUBTRACT"></a>

从一个数字中减去另一个数字，然后在新列中返回结果。

**参数**
+ `sourceColumn1`：现有列的名称。
+ `value1`：数值。
+ `sourceColumn2`：现有列的名称。
+ `value2`：数值。
+ `targetColumn`：要创建的新列的名称。

**Example 示例**  
  

```
{
    "RecipeAction": {
        "Operation": "SUBTRACT",
        "Parameters": {
            "sourceColumn1": "weight_kg",
            "targetColumn": "weight_minus_10_kg",
            "value2": "10"
        }
    }
}
```