Merge pull request #1298 from influxdata/flux-0.80

Flux 0.80
pull/1302/head
Scott Anderson 2020-08-12 13:34:36 -06:00 committed by GitHub
commit 02257e34e6
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
20 changed files with 47 additions and 170 deletions

View File

@ -58,18 +58,21 @@ Results **include** points that match the specified start time.
Use a relative duration or absolute time. Use a relative duration or absolute time.
For example, `-1h` or `2019-08-28T22:00:00Z`. For example, `-1h` or `2019-08-28T22:00:00Z`.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are nanosecond Unix timestamps.
_**Data type:** Duration | Time_ _**Data type:** Duration | Time | Integer_
### stop ### stop
Latest time to include in results. Latest time to include in results.
Results **exclude** points that match the specified stop time. Results **exclude** points that match the specified stop time.
Use a relative duration or absolute time. Use a relative duration or absolute time.
For example, `-1h` or `2019-08-28T22:00:00Z`. For example, `-1h` or `2019-08-28T22:00:00Z`.
Integers are nanosecond Unix timestamps.
Durations are relative to `now()`. Durations are relative to `now()`.
Defaults to `now()`. Defaults to `now()`.
_**Data type:** Duration | Time_ _**Data type:** Duration | Time | Integer_
### m ### m
<span class="req">Required</span> Name of the measurement to query. <span class="req">Required</span> Name of the measurement to query.

View File

