#Duration Fieldtype Documentation

#Configuration

#How It Works

#Fieldtype lifecycle methods

This fieldtype uses the standard Statamic fieldtype lifecycle and maps each method to a specific responsibility:

• preload()
  • provides metadata to the Vue component: the configured maxHours cap and the fixed maxMinutes cap
• preProcess($value)
  • converts stored milliseconds to a zero-padded hh:mm string for the CP edit form
• process($value)
  • parses the masked hh:mm or canonical hhmm digit input from the Vue component and converts it to an integer number of milliseconds for storage
• preProcessIndex($value)
  • converts stored milliseconds to hh:mm for display in Control Panel index listings
• augment($value)
  • converts stored milliseconds to plain hh:mm, or a human-readable string once all four unit labels are configured, for Antlers template output

#Storage

Values are stored as plain integers representing the duration in milliseconds. A value entered as 01:30 is saved as 5400000. Empty input is normalized to 0 on save.

#Display

By default, augmenting a stored value produces the same plain hh:mm string shown in the Control Panel:

{{ input_name }}
{{# Output: 01:30 #}}

Once all four Hour/Minute Label settings are configured, it instead produces a human-readable string, omitting whichever segment is zero:

{{ input_name }}
{{# Output: 01 hr 30 mins #}}

Strip Leading Zero drops the 0 from single-digit numbers in that human-readable output (1 hr 30 mins).

#Input masking and editing

The CP field renders a masked text input using Maska. Typing a digit overwrites whichever slot (hours/minutes, tens/ones) the caret sits at and advances to the next, like a segmented date/time input, rather than re-deriving the value from the last 4 digits typed anywhere in the field. The ↑/↓ arrow keys similarly step whichever digit the caret sits immediately after. A value typed or stepped past the field's bounds is clamped rather than accepted as-is.

Pasting replaces the field's entire value: non-digit characters are stripped, only the last 4 digits are read, and the result is clamped the same way typed input is.

#Value bounds

#Null and empty handling

preProcess and preProcessIndex handle null by returning 00:00. augment returns 00:00 (or 00 mins, once labels are configured) for null or zero values.