Input Datetime

io.input.datetime() requests a point in time and returns it as a luxon DateTime. Provided by the @awaitio/input-datetime package.

A Trial ends at field with a date and time, and the hint Time zone: Europe/Prague under it

The person picks the date and time in their browser’s time zone, which is shown under the field (Time zone: Europe/Prague). The value is sent to the server in UTC, so the handler gets the same instant whatever time zone the person is in.

Install

npm install @awaitio/input-datetime

Setup

app.ts

import { inputDatetime } from '@awaitio/input-datetime';

export const app = new AwaitIO({
  // name, actionsDirectory, theme, secret, users…
  components: { input: { datetime: inputDatetime } },
});

Usage

import { DateTime } from 'luxon';

const endsAt = await io.input.datetime('Trial ends at', {
  defaultValue: DateTime.now().plus({ days: 14 }).startOf('day'),
  min: DateTime.now(),
});

Props

Prop	Type	Required	Description
`helpText`	`string`	Optional	Secondary text under the field.
`defaultValue`	`DateTime \| Date \| string`	Optional	The value the field starts with. Empty when left out.
`min`	`DateTime \| Date \| string`	Optional	The earliest time that can be picked.
`max`	`DateTime \| Date \| string`	Optional	The latest time that can be picked.
`disabled`	`boolean`	Optional	Shows the starting value without letting it change; the handler gets that value whatever the browser sends.

defaultValue, min and max take a luxon DateTime, a JavaScript Date or an ISO 8601 string. An impossible date such as 2026-02-30 throws when the io call is made.

Optional

The field is required. Chain .optional() to let it stay empty; the handler then gets DateTime | undefined, see Optional fields.

const remindAt = await io.input.datetime('Remind me at').optional();

Returns

A luxon DateTime in the UTC zone. Convert it with .setZone(...) when you need local time, or .toISO() to store it.

Built-in validation

The field is always required. The input works in whole minutes, so min and max are compared at minute precision: min: DateTime.now() still accepts the current minute. The server checks every answer:

When	Message
No date and time picked	`<label>: pick a date and time.`
A date that does not exist	`<label>: pick a date and time that exists.`
Earlier than `min`	`<label> must not be earlier than <min>.`
Later than `max`	`<label> must not be later than <max>.`

<min> and <max> are printed in UTC.

Custom validation

Chain .validate() for a check of your own. It runs on the server after the checks above, gets the value the handler would get and returns a message to show under the field, or nothing when the value is fine; see Custom validation.

const startsAt = await io.input.datetime('Call starts at').validate((startsAt) => {
  return startsAt.hour >= 9 && startsAt.hour < 17 ? undefined : 'Pick a time between 9 AM and 5 PM.';
});

Getting started

SDK

Components

Display components

Layout components

Context

Install

Setup

Usage

Props

Optional

Returns

Built-in validation

Custom validation

​Install

​Setup

​Usage

​Props

​Optional

​Returns

​Built-in validation

​Custom validation

Install

Setup

Usage

Props

Optional

Returns

Built-in validation

Custom validation