Date and Time Fundamentals

Working with dates and times is a common requirement in web applications. Booking systems, event calendars, task managers, scheduling tools - they all need reliable date and time input.

Trongate gives you everything you need with native HTML5 inputs and zero JavaScript.

The Trongate Approach

No custom date pickers. No JavaScript libraries. No complicated configuration.

Just native HTML5 date and time inputs that work everywhere - and framework helpers that make them easy to use.

Why Native HTML5 Inputs?

HTML5 introduced native date and time input types that browsers render with built-in, accessible UI components. Here's why they're the best choice:

• Zero JavaScript required - the browser handles everything
• Universal browser support - all modern browsers (Chrome, Firefox, Safari, Edge) fully support these inputs
• Mobile-optimized - native mobile keyboards and pickers appear automatically
• Accessible by default - screen readers and keyboard navigation work out of the box
• Respects user preferences - dates display in the user's locale format automatically
• Lightweight - no external libraries or CSS frameworks needed
• Consistent data format - always submits in ISO 8601 format regardless of display

The ISO 8601 Standard

All HTML5 date and time inputs use the ISO 8601 international standard for data interchange. This is crucial for building language-agnostic applications.

What Trongate Provides

Trongate gives you simple helpers for every HTML5 date and time input type:

• form_date() - calendar date picker
• form_time() - time selector
• form_datetime_local() - combined date and time picker
• form_month() - month and year selector
• form_week() - week selector

Plus validation rules that work seamlessly with ISO 8601 formats:

• valid_date - validates YYYY-MM-DD format
• valid_time - validates HH:MM or HH:MM:SS format
• valid_datetime_local - validates YYYY-MM-DDTHH:MM format
• valid_month - validates YYYY-MM format
• valid_week - validates YYYY-W## format

A Simple Example

Here's a complete working form with date and time inputs:

And the view file:

That's it. Clean, simple, and it works everywhere.

Database Storage Strategy

ISO 8601 formats map perfectly to standard SQL date and time types:

Language-Agnostic Design

Trongate's approach to dates and times is intentionally language-agnostic:

• Store in ISO 8601 - universal standard understood everywhere
• Database uses standard SQL types - DATE, TIME, DATETIME work in any database
• Display format is separate - use PHP's DateTime and IntlDateFormatter for locale-specific display
• Validation checks format - not locale-specific date rules

Example: Multi-Language Date Display

The key principle: store universally, display locally.

Browser Support

All modern browsers fully support HTML5 date and time inputs:

Timezone Considerations

The datetime-local input type intentionally does not include timezone information. This is by design:

• It represents a date and time "as displayed on a calendar and wall clock" in the user's local timezone
• Perfect for scheduling appointments, setting deadlines, booking reservations
• The server receives the time exactly as the user entered it

What's Next

The following pages will show you:

• How to use each date and time input helper function
• How to validate date and time data with built-in rules
• How to handle date ranges and custom validation
• How to store dates and times in your database
• How to format dates and times for display in any language
• How to work with the create/update pattern for date fields

Why This Beats Custom Date Pickers