docs-v2/content/v2.0/reference/flux/stdlib/built-in/transformations/truncatetimecolumn.md

title	description	aliases	menu	weight	related
truncateTimeColumn() function	The `truncateTimeColumn()` function truncates all input table `_time` values to a specified unit.	/v2.0/reference/flux/functions/built-in/transformations/truncatetimecolumn/	v2_0_ref name parent truncateTimeColumn built-in-transformations	402	/v2.0/reference/flux/stdlib/date/truncate/

The truncateTimeColumn() function truncates all input table _time values to a specified unit.

Function type: Transformation

truncateTimeColumn(unit: 1s)

Parameters

unit

The unit of time to truncate to.

Data type: Duration

{{% note %}} Only use 1 and the unit of time to specify the unit. For example: 1s, 1m, 1h. {{% /note %}}

Examples

Truncate all time values to seconds

from(bucket:"example-bucket")
  |> range(start:-1h)
  |> truncateTimeColumn(unit: 1s)

Function definition

import "date"

truncateTimeColumn = (unit, tables=<-) =>
  tables
    |> map(fn: (r) => ({
        r with _time: date.truncate(t: r._time, unit:unit)
      })
    )