Date & DateTime

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:

The business information settings pane in Kizen

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