Date

Date metadata stores calendar-style values and date-related period values. Studio SDK responses return date values as YYYY-MM-DD.

Use date handling for due dates, business dates, report periods, and date-only comparisons.

Value Shape

type DateMetadataValue = string | null;

Use ISO-like date strings when writing records:

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

Common Uses

Use	Examples
Calendar date	Due date, start date, delivery date
Period	Week, month, quarter, year
Time of day	Start time, cutoff time
Planning	Schedule window, reporting period