npm 包 jquery-dateFormat 使用教程-JavaScript中文网-JavaScript教程资源分享门户

jquery-dateFormat 是一个基于 jQuery 的日期格式化工具，可以方便地将 Date 对象格式化成各种常用的日期字符串形式。本文将详细介绍如何使用这个 npm 包。

安装

首先，需要确保已经安装了 Node.js 和 npm。然后，在命令行中执行以下命令安装 jquery-dateFormat：

npm install jquery-dateformat

引入

在页面中引入 jQuery 和 jquery-dateFormat：

<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script src="node_modules/jquery-dateformat/dist/jquery.dateformat.min.js"></script>

使用方法

jquery-dateFormat 提供了两种使用方式：全局模式和局部模式。

全局模式

在全局模式下，可以直接调用 $.format 方法对 Date 对象进行格式化。例如：

var now = new Date();
var formatted = $.format.date(now, "yyyy-MM-dd HH:mm:ss");
console.log(formatted); // 输出 2023-04-07 14:30:00

局部模式

在局部模式下，需要先选定要进行格式化的元素或元素集合，然后调用 format 方法。例如：

HTML 代码：

<div class="date">2023-04-07</div>
<div class="date">2023-04-08</div>
<div class="date">2023-04-09</div>

JavaScript 代码：

$(".date").format("yyyy-MM-dd", {
  utc: true
});

这会将每个 div.date 的日期格式化为 UTC 格式的字符串。

参数说明

$.format.date(date, format, options) 方法接受三个参数：

date：要格式化的 Date 对象。
format：格式化字符串，可以包含以下占位符：
- d：月份中的某天（1-31）
- dd：补零后的月份中的某天（01-31）
- ddd：星期几的缩写
- dddd：星期几的全名
- M：月份（1-12）
- MM：补零后的月份（01-12）
- MMM：月份的缩写
- MMMM：月份的全名
- yy：年份的后两位数
- yyyy：四位数的年份
- h：小时数（12 小时制）（1-12）
- hh：补零后的小时数（12 小时制）（01-12）
- H：小时数（24 小时制）（0-23）
- HH：补零后的小时数（24 小时制）（00-23）
- m：分钟数（0-59）
- mm：补零后的分钟数（00-59）
- s：秒数（0-59）
- ss：补零后的秒数（00-59）
- l：毫秒数（0-999）
- L：补零后的毫秒数（000-999）
- t：上午或下午的标记（小写字母）（a 或 p）
- T：上午或下午的标记（大写字母）（A 或 P）
- Z：时区偏移量（+hhmm 或 -hhmm）
options：可选参数，包括以下属性：
- amNames：上午标记的名称数组，默认为 ["AM", "A"]
- pmNames：下午标记的名称数组，默认为 ["PM", "P"]
- utc：是否使用 UTC 时间，默认为 false

示例代码

<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8

> 来源：[JavaScript中文网](https://www.javascriptcn.com/post/36109) ，转载请注明来源
[https://www.javascriptcn.com/post/36109](https://www.javascriptcn.com/post/36109)