Datetime picker element

Welcome to the new home of Slack developer docs!

We're still building and not all features are available quite yet. Enjoy this peek into the future!

Not ready for the future? Return to the past at api.slack.com.

Example:

Fields

Fields	Type	Description	Required?
type	String	The type of element. In this case type is always datetimepicker.	Required
action_id	String	An identifier for the input value when the parent modal is submitted. You can use this when you receive a view_submission payload to identify the value of the input element. Should be unique among all other action_ids in the containing block. Maximum length is 255 characters.	Optional
initial_date_time	Integer	The initial date and time that is selected when the element is loaded, represented as a UNIX timestamp in seconds. This should be in the format of 10 digits, for example 1628633820 represents the date and time August 10th, 2021 at 03:17pm PST.	Optional
confirm	Object	A confirm object that defines an optional confirmation dialog that appears after a time is selected.	Optional
focus_on_load	Boolean	Indicates whether the element will be set to auto focus within the view object. Only one element can be set to true. Defaults to false.	Optional

Usage Info

Interactive component - see our guide to enabling interactivity.

On desktop clients, the time picker will take the form of a dropdown list and the date picker will take the form of a dropdown calendar. Both options will have free-text entry for precise choices. On mobile clients, the time picker and date picker will use native UIs.

Example

An input block containing a datetime picker element:

{
  "type": "input",
  "element": {
    "type": "datetimepicker",
    "action_id": "datetimepicker-action"
  },
  "hint": {
    "type": "plain_text",
    "text": "This is some hint text",
    "emoji": true
  },
  "label": {
    "type": "plain_text",
    "text": "Start date",
    "emoji": true
  }
}