@ -31,9 +31,8 @@ date.hour(t: 2019-07-17T12:05:21.012Z)
The time to operate on. The time to operate on.
Use an absolute time, relative duration, or integer. Use an absolute time, relative duration, or integer.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are **nanosecond** [Unix timestamps](/v2.0/reference/glossary/#unix-timestamp).
_**Data type:** Time | Duration | Integer_ _**Data type:** Time | Duration_
## Examples ## Examples
@ -56,12 +55,3 @@ date.hour(t: -8h)
// Returns 4 // Returns 4
``` ```
##### Return the hour of a nanosecond Unix timestamp
```js
import "date"
date.hour(t: 1581423663293534940)
// Returns 12
```

View File

@ -31,9 +31,8 @@ date.microsecond(t: 2019-07-17T12:05:21.012934584Z)
The time to operate on. The time to operate on.
Use an absolute time, relative duration, or integer. Use an absolute time, relative duration, or integer.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are **nanosecond** [Unix timestamps](/v2.0/reference/glossary/#unix-timestamp).
_**Data type:** Time | Duration | Integer_ _**Data type:** Time | Duration_
## Examples ## Examples
@ -56,12 +55,3 @@ date.microsecond(t: -1890us)
// Returns 291644 // Returns 291644
``` ```
##### Return the microsecond of a nanosecond Unix timestamp
```js
import "date"
date.microsecond(t: 1581423663293534940)
// Returns 293534
```

View File

@ -31,9 +31,8 @@ date.millisecond(t: 2019-07-17T12:05:21.012934584Z)
The time to operate on. The time to operate on.
Use an absolute time, relative duration, or integer. Use an absolute time, relative duration, or integer.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are **nanosecond** [Unix timestamps](/v2.0/reference/glossary/#unix-timestamp).
_**Data type:** Time | Duration | Integer_ _**Data type:** Time | Duration_
## Examples ## Examples
@ -56,12 +55,3 @@ date.millisecond(t: -150ms)
// Returns 143 // Returns 143
``` ```
##### Return the millisecond of a nanosecond Unix timestamp
```js
import "date"
date.millisecond(t: 1581423663293534940)
// Returns 293
```

View File

@ -31,9 +31,8 @@ date.minute(t: 2019-07-17T12:05:21.012Z)
The time to operate on. The time to operate on.
Use an absolute time, relative duration, or integer. Use an absolute time, relative duration, or integer.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are **nanosecond** [Unix timestamps](/v2.0/reference/glossary/#unix-timestamp).
_**Data type:** Time | Duration | Integer_ _**Data type:** Time | Duration_
## Examples ## Examples
@ -56,12 +55,3 @@ date.minute(t: -45m)
// Returns 36 // Returns 36
``` ```
##### Return the minute of a nanosecond Unix timestamp
```js
import "date"
date.minute(t: 1581423663293534940)
// Returns 21
```

View File

@ -31,9 +31,8 @@ date.month(t: 2019-07-17T12:05:21.012Z)
The time to operate on. The time to operate on.
Use an absolute time, relative duration, or integer. Use an absolute time, relative duration, or integer.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are **nanosecond** [Unix timestamps](/v2.0/reference/glossary/#unix-timestamp).
_**Data type:** Time | Duration | Integer_ _**Data type:** Time | Duration_
## Examples ## Examples
@ -56,12 +55,3 @@ date.month(t: -3mo)
// Returns 11 // Returns 11
``` ```
##### Return the month of a nanosecond Unix timestamp
```js
import "date"
date.month(t: 1581423663293534940)
// Returns 2
```

View File

@ -31,9 +31,8 @@ date.monthDay(t: 2019-07-17T12:05:21.012Z)
The time to operate on. The time to operate on.
Use an absolute time, relative duration, or integer. Use an absolute time, relative duration, or integer.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are **nanosecond** [Unix timestamps](/v2.0/reference/glossary/#unix-timestamp).
_**Data type:** Time | Duration | Integer_ _**Data type:** Time | Duration_
## Examples ## Examples
@ -56,12 +55,3 @@ date.monthDay(t: -8d)
// Returns 3 // Returns 3
``` ```
##### Return the day of the month for a nanosecond Unix timestamp
```js
import "date"
date.monthDay(t: 1581423663293534940)
// Returns 11
```

View File

@ -31,9 +31,8 @@ date.nanosecond(t: 2019-07-17T12:05:21.012934584Z)
The time to operate on. The time to operate on.
Use an absolute time, relative duration, or integer. Use an absolute time, relative duration, or integer.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are **nanosecond** [Unix timestamps](/v2.0/reference/glossary/#unix-timestamp).
_**Data type:** Time | Duration | Integer_ _**Data type:** Time | Duration_
## Examples ## Examples
@ -56,12 +55,3 @@ date.nanosecond(t: -2111984ns)
// Returns 291422956 // Returns 291422956
``` ```
##### Return the nanosecond for a nanosecond Unix timestamp
```js
import "date"
date.nanosecond(t: 1581423663293534940)
// Returns 293534940Z
```

View File

@ -31,9 +31,8 @@ date.quarter(t: 2019-07-17T12:05:21.012Z)
The time to operate on. The time to operate on.
Use an absolute time, relative duration, or integer. Use an absolute time, relative duration, or integer.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are **nanosecond** [Unix timestamps](/v2.0/reference/glossary/#unix-timestamp).
_**Data type:** Time | Duration | Integer_ _**Data type:** Time | Duration_
## Examples ## Examples
@ -56,12 +55,3 @@ date.quarter(t: -7mo)
// Returns 3 // Returns 3
``` ```
##### Return the quarter for a nanosecond Unix timestamp
```js
import "date"
date.quarter(t: 1581423663293534940)
// Returns 1
```

View File

@ -31,9 +31,8 @@ date.second(t: 2019-07-17T12:05:21.012Z)
The time to operate on. The time to operate on.
Use an absolute time, relative duration, or integer. Use an absolute time, relative duration, or integer.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are **nanosecond** [Unix timestamps](/v2.0/reference/glossary/#unix-timestamp).
_**Data type:** Time | Duration | Integer_ _**Data type:** Time | Duration_
## Examples ## Examples
@ -56,12 +55,3 @@ date.second(t: -50s)
// Returns 13 // Returns 13
``` ```
##### Return the second of a nanosecond Unix timestamp
```js
import "date"
date.second(t: 1581423663293534940)
// Returns 3
```

View File

@ -32,9 +32,8 @@ date.truncate(
The time to operate on. The time to operate on.
Use an absolute time, relative duration, or integer. Use an absolute time, relative duration, or integer.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are **nanosecond** [Unix timestamps](/v2.0/reference/glossary/#unix-timestamp).
_**Data type:** Time | Duration | Integer_ _**Data type:** Time | Duration_
### unit ### unit
The unit of time to truncate to. The unit of time to truncate to.
@ -77,17 +76,3 @@ date.truncate(t: -1m, unit: 1m)
date.truncate(t: -1h, unit: 1h) date.truncate(t: -1h, unit: 1h)
// Returns 2019-12-31T23:00:00.000000000Z // Returns 2019-12-31T23:00:00.000000000Z
``` ```
##### Truncate time values using nanosecond Unix timestamps
```js
import "date"
date.truncate(t: 1559570341000000000, unit: 1s)
// Returns 2019-06-03T13:59:01.000000000Z
date.truncate(t: 1559570341000000000, unit: 1m)
// Returns 2019-06-03T13:59:00.000000000Z
date.truncate(t: 1559570341000000000, unit: 1h)
// Returns 2019-06-03T13:00:00.000000000Z
```

View File

@ -31,9 +31,8 @@ date.week(t: 2019-07-17T12:05:21.012Z)
The time to operate on. The time to operate on.
Use an absolute time, relative duration, or integer. Use an absolute time, relative duration, or integer.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are **nanosecond** [Unix timestamps](/v2.0/reference/glossary/#unix-timestamp).
_**Data type:** Time | Duration | Integer_ _**Data type:** Time | Duration_
## Examples ## Examples
@ -56,12 +55,3 @@ date.week(t: -12d)
// Returns 5 // Returns 5
``` ```
##### Return the week of the year using a nanosecond Unix timestamp
```js
import "date"
date.week(t: 1581423663293534940)
// Returns 7
```

View File

@ -31,9 +31,8 @@ date.weekDay(t: 2019-07-17T12:05:21.012Z)
The time to operate on. The time to operate on.
Use an absolute time, relative duration, or integer. Use an absolute time, relative duration, or integer.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are **nanosecond** [Unix timestamps](/v2.0/reference/glossary/#unix-timestamp).
_**Data type:** Time | Duration | Integer_ _**Data type:** Time | Duration_
## Examples ## Examples
@ -56,12 +55,3 @@ date.weekDay(t: -84h)
// Returns 6 // Returns 6
``` ```
##### Return the day of the week for a nanosecond Unix timestamp
```js
import "date"
date.weekDay(t: 1581423663293534940)
// Returns 2
```

View File

@ -29,9 +29,8 @@ date.year(t: 2019-07-17T12:05:21.012Z)
The time to operate on. The time to operate on.
Use an absolute time, relative duration, or integer. Use an absolute time, relative duration, or integer.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are **nanosecond** [Unix timestamps](/v2.0/reference/glossary/#unix-timestamp).
_**Data type:** Time | Duration | Integer_ _**Data type:** Time | Duration_
## Examples ## Examples
@ -54,12 +53,3 @@ date.year(t: -14y)
// Returns 2006 // Returns 2006
``` ```
##### Return the year for a nanosecond Unix timestamp
```js
import "date"
date.year(t: 1581423663293534940)
// Returns 2020
```

View File

@ -31,9 +31,8 @@ date.yearDay(t: 2019-07-17T12:05:21.012Z)
The time to operate on. The time to operate on.
Use an absolute time, relative duration, or integer. Use an absolute time, relative duration, or integer.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are **nanosecond** [Unix timestamps](/v2.0/reference/glossary/#unix-timestamp).
_**Data type:** Time | Duration | Integer_ _**Data type:** Time | Duration_
## Examples ## Examples
@ -56,12 +55,3 @@ date.yearDay(t: -1mo)
// Returns 11 // Returns 11
``` ```
##### Return the day of the year for a nanosecond Unix timestamp
```js
import "date"
date.yearDay(t: 1581423663293534940)
// Returns 42
```

View File

@ -38,8 +38,9 @@ Results **include** points that match the specified start time.
Use a relative duration or absolute time. Use a relative duration or absolute time.
For example, `-1h` or `2019-08-28T22:00:00Z`. For example, `-1h` or `2019-08-28T22:00:00Z`.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are nanosecond Unix timestamps.
_**Data type:** Duration | Time_ _**Data type:** Duration | Time | Integer_
### stop ### stop
The latest time to include in results. The latest time to include in results.
@ -47,9 +48,10 @@ Results **exclude** points that match the specified stop time.
Use a relative duration or absolute time. Use a relative duration or absolute time.
For example, `-1h` or `2019-08-28T22:00:00Z`. For example, `-1h` or `2019-08-28T22:00:00Z`.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are nanosecond Unix timestamps.
Defaults to `now()`. Defaults to `now()`.
_**Data type:** Duration | Time_ _**Data type:** Duration | Time | Integer_
## Examples ## Examples

View File

@ -41,8 +41,9 @@ Results **include** points that match the specified start time.
Use a relative duration or absolute time. Use a relative duration or absolute time.
For example, `-1h` or `2019-08-28T22:00:00Z`. For example, `-1h` or `2019-08-28T22:00:00Z`.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are nanosecond Unix timestamps.
_**Data type:** Duration | Time_ _**Data type:** Duration | Time | Integer_
### stop ### stop
The latest time to include in results. The latest time to include in results.
@ -50,9 +51,10 @@ Results **exclude** points that match the specified stop time.
Use a relative duration or absolute time. Use a relative duration or absolute time.
For example, `-1h` or `2019-08-28T22:00:00Z`. For example, `-1h` or `2019-08-28T22:00:00Z`.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are nanosecond Unix timestamps.
Defaults to `now()`. Defaults to `now()`.
_**Data type:** Duration | Time_ _**Data type:** Duration | Time | Integer_
### measurement ### measurement
The name of the measurement to filter by. The name of the measurement to filter by.

View File

@ -35,17 +35,19 @@ The earliest time to include in results.
Use a relative duration or absolute time. Use a relative duration or absolute time.
For example, `-1h` or `2019-08-28T22:00:00Z`. For example, `-1h` or `2019-08-28T22:00:00Z`.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are nanosecond Unix timestamps.
_**Data type:** Duration | Time_ _**Data type:** Duration | Time | Integer_
### stop ### stop
The latest time to include in results. The latest time to include in results.
Use a relative duration or absolute time. Use a relative duration or absolute time.
For example, `-1h` or `2019-08-28T22:00:00Z`. For example, `-1h` or `2019-08-28T22:00:00Z`.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are nanosecond Unix timestamps.
Defaults to `now()`. Defaults to `now()`.
_**Data type:** Duration | Time_ _**Data type:** Duration | Time | Integer_
{{% note %}} {{% note %}}
Time values in Flux must be in [RFC3339 format](/v2.0/reference/flux/language/types#timestamp-format). Time values in Flux must be in [RFC3339 format](/v2.0/reference/flux/language/types#timestamp-format).

View File

@ -34,17 +34,19 @@ The earliest time to include in results.
Use a relative duration or absolute time. Use a relative duration or absolute time.
For example, `-1h` or `2019-08-28T22:00:00Z`. For example, `-1h` or `2019-08-28T22:00:00Z`.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are nanosecond Unix timestamps.
_**Data type:** Duration | Time_ _**Data type:** Duration | Time | Integer_
### stop ### stop
The latest time to include in results. The latest time to include in results.
Use a relative duration or absolute time. Use a relative duration or absolute time.
For example, `-1h` or `2019-08-28T22:00:00Z`. For example, `-1h` or `2019-08-28T22:00:00Z`.
Durations are relative to `now()`. Durations are relative to `now()`.
Integers are nanosecond Unix timestamps.
Defaults to `now()`. Defaults to `now()`.
_**Data type:** Duration | Time_ _**Data type:** Duration | Time | Integer_
{{% note %}} {{% note %}}
Time values in Flux must be in [RFC3339 format](/v2.0/reference/flux/language/types#timestamp-format). Time values in Flux must be in [RFC3339 format](/v2.0/reference/flux/language/types#timestamp-format).

View File

@ -11,11 +11,22 @@ aliases:
--- ---
{{% note %}} {{% note %}}
The latest release of InfluxDB v2.0 beta includes **Flux v0.71.1**. The latest release of InfluxDB v2.0 beta includes **Flux v0.77.1**.
Though newer versions of Flux may be available, they will not be included with Though newer versions of Flux may be available, they will not be included with
InfluxDB until the next InfluxDB v2.0 release._ InfluxDB until the next InfluxDB v2.0 release._
{{% /note %}} {{% /note %}}
## v0.80.0 [2020-08-12]
### Features
- Add `nulls` parameter to `gen.tables()`.
### Bug fixes
- Revert the timeable constraint for integer.
- Make socket/sql URL test robust.
---
## v0.79.0 [2020-08-11] ## v0.79.0 [2020-08-11]
### Features ### Features