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
| Property | Description |
|---|---|
labelstring | Visible label. |
descriptionstring | Helper text. |
requiredboolean default: false | Marks the field required. |
readOnlyboolean default: false | Disables editing. |
Type-specific properties
| Property | Description |
|---|---|
defaultValuestring | 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
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.