Skip to main content

Datetime

Datetime metadata stores a calendar date and time together. Studio SDK responses return datetime values as YYYY-MM-DD HH:mm:ss.

Use datetime handling when the business value represents an exact event time, deadline, handoff time, completion time, or automation trigger time.

Value Shape​

type DatetimeMetadataValue = string | null;

Write values with a full timestamp string:

await context.form.update({
  recordId: record.id,
  data: {
    submitted_at: '2026-06-18 10:30:00',
  },
});

Common Uses​

UseExamples
DeadlineSubmit before, expire at
Event momentAppointment time, arrival time
Process timestampHandoff time, completion time
AutomationTrigger time, reminder time