# Date Time Control
Elementor Core Basic
Elementor date time control displays a date/time picker field based on the Flatpickr (opens new window) library.
The control is defined in Control_Date_Time
class which extends Base_Data_Control
class.
When using this control, the type
should be set to \Elementor\Controls_Manager::DATE_TIME
constant.
# Arguments
Name | Type | Default | Description |
---|---|---|---|
type | string | date_time | The type of the control. |
label | string | The label that appears above of the field. | |
description | string | The description that appears below the field. | |
show_label | bool | true | Whether to display the label. |
label_block | bool | true | Whether to display the label in a separate line. |
separator | string | default | Set the position of the control separator. Available values are default , before , after and none . default will position the separator depending on the control type. before / after will position the separator before/after the control. none will hide the separator. |
picker_options | array | enableTime:true, minuteIncrement:1 | The picker configurations. |
default | string | Default date/time in MySQL format (YYYY-mm-dd HH:ii ). |
# Return Value
(string
) The chosen date/time in MySQL format (YYYY-mm-dd HH:ii
).
# Usage
<?php
class Elementor_Test_Widget extends \Elementor\Widget_Base {
protected function register_controls() {
$this->start_controls_section(
'content_section',
[
'label' => esc_html__( 'Content', 'textdomain' ),
'tab' => \Elementor\Controls_Manager::TAB_CONTENT,
]
);
$this->add_control(
'due_date',
[
'label' => esc_html__( 'Due Date', 'textdomain' ),
'type' => \Elementor\Controls_Manager::DATE_TIME,
]
);
$this->end_controls_section();
}
protected function render() {
$settings = $this->get_settings_for_display();
$due_date = strtotime( $this->get_settings( 'due_date' ) );
$due_date_in_days = $due_date / DAY_IN_SECONDS;
?>
<p><?php printf( esc_html__( 'Something will happen in %s days.', 'textdomain' ), $due_date_in_days ); ?></p>
<?php
}
protected function content_template() {
?>
<#
var due_date = new Date( settings.due_date ),
now_date = new Date(),
due_date_in_days = Math.floor( ( due_date - now_date ) / 86400000 ); // 86400000 milliseconds in one Day.
#>
<p> Something will happen in {{{ due_date_in_days }}} days. </p>
<?php
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46