jQuery cxDate 日期格式化


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

使用方法

载入 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])
   
名称默认值说明
stylenull日期格式化的样式
timenew Date()可选参数,需要格式化的时间。默认使用当前时间。

可传入一个日期字符串,如:"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: [...] 
  } 
};

下载地址