使用 jQuery UI Datepicker 实现月份和年份选择教程

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

使用 jQuery UI Datepicker 实现月份和年份选择教程

2025-11-09

浏览次数：次

返回列表

使用 jQuery UI Datepicker 实现月份和年份选择教程

本教程详细指导如何使用 jquery ui datepicker 实现仅选择月份和年份的功能，并构建一个联动日期范围选择器。文章将涵盖必要的库文件引入、html结构、关键的j*ascript配置（包括 `onclose` 事件处理和 `dateformat` 设置），以及如何通过 css 隐藏日历视图。此外，还将介绍如何实现“开始日期”和“结束日期”之间的联动校验，确保用户选择的日期范围逻辑正确，同时支持本地文件引入而非cdn。

一、引言与核心概念

在许多业务场景中，我们可能只需要用户选择特定的月份和年份，而非具体的某一天。jQuery UI Datepicker 是一个功能强大的日期选择器组件，通过巧妙的配置和事件处理，可以轻松实现这一需求。本教程将展示如何配置 Datepicker 以仅显示月份和年份选择器，并结合“开始日期”和“结束日期”的联动校验功能。

实现此功能的核心在于以下几个 jQuery UI Datepicker 选项：

changeMonth: true 和 changeYear: true：启用月份和年份的下拉选择器。
showButtonPanel: true：显示底部按钮面板，通常包含“今天”和“完成”按钮，这对于月份/年份选择模式很有用。
dateFormat: 'mm-yy'：设置输入框中日期的显示格式，例如“01-2025”。
onClose 事件：这是最关键的部分。当 Datepicker 关闭时，我们需要手动从其内部的月份和年份下拉框中获取用户选择的值，然后使用这些值来设置输入框的最终日期。
CSS 样式：通过简单的 CSS 规则隐藏日历中的日期部分，进一步强化只选择月份和年份的意图。

二、环境准备：引入必要的库文件

要使用 jQuery UI Datepicker，您需要引入 jQuery 库、jQuery UI J*aScript 文件以及 jQuery UI 的 CSS 样式表。为了满足不使用 CDN 的需求，您可以将这些文件下载到本地项目目录中。

以下是您需要下载并引入的三个文件（您可以右键点击链接并选择“另存为”）：

jQuery 库: https://www.php.cn/link/a6a2b3e3c6569e69afe1e025d0ff8d1f
jQuery UI J*aScript: https://www.php.cn/link/6508deb7d1b89059767d5af370618046
jQuery UI 基础主题 CSS: https://www.php.cn/link/b1e895366dfa5d6a2b31a21ecfc5efe3

将这些文件下载到您的项目目录（例如，js/ 和 css/ 文件夹）后，在您的 HTML 文件的

或底部引入它们：

<!-- 引入 jQuery 库 -->
<script src="path/to/jquery.min.js"></script>
<!-- 引入 jQuery UI J*aScript -->
<script src="path/to/jquery-ui.min.js"></script>
<!-- 引入 jQuery UI 样式表 -->
<link rel="stylesheet" href="path/to/jquery-ui.css" />

请将 path/to/ 替换为您实际的文件路径。

三、HTML 结构

我们将创建两个输入框，分别用于选择“开始日期”和“结束日期”。

火龙果写作

用火龙果，轻松写作，通过校对、改写、扩展等功能实现高质量内容生产。

277 查看详情火龙果写作

<div class="col-lg-3 col-sm-12">
  <h4><b>开始日期 :</b></h4>
  <input type="text" class="form-control" name="f_date" id="datepicker1" required />
</div>
<div class="col-lg-3 col-sm-12">
  <h4><b>结束日期 :</b></h4>
  <input type="text" class="form-control" name="t_date" id="datepicker2" required/>
</div>

这里我们使用了 id="datepicker1" 和 id="datepicker2" 来标识这两个输入框，以便在 J*aScript 中进行初始化和操作。

四、J*aScript 配置：实现月份和年份选择及日期联动

现在，我们将使用 jQuery UI Datepicker 对这两个输入框进行初始化，并添加只选择月份和年份的逻辑，以及日期范围的联动校验。

$(function() {
  // 初始化“开始日期”选择器
  $('#datepicker1').datepicker({
    changeMonth: true, // 允许选择月份
    changeYear: true,  // 允许选择年份
    showButtonPanel: true, // 显示按钮面板，包含“完成”按钮
    dateFormat: 'mm-yy', // 设置日期格式为“月-年”
    onClose: function(dateText, inst) {
      // 当日期选择器关闭时触发
      // 获取用户从下拉框中选择的月份和年份
      var month = $("#ui-datepicker-div .ui-datepicker-month :selected").val();
      var year = $("#ui-datepicker-div .ui-datepicker-year :selected").val();
      // 创建一个日期对象，设置为所选月份的第一天
      var selectedDate = new Date(year, month, 1);
      // 将输入框的值设置为所选的月份和年份
      $(this).datepicker('setDate', selectedDate);

      // 更新“结束日期”选择器的最小可选日期
      $('#datepicker2').datepicker('option', 'minDate', selectedDate);

      // 如果“结束日期”当前值早于“开始日期”，则重置“结束日期”为“开始日期”
      var toDate = $('#datepicker2').datepicker('getDate');
      if (toDate && toDate < selectedDate) {
        $('#datepicker2').datepicker('setDate', selectedDate);
      }
    }
  });

  // 初始化“结束日期”选择器
  $('#datepicker2').datepicker({
    changeMonth: true, // 允许选择月份
    changeYear: true,  // 允许选择年份
    showButtonPanel: true, // 显示按钮面板，包含“完成”按钮
    dateFormat: 'mm-yy', // 设置日期格式为“月-年”
    onClose: function(dateText, inst) {
      // 当日期选择器关闭时触发
      // 获取用户从下拉框中选择的月份和年份
      var month = $("#ui-datepicker-div .ui-datepicker-month :selected").val();
      var year = $("#ui-datepicker-div .ui-datepicker-year :selected").val();
      // 创建一个日期对象，设置为所选月份的第一天
      var selectedDate = new Date(year, month, 1);
      // 将输入框的值设置为所选的月份和年份
      $(this).datepicker('setDate', selectedDate);

      // 更新“开始日期”选择器的最大可选日期
      $('#datepicker1').datepicker('option', 'maxDate', selectedDate);

      // 如果“开始日期”当前值晚于“结束日期”，则重置“开始日期”为“结束日期”
      var fromDate = $('#datepicker1').datepicker('getDate');
      if (fromDate && fromDate > selectedDate) {
        $('#datepicker1').datepicker('setDate', selectedDate);
      }
    }
  });
});

代码解析：

$(function() { ... });: 这是 jQuery 的简写形式，确保在 DOM 加载完成后执行代码。
changeMonth: true, changeYear: true: 启用日期选择器顶部的月份和年份下拉菜单，允许用户直接选择。
showButtonPanel: true: 启用底部面板，当用户选择完月份和年份后，点击“完成”按钮即可关闭并设置日期。
dateFormat: 'mm-yy': 指定输入框中日期的显示格式为“月-年”。
onClose: function(dateText, inst) { ... }: 这是实现只选择月份和年份的关键。
- $("#ui-datepicker-div .ui-datepicker-month :selected").val() 和 $("#ui-datepicker-div .ui-datepicker-year :selected").val()：在 Datepicker 关闭时，我们直接从其内部生成的 HTML 元素中获取用户选择的月份和年份值。
- var selectedDate = new Date(year, month, 1);：创建一个新的 Date 对象，将其设置为所选月份的第一天。这是因为 jQuery UI Datepicker 内部仍然需要一个完整的日期对象。
- $(this).datepicker('setDate', selectedDate);：将输入框的日期设置为我们构造的 selectedDate。
日期范围联动 (minDate / maxDate 选项):
- 在 datepicker1 的 onClose 中，$('#datepicker2').datepicker('option', 'minDate', selectedDate); 将“结束日期”的最小可选日期设置为“开始日期”的所选日期。
- 在 datepicker2 的 onClose 中，$('#datepicker1').datepicker('option', 'maxDate', selectedDate); 将“开始日期”的最大可选日期设置为“结束日期”的所选日期。
- 额外的 if (toDate && toDate selectedDate) 逻辑用于确保在用户更改日期导致范围不合法时，自动调整另一个日期，保持日期范围的有效性。

五、CSS 样式：隐藏日历中的日期

为了确保用户界面只显示月份和年份选择器，我们需要添加一条简单的 CSS 规则来隐藏日历中的日期表格。

.ui-datepicker-calendar {
  display: none;
}

将这段 CSS 代码添加到您的样式表文件（例如 style.css）中，或者直接放在 HTML 文件的

标签内的

以上就是使用 jQuery UI Datepicker 实现月份和年份选择教程的详细内容，更多请关注其它相关文章！

# 您的 # 海外推广营销策划书 # 鼎湖区推广全网营销公司 # 河北知名营销策划推广 # 无锡优化网站厂家地址 # 店铺开业营销推广策划书 # 烟台企业官网seo # 新乐网站推广方案 # 深圳网站推广可以做什么 # 南充企业网站优化服务 # 玉门网站建设制作 # 创建一个 # 样式表 # 可选 # 框中 # 这是 # css # 所选 # 输入框 # 设置为 # 选择器 # red # yy # cdn # ajax # bootstrap # js # html # jquery # java # javascript

相关栏目：【科技资讯46185 】【网络学院92790 】

上一篇：Python中Firebase用户删除的实现策略与Admin SDK应用

下一篇：Django 教程：在 For 循环中动态生成 URL 并链接到内容详情页

首页

关于我们

产品展示

咨询研究

新闻中心

留言板

联系我们

新闻中心 NEWS CENTER

使用 jQuery UI Datepicker 实现月份和年份选择教程

一、引言与核心概念

二、环境准备：引入必要的库文件

三、HTML 结构

四、J*aScript 配置：实现月份和年份选择及日期联动

五、CSS 样式：隐藏日历中的日期