cxDate 日期格式化

cxDate 是一个用于格式化日期的插件，通过自定义样式来格式化日期，支持处理字符串及时间戳格式的日期值。

支持: jQuery v1.0+; Zepto v1.0+

使用方法

载入 JavaScript 文件

<script src="cxdate.js"></script>

示例

// 格式化当前日期时间
cxDate('YYYY-MM-DD HH:mm:ss')

// 格式化指定日期时间（传入日期字符串）
cxDate('YYYY-MM-DD HH:mm:ss', '2014-03-20');  // 2014-03-20 00:00:00

// 格式化指定日期时间（传入时间戳）
cxDate('YYYY-MM-DD HH:mm:ss', 1395308117359);  // 2014-03-20 17:35:17

参数说明

cxDate(style [, time])

名称默认值说明

style null 日期格式化的样式

time

new Date()

名称	默认值	说明
style	null	日期格式化的样式
time	new Date()	可选参数，需要格式化的时间。默认使用当前时间。可传入一个日期字符串，如："2014-03-20 20:35:00"、"Aug 9, 1995"、"3/29/2014" 可传入一个时间戳（距离 1970-1-1 00:00:00 相差的毫秒数）注意：时间戳为毫秒数，PHP 的`time()`及`strtotime()`方法返回的为秒数，需乘以 1000 之后再进行处理。

可选参数，需要格式化的时间。默认使用当前时间。

可传入一个日期字符串，如："2014-03-20 20:35:00"、"Aug 9, 1995"、"3/29/2014"

可传入一个时间戳（距离 1970-1-1 00:00:00 相差的毫秒数）

注意：时间戳为毫秒数，PHP 的time()及strtotime()方法返回的为秒数，需乘以 1000 之后再进行处理。

style 参数说明

字符	说明	返回值示例
YY	年份，仅末尾 2 位数字	如：08 或 14
YYYY	年份，完整 4 位数字	如：2008 或 2014
M	月份，数字	1 到 12
MM	月份，数字带前导零	01 到 12
MMM	月份，缩写名称，文本	'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec' * 可配置多语言
MMMM	月份，完整名称，文本	'January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December' * 可配置多语言
D	月份中的第几天，数字	1 到 31
DD	月份中的第几天，数字带前导零	01 到 31
d	星期中的第几天，数字	0: 周日; 1: 周一; 2: 周二; 3: 周三; 4: 周四; 5: 周五; 6:周六;
ddd	星期中的第几天，缩写名称，文本	'Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat' * 可配置多语言
dddd	星期中的第几天，完整名称，文本	'Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday' * 可配置多语言
H	小时，24 小时格式，数字	0 到 23
HH	小时，24 小时格式，数字带前导零	00 到 23
h	小时，12 小时格式，数字	1 到 12
hh	小时，12 小时格式，数字带前导零	01 到 12
m	分钟，数字	0 到 59
mm	分钟，数字带前导零	00 到 59
s	秒数，数字	0 到 59
ss	秒数，数字带前导零	00 到 59
A	大写的上午和下午值，文本	'AM' 或 'PM' * 可配置多语言
a	小写的上午和下午值，文本	'am' 或 'pm' * 可配置多语言

多语言配置

需要在 cxdate.js 之前引入

<script src="cxdate.languages.js"></script>
<script src="cxdate.js"></script>

配置文件说明

cxDateLanguages = {
  // 浏览器的语言，纯小写字母
  en: {
    // 月份名称缩写
    monthAbbr: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],
    // 月份完整名称
    monthName: ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'],
    // 星期名称缩写
    weekAbbr: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'],
    // 星期完整名称
    weekName: ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'],
    // 上午、下午小写
    amName: ['am', 'pm'],
    // 上午、下午大写
    AMName: ['AM', 'PM']
  },
  'language name': {
    monthAbbr: [...],
    monthName: [...],
    weekAbbr: [...],
    weekName: [...],
    amName: [...],
    AMName: [...]
  }
};