本教程详细介绍了如何从 jQuery Datetimepicker 控件中获取用户选定的日期和时间值。文章提供了两种核心方法：一是通过调用 getValue() 方法直接获取，适用于表单提交或特定事件触发时；二是通过配置 onChangeDateTime 事件回调函数，实现实时或事件驱动的值获取。教程包含详细代码示例和使用注意事项，帮助开发者高效地集成和使用 Datetimepicker。

1. Datetimepicker 的基本设置与 HTML 结构

在使用 jquery datetimepicker 获取值之前，我们需要确保其已正确地集成到 html 页面并进行了初始化。以下是典型的 html 结构和 javascript 初始化代码：

HTML 结构： 通常，Datetimepicker 会绑定到一个输入框（input 元素），并可能包含一个用于触发日历的按钮。

<div class="form-group">     <label>日期:</label>     <div class="input-group date" id="reservationdate" data-target-input="nearest">         <input type="text" class="form-control datetimepicker-input" data-target="#reservationdate" />         <div class="input-group-append" data-target="#reservationdate" data-toggle="datetimepicker">             <div class="input-group-text"><i class="fa fa-calendar"></i></div>         </div>     </div> </div>

在这个结构中，#reservationdate 是包裹整个日期选择器组件的容器，而 input 元素是实际显示和接收日期值的字段。

JavaScript 初始化： 使用 jQuery 选中目标元素并调用 datetimepicker() 方法进行初始化。

$(function () {     $('#reservationdate').datetimepicker({         format: 'L', // 'L' 通常表示本地化的日期格式，例如 MM/DD/YYYY         // 其他配置选项...     }); });

这里的 format: ‘L’ 定义了日期在输入框中显示的格式。

2. 获取 Datetimepicker 值的两种主要方法

一旦 Datetimepicker 被初始化，我们可以通过以下两种主要方式来获取用户选择的日期和时间。

2.1 方法一：直接调用 getValue() 方法

这种方法适用于在特定事件（如表单提交、按钮点击）发生后，一次性获取当前选定的日期值。它通过 Datetimepicker 实例的 API 来实现。

使用场景：

• 用户点击“保存”或“提交”按钮时。
• 在其他业务逻辑需要当前日期值时。

示例代码：

$(function () {     // 初始化 Datetimepicker     $('#reservationdate').datetimepicker({         format: 'L',     });      // 假设有一个按钮用于触发获取值的操作     $('#get-date-button').on('click', function() {         // 直接调用 datetimepicker 的 'getValue' 方法         // 注意：这里是对绑定了 datetimepicker 的容器元素调用         var selectedDate = $('#reservationdate').datetimepicker('getValue');          if (selectedDate) {             // getValue() 返回的是一个 Date 对象             // 可以根据需要格式化或直接使用             alert('选定的日期是: ' + selectedDate.toLocaleDateString());             console.log('选定的日期对象:', selectedDate);         } else {             alert('请选择一个日期。');         }     });      // 假设 HTML 中有一个按钮     // <button id="get-date-button">获取日期</button> });

说明：

Poe

Quora旗下的对话机器人聚合工具

289

查看详情

• $(‘#reservationdate’).datetimepicker(‘getValue’) 会返回一个 JavaScript Date 对象，如果未选择任何日期，则可能返回 null 或 undefined。
• 获取到的 Date 对象可以进行进一步的格式化处理，例如使用 toLocaleDateString()、toISOString() 或自定义格式化函数。

2.2 方法二：利用 onChangeDateTime 事件回调

这种方法允许你在 Datetimepicker 的值发生变化时立即执行某个函数。这对于需要实时响应日期选择变化的场景非常有用。

使用场景：

• 根据用户选择的日期动态更新页面内容。
• 在日期更改时立即进行数据验证。
• 实现联动日期选择器（例如，开始日期改变时，自动调整结束日期的最小可选值）。

示例代码：

$(function () {     // 初始化 Datetimepicker 并配置 onChangeDateTime 事件     $('#reservationdate').datetimepicker({         format: 'L',         onChangeDateTime: function(dp, $input) {             // dp 参数是 datetimepicker 实例             // $input 参数是 jQuery 对象，代表输入框元素             var newDateValue = $input.val(); // 从输入框直接获取字符串值             var newDateObject = dp.getValue(); // 从 datetimepicker 实例获取 Date 对象              if (newDateValue) {                 alert('日期已更改为 (字符串): ' + newDateValue);                 console.log('日期已更改为 (Date 对象):', newDateObject);                 // 可以在这里执行其他逻辑，例如更新另一个字段             } else {                 alert('日期已清空。');             }         }     }); });

说明：

Poe

Quora旗下的对话机器人聚合工具

289

查看详情

• onChangeDateTime 是 Datetimepicker 的一个配置选项，其值是一个回调函数。
• 回调函数接收两个参数：
  • dp: Datetimepicker 的实例对象，你可以通过它调用 getValue() 等方法。
  • $input: 当前 Datetimepicker 关联的 jQuery 输入框元素。你可以通过 $input.val() 直接获取输入框中的字符串值。
• 此方法在用户选择日期或时间后立即触发，提供即时反馈。

3. 注意事项与最佳实践

• 库版本兼容性： 确保你使用的 jQuery Datetimepicker 库版本支持 getValue() 和 onChangeDateTime 等方法。本文基于 xdsoft/datetimepicker 库的常见用法。
• 返回值类型： getValue() 方法通常返回一个 JavaScript Date 对象，而 $input.val() 返回的是一个字符串。根据你的需求选择合适的方法。Date 对象在进行日期计算或比较时更为方便，字符串则更适合直接显示或作为表单数据提交。
• 格式化： format 选项决定了日期在输入框中显示的字符串格式。当你通过 $input.val() 获取值时，会得到这个格式的字符串。如果需要其他格式，你需要对获取到的 Date 对象进行额外的格式化处理。
• 空值处理： 在获取值时，务必检查返回值是否为空（null 或 undefined），以避免在用户未选择日期时引发错误。
• 事件委托： 如果你的 Datetimepicker 是动态添加到 DOM 中的，考虑使用事件委托来绑定事件（例如，对于获取按钮的点击事件）。

4. 总结

获取 jQuery Datetimepicker 的值主要有两种策略：

1. 主动查询： 使用 $(‘#element’).datetimepicker(‘getValue’) 在需要时获取 Date 对象。适用于表单提交等非实时场景。
2. 事件驱动： 在初始化时配置 onChangeDateTime 回调函数，实时响应日期选择的变化，通过回调参数 dp.getValue() 获取 Date 对象或 $input.val() 获取格式化字符串。

选择哪种方法取决于你的具体应用场景和对实时性、数据类型的要求。理解这两种方法将帮助你更灵活、高效地使用 jQuery Datetimepicker。