Date Time Item object representation

The datetimeitem object representation and fields are described below.

datetimeitem was introduced in API version V1

datetimeitem has not been marked for deprecation

Usages

Description

Date time represented as ISO 8601 with milliseconds

Example create representation

{
  "entity" : {
    "urn" : "4fdf15cf-cfa3-4b43-9e92-57dfbbc0366d",
    "url" : "/n/v1/entity/4fdf15cf-cfa3-4b43-9e92-57dfbbc0366d",
    "texts" : [ ],
    "doubles" : [ ],
    "dateTimes" : [ ],
    "booleans" : [ ],
    "images" : [ ],
    "templates" : [ ],
    "markdowns" : [ ],
    "latLongs" : [ ],
    "longs" : [ ]
  },
  "name" : "birthday",
  "sortOrder" : 0,
  "value" : "2025-07-14T09:00:00.000"
}

Example response representation

{
  "urn" : "5841a247-9ecc-4f15-921a-7c1a2573cb2b",
  "url" : "/n/v1/datetimeitem/5841a247-9ecc-4f15-921a-7c1a2573cb2b",
  "entity" : {
    "urn" : "4fdf15cf-cfa3-4b43-9e92-57dfbbc0366d",
    "url" : "/n/v1/entity/4fdf15cf-cfa3-4b43-9e92-57dfbbc0366d",
    "texts" : [ ],
    "doubles" : [ ],
    "dateTimes" : [ ],
    "booleans" : [ ],
    "images" : [ ],
    "templates" : [ ],
    "markdowns" : [ ],
    "latLongs" : [ ],
    "longs" : [ ]
  },
  "name" : "birthday",
  "sortOrder" : 0,
  "value" : "2025-07-14T09:00:00.000"
}

Fields

NameTypeDescriptionConstraints
urnString representation of a Unique Resource Name. Typically a UUID with 36 characters.Minimum length: 36. Maximum length: 36.
urlURL represented as a string
entityentityThe entity associated with this date time itemRequired on create.
nameField name, typically used in content items. Typically use conventions around html ID expectations.Name for the field e.g. meta_title. Fields can be arbitrary. Suggest using JS like field namesRequired on create. Maximum length: 1024.
sortOrderSigned int32Field sorting order for field orderingRequired on create.
valueString literalA date time value expressed in UTC formatted as ISO 8601 date time with millisecondsRequired on create.