docs-v2/content/flux/v0.x/stdlib/universe/min.md

74 lines
1.8 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters!

This file contains invisible Unicode characters that may be processed differently from what appears below. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to reveal hidden characters.

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

---
title: min() function
description: The `min()` function selects record with the lowest _value from the input table.
aliases:
- /influxdb/v2.0/reference/flux/functions/transformations/selectors/min
- /influxdb/v2.0/reference/flux/functions/built-in/transformations/selectors/min/
- /influxdb/v2.0/reference/flux/stdlib/built-in/transformations/selectors/min/
- /influxdb/cloud/reference/flux/stdlib/built-in/transformations/selectors/min/
menu:
flux_0_x_ref:
name: min
parent: universe
weight: 102
flux/v0.x/tags: [selectors, transformations]
related:
- /{{< latest "influxdb" "v1" >}}/query_language/functions/#min, InfluxQL  MIN()
introduced: 0.7.0
---
The `min()` function selects record with the lowest `_value` from the input table.
_`min()` is a [selector function](/flux/v0.x/function-types/#selectors)._
```js
min(column: "_value")
```
{{% warn %}}
#### Empty tables
`min()` drops empty tables.
{{% /warn %}}
## Parameters
### column {data-type="string"}
The column to use to calculate the minimum value.
Default is `"_value"`.
### tables {data-type="stream of tables"}
Input data.
Default is piped-forward data ([`<-`](/flux/v0.x/spec/expressions/#pipe-expressions)).
## Examples
{{% flux/sample-example-intro %}}
```js
import "sampledata"
sampledata.int()
|> min()
```
{{% expand "View input and output" %}}
{{< flex >}}
{{% flex-content %}}
##### Input data
{{% flux/sample "int" %}}
{{% /flex-content %}}
{{% flex-content %}}
##### Output data
| _time | tag | _value |
| :------------------- | :-- | -----: |
| 2021-01-01T00:00:00Z | t1 | -2 |
| _time | tag | _value |
| :------------------- | :-- | -----: |
| 2021-01-01T00:00:20Z | t2 | -3 |
{{% /flex-content %}}
{{< /flex >}}
{{% /expand %}}