Date & DateTime
Audience: Admins, Developers, Solution Architects
Purpose: Explains how Date and DateTime fields work in Kizen, including business time zone behavior and the required ISO 8601 formats for API updates.
Overview
Kizen supports both a Date and DateTime field. It’s important to understand how this type field works, especially when dealing with timezones.
Each business has a “business time zone” that controls how dates are displayed. This can be viewed and configured from the business information settings page:

Date and DateTime information is stored using the configured business time zone.
Updating Date Fields
When updating a date field, the value should be passed to the API in the ISO 8601 format (“YYYY-MM-DD”). For example: 2024-10-09.
Updating DateTime Fields
When updating a datetime field, the value should be passed to the API in the ISO 8601 format, in UTC time. For example: 2024-10-09T05:00:00Z. The API also accepts datetime values in a different timezone: 2024-10-09T05:00:00-0500
What's Next
In the next section, Numbers, you’ll learn how Kizen supports numeric fields such as integers, decimals, and currency, and how currency options are defined for numeric fields.
Last updated
Was this helpful?