Time field

A time-only picker, hours, minutes, optional seconds. Stored as a string in SharePoint.

The Time field captures a time-of-day value without a date, opening hours, shift start, meeting time. Renders an HH:MM picker; optionally HH:MM:SS.

Binds to a SharePoint Text column (SP has no time-only column type). The value is stored in 24-hour ISO format ("14:30") regardless of the user's locale display.

Common properties

PropertyDescription
label
string
Visible label.
description
string
Helper text.
required
boolean
default: false
Marks the field required.
readOnly
boolean
default: false
Disables editing.

Type-specific properties

PropertyDescription
defaultValue
string
Pre-fills the field on form load, e.g. "09:00" (24-hour HH:MM).

JavaScript recipes

Read the value

// 24-hour string, e.g. "14:30", or "" when empty.
const start = f365.field('StartTime').value as string;

Default to the current time on a blank form

f365.events.onLoad(() => {
  if (!f365.field('StartTime').value) {
    const now = new Date();
    const hh = String(now.getHours()).padStart(2, '0');
    const mm = String(now.getMinutes()).padStart(2, '0');
    f365.field('StartTime').value = `${hh}:${mm}`;
  }
});

Warn when end is before start

f365.events.onChange((e) => {
  if (e.fieldKey !== 'StartTime' && e.fieldKey !== 'EndTime') return;
  const start = f365.field('StartTime').value as string;
  const end = f365.field('EndTime').value as string;
  if (start && end && end < start) {
    f365.ui.showToast('End time is before start time.', 'error');
  }
});

Format for display in a custom element

const t = f365.field('StartTime').value as string; // "14:30"
const [h, m] = t.split(':').map(Number);
const label = f365.format.date(new Date(2000, 0, 1, h, m), {
  hour: 'numeric',
  minute: '2-digit',
});

Related articles

  • Date field

    Date picker with calendar UI, configurable min/max range, locale-aware formatting, and optional time component.

  • DateTime field

    Combined date + time picker. Stores a full ISO 8601 timestamp in SharePoint.