Format a duration into a human readable string.
Name | Type | Required | Default | Description |
---|---|---|---|---|
field | string | Yes | The name of the input field. | |
as | string | No | The output name of the field to set (defaults to the same as the input field). | |
from | string | No | Magnitude of the input field. Accepted values: ns, us, ms, s, m, h, d. Defaults to ms | |
precision | number | No | Number of units to use in the output. If zero (default), all units are used. |
field
is the unnamed parameter.
Formats a duration into a string. An input event with the field duration with the value 23452553 results in the field duration having the value 6h30m52s553ms.
formatDuration(duration)
Formats a duration into a string with limited precision. An input event with the field duration with the value 23452553 results in the field duration having the value 6h30m52s.
formatDuration(duration, precision=3)