DatePicker

An input field that allows inputing a date.

Available for Google Workspace add-ons and Google Chat apps.

```javascript
const dateTimePicker =
    CardService.newDatePicker()
        .setTitle('Enter the date.')
        .setFieldName('date_field')
        // Set default value as Jan 1, 2018 UTC. Either a number or string is
        // acceptable.
        .setValueInMsSinceEpoch(1514775600)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );
```

### Methods

| Method | Return type | Brief description |
|---|---|---|
| `https://developers.google.com/apps-script/reference/card-service/date-picker#addEventAction(EventAction)` | `https://developers.google.com/apps-script/reference/card-service/widget` | Adds the event action that can be performed on the widget. |
| `https://developers.google.com/apps-script/reference/card-service/date-picker#setFieldName(String)` | `https://developers.google.com/apps-script/reference/card-service/date-picker#` | Sets the field name that identifies this picker in the event object that is generated when there is a UI interaction. |
| `https://developers.google.com/apps-script/reference/card-service/date-picker#setId(String)` | `https://developers.google.com/apps-script/reference/card-service/widget` | Sets the unique ID assigned that's used to identify the widget to be mutated. |
| `https://developers.google.com/apps-script/reference/card-service/date-picker#setOnChangeAction(Action)` | `https://developers.google.com/apps-script/reference/card-service/date-picker#` | Sets an `https://developers.google.com/apps-script/reference/card-service/action` that the script performs whenever the picker input changes. |
| `https://developers.google.com/apps-script/reference/card-service/date-picker#setTitle(String)` | `https://developers.google.com/apps-script/reference/card-service/date-picker#` | Sets the title displayed above the input field. |
| `https://developers.google.com/apps-script/reference/card-service/date-picker#setValueInMsSinceEpoch(Number)` | `https://developers.google.com/apps-script/reference/card-service/date-picker#` | Sets the prefilled value to be set in the input field. |
| `https://developers.google.com/apps-script/reference/card-service/date-picker#setValueInMsSinceEpoch(String)` | `https://developers.google.com/apps-script/reference/card-service/date-picker#` | Sets the prefilled value to be set in the input field. |
| `https://developers.google.com/apps-script/reference/card-service/date-picker#setVisibility(Visibility)` | `https://developers.google.com/apps-script/reference/card-service/widget` | Sets the visibility of the widget. |

## Detailed documentation

### `addEventAction(eventAction)`

Adds the event action that can be performed on the widget.

#### Parameters

| Name | Type | Description |
|---|---|---|
| `eventAction` | `https://developers.google.com/apps-script/reference/card-service/event-action` | The `https://developers.google.com/apps-script/reference/card-service/event-action` to be added. |

#### Return


`https://developers.google.com/apps-script/reference/card-service/widget` --- The Object, for chaining.

*** ** * ** ***

### `setFieldName(fieldName)`

Sets the field name that identifies this picker in the event object that is generated when
there is a UI interaction. The field name is visible to the user. Required; the specified field
name must be unique.

#### Parameters

| Name | Type | Description |
|---|---|---|
| `fieldName` | `String` | The name to assign to this input. |

#### Return


`https://developers.google.com/apps-script/reference/card-service/date-picker#` --- This picker, for chaining.

*** ** * ** ***

### `setId(id)`

Sets the unique ID assigned that's used to identify the widget to be mutated. Widget mutation
is only supported in Add-Ons.

#### Parameters

| Name | Type | Description |
|---|---|---|
| `id` | `String` | The id of the widget, with a limit of 64 characters and in format of \`\[a-zA-Z0-9-\]+\`. |

#### Return


`https://developers.google.com/apps-script/reference/card-service/widget` --- This object, for chaining.

*** ** * ** ***

### `setOnChangeAction(action)`

Sets an `https://developers.google.com/apps-script/reference/card-service/action` that the script performs whenever the picker input changes.

#### Parameters

| Name | Type | Description |
|---|---|---|
| `action` | `https://developers.google.com/apps-script/reference/card-service/action` | The action to take. |

#### Return


`https://developers.google.com/apps-script/reference/card-service/date-picker#` --- This picker, for chaining.

*** ** * ** ***

### `setTitle(title)`

Sets the title displayed above the input field.

#### Parameters

| Name | Type | Description |
|---|---|---|
| `title` | `String` | The input field title. |

#### Return


`https://developers.google.com/apps-script/reference/card-service/date-picker#` --- This picker, for chaining.

*** ** * ** ***

### `setValueInMsSinceEpoch(valueMsEpoch)`

Sets the prefilled value to be set in the input field.

#### Parameters

| Name | Type | Description |
|---|---|---|
| `valueMsEpoch` | `Number` | The default value placed in the input as a number, in milliseconds since the epoch. Only the date of the epoch time is used, and the time of the epoch time is discarded. It is always represented as a string in the form callback parameters. |

#### Return


`https://developers.google.com/apps-script/reference/card-service/date-picker#` --- This picker, for chaining.

*** ** * ** ***

### `setValueInMsSinceEpoch(valueMsEpoch)`

Sets the prefilled value to be set in the input field.

#### Parameters

| Name | Type | Description |
|---|---|---|
| `valueMsEpoch` | `String` | The default value placed in the input as a string, in milliseconds since the epoch. Only the date of the epoch time is used, and the time of the epoch time is discarded. It is always represented as a string in the form callback parameters. |

#### Return


`https://developers.google.com/apps-script/reference/card-service/date-picker#` --- This picker, for chaining.

*** ** * ** ***

### `setVisibility(visibility)`

Sets the visibility of the widget. The default value is \`VISIBLE\`.

#### Parameters

| Name | Type | Description |
|---|---|---|
| `visibility` | `https://developers.google.com/apps-script/reference/card-service/visibility` | The `https://developers.google.com/apps-script/reference/card-service/visibility` of the widget. |

#### Return


`https://developers.google.com/apps-script/reference/card-service/widget` --- The Object, for chaining.