Logo
Support
Articles in this section
See more
Articles in this section ▾
Guide to the basic field types
Customizing the field type
The primary field
Adding a field
Adding a field description
The summary bar
Collaborator field type
Duration field type
Duplicating a column to a new table
Changing the number of frozen fields (columns)
See more

Duration field type

The duration field type is a numeric field type intended for use with time durations measured in hours, minutes, seconds, or milliseconds. (If you want to store a time duration measured in days, weeks, or other larger units, use a regular number field.)

Screen_Shot_2018-02-21_at_1.57.48_PM.png

There are five formatting options available for duration fields.

  • h:mm - for hours and minutes, e.g. 1:23
  • h:mm:ss - for minutes and seconds, e.g. 3:45, or hours, minutes, and seconds, such as 1:23:40
  • h:mm:ss.s - for minutes, seconds, and deciseconds, e.g. 3:45.6, or hours, minutes, seconds, and deciseconds, such as 1:23:40.0
  • h:mm:ss.ss - for minutes, seconds, and centiseconds, e.g. 3:45.67, or hours, minutes, seconds, and centiseconds, such as 1:23:40.00
  • h:mm:ss.sss - for minutes, seconds, and milliseconds, e.g. 3:45.678, or hours, minutes, seconds, and milliseconds, such as 1:23:40.000

 

Durations in computed fields

You can also format numeric formulas, lookups, or rollup fields as a duration—for example, multiplying a duration by a number, or rolling up the sum of a duration field from linked records. To format as a duration in a computed field, go to the field customization menu, click the Formatting tab, and select Duration from the Format dropdown. Once you do that, you can choose the specific Duration Format, e.g. h:mm:ss.ss.

Screen_Shot_2018-02-21_at_12_50_31_PM.png

 

Screen_Shot_2018-02-21_at_12.33.27_PM.png

 

Durations and date formulas

You can use simple math operators (like + for addition, - for subtraction, and so on) with durations. You can use a formula like {End Time} - {Start time} to compare durations.

You can also use durations with specific date/time formulas.

For example, you can use the DATETIME_DIFF() function to calculate the duration between two date fields with times and format the result as a duration. If you do this, do not specify a unit as the third parameter, e.g., use DATETIME_DIFF({End Date}, {Start Date}), not DATETIME_DIFF({End Date}, {Start Date}, 'minutes'). Then, be sure to click the Formatting tab in the field customization menu and select Duration from the Format dropdown.

You can also incorporate a duration field into a DATEADD() formula, for example, if you're trying to shift a time earlier or later with a formula. If you do this, please be sure to always provide 'seconds' as the DATEADD() unit, e.g. DATEADD({Date field}, {Duration field}, 'seconds').

Related articles