date-php v1.7.18

JavaScript模仿类似于PHP的日期格式功能JavaScript implements date formatting functions similar to PHP

这是一个Javascript模仿类似于PHP日期时间格式化函数，使用方法和PHP非常类似，有丰富的模板字符，并在原来的基础上增强了一些模板字符。例如：中国的农历日期、用汉字来表示日期、十二生肖与星座。让转换日期时间更自由。
This is a JavaScript implements date formatting functions similar to PHP. It is very similar to PHP, has rich template characters, and enhances some template characters on the basis of the original. For example: Chinese Lunar Date, Chinese Character Date, Chinese Zodiac and Constellation. Make the conversion datetimes more free.

兼容 TypeScript(.ts)(1.7.6+)
TypeScript(.ts) compatible (1.7.6+)

点击这里查看更多例/ want see more examples clicked here

如果你喜欢请 star 支持一下
Please star support if you like

// 举个栗子(examples)
// 首先(First)
import date from 'date-php';
var d = new Date(); // 1563148800000 or 'Mon Jul 15 2019 15:38:56 GMT+0800 (中国标准时间)'

// 然后(Second)
date('Y-m-d', d); // "2019-07-15
date('y-m-d', d); // "19-07-15
date('m-d-Y H:i:s', d); // "07-15-2019 15:38:56"
date('y-m-d H:i:s[a] D', d); // "07-15-20 15:38:56[pm] Mon"

// 或者这样(Or)
d.format('Y-m-d'); // "2019-07-15
d.format('y-m-d'); // "2019-07-15
d.format('m-d-Y H:i:s'); // "07-15-2019 15:38:56"
d.format('m-d-y H:i:s'); // "07-15-20 15:38:56"

格式化持续时间/剩余时间/倒计时(duration/count down) -- date.duration

// 举个栗子(examples)
// 这里时间戳是代表的持续时间/剩余时间/倒计时(duration/count down)
date.duration('倒计时：D天h小时',  13682958024 ) // 倒计时：158天08小时
date.duration('cou\\nt \\dow\\n：D \\d\\a\\y h \\hour\'\\s',  1591491612345 - 1577808654321 ) // "count down：158 day 08 hour's"
date.duration('D天h小时i分钟s.v秒',  86400000 + 12345) // 1天00小时00分钟12.345秒
date.duration('H小时i分钟s.v秒',  86400000 + 7654321) // 26小时07分钟34.321秒
date.duration('D天h小时i分钟s.v秒',  86400000 - 12345) // 0天23小时59分钟47.655秒

更多date示例 点这里(More date examples) | 持续时间/剩余时间/倒计时示例 点这里(duration & count down clicked here)

安装(install)

// npm
npm i -S date-php;

// CDN
<script src=“http://unpkg.com/date-php"></script>

使用(use)

 > 用法 / usage：

 date([tplChars:string='Y-m-d'[, dateTimeObj:dateTime|number=new Date() [,isMs: boolean=true]]])
 date([字符模板[, 日期时间对象 [,是否毫秒]]])

1、以下所有方式的入参都是可选参数。
　 Entry parameters in all of the following ways are optional.

2、以下new Date()或其它的日期时间的初始化的值，我们默许都是 1563176336000 Unix时间戳对应的日期时间。
　 The following new Date () or other date time initialization values, we acquiescence are 1563176336000 Unix timestamp corresponding Datetime.

3、持续时间/剩余时间/倒计时 点这里(duration/count down clicked here)

// ES6+ -- CDN方式跳过(CDN mode skip)
import date from 'date-php'; // 引入date-php(import date-php)

// CommonJS && AMD -- CDN方式跳过(CDN mode skip)
const date = require('date-php'); // 引入date-php(require date-php)

date('Y-m-d H:i:s', new Date()); // "2019-07-15 15:38:56"
date('y-m-d h:i[a]', new Date()); // "19-07-15 03:38[pm]"
date('星期K', "2019-07-15 15:38:56"); // "星期一" (1.3.2+)
date('C年f月k日 星期K', 1563176336000); // "二〇一九年七月十五日 星期一" (1.3.2+)
date('Y-m-d H:i 第W周', 'Mon Jul 15 2019 15:38:56 GMT+0800 (中国标准时间)'); // "2019-07-15 15:38 第29周"
date('Y年m月d日 H点i分s秒', new Date()); // "2019年07月15日 15点38分56秒" 
date('ly年lm月ld日lt时lk刻【lg】',1563122222000) // "己亥年六月十三日子时六刻【三更】"(1.5.0+)
date('m-d-Y H:i:s', new Date()); // "07-15-2019 15:38:56"
date('m-d-Y H:i:s.v', new Date()); // "07-15-2019 15:38:56.064"
date('m-d-Y H:i:s.u', new Date()); // "07-15-2019 15:38:56.064019"
date('y/m/d H:i', new Date()); // "19/07/15 15:38" 
date('y.m.d H:i', new Date()); // "19.07.15 15:38" 
date('y.m.d H:i', new Date()); // "19.07.15 15:38" 
// 更多请自由发挥...
// More please use your imagination...

/**
 * 示例2 - 日期时间对象.format('模板字符');
 * demo 2 - datetimeObject.format('Template character');
 */
new Date('2019-07-15 15:38:56').format('Y-m-d H:i:s'); // "2019-07-15 15:38:56" 
new Date(1563176336000).format('Y-m-d H:ia'); // "2019-07-15 15:38pm"
new Date().format('Y-m-d H:i 第W周'); // "2019-07-15 15:38 第29周"
// 更多请自由发挥...
// More please use your imagination...

试一试(try)

模板字符，默认值：{string} 'Y-m-d'(Template character, default: {string} 'Y-m-d')

1、你也可以去 PHP中文官网 看看，使用方法类似。
　 You can also go to the PHP english official website to see, the method is similar.

2、你也可以通过静态方法 date.description 在控制台打出所有模板字符。(1.3.2 - )
　 You can also output all template character in the console via the static method date.description.(1.3.2 - )

3、关于转义模板字符，这里与PHP不同 【敲黑板！！！】 (1.3.0 + )
　 About the escaped template character, here is different from PHP Note!!! (1.3.0 + )

如果在date里想输出模板本来的字符，请用转义符--双反斜杠"\\"(PHP是一个单反斜杠"\")。
If you want to output the original character of the template on the date, use the escape character – double backslash "\\" (PHP is a single backslash "\").
举个栗子： date("\\I \\l\\o\\v\\e \\y\\o\\u: y-m-d H:i", new Date()) // 输出 "I love you: 19-07-15 15:38"
Example: date("\\I \\l\\o\\v\\e \\y\\o\\u: y-m-d H:i", new Date()) // Output "I love you: 19-07-15 15:38"

上面栗子中，'I'(大写的i)、'l'(小写的L)、'o'、'v'、'e'、'y'、'u' 都是模板字符，所以前面加双反斜杠(\\)转义，这样字符就会输出本来的值。
In the previous example, 'I'(Uppercase i), 'l'(lowercase L), 'o', 'e', 'y', 'u' are all template character, so add an double backslash (\\) in front of the template character to escape , Character will output the original value.

4、加"*"号的为PHP语言中没有的功能，是date-php.js特有的功能。
　 Add the "*" in front is a function not available in the PHP language, and is a feature unique to date-php.js.

5、转农历正常只能转1900-2100之间的200年份。
　 The conversion to the lunar calendar can only be transferred to 200 years between 1900-2100.

6、模板字符区分大小写。
　 Template characters are case sensitive.

7、支持节假日输出
　 Support festival output
　 需要自定义节假日请参考 conf.replaceHolidayConf 与 conf.editHolidayConf
　 For custom holidays, please refer to conf.replaceHolidayConf & conf.editHolidayConf

试一试(try)

时间对象，默认值：{Date} 当前本地机器时间(Datetime object, default: {Date} local Datetime)

可以是任意时间对象，例如：
It can be any datetime object, Example:

    1563176336000 // 时间戳(Unix timestamp)
    new Date() // 当前本机日期和时间(Local datetime)
    '2019-07-15 15:38:56' // 字符串日期(String datetime)
    '2019/07/15 15:38:56' // 字符串日期(String datetime)  

试一试(try)

自定义节假日(Custom holidays)1.6.0+

默认配置(default config)

{
    '0101': ['元旦节', 'New year'],
    '0214': ['情人节', `Valentine's day`],
    '0308': ['国际妇女节', `International women's day`],
    '0315': ['国际消费者权益日', `International consumer rights day`],
    '0312': ['植树节', `Arbor day`],
    '0422': ['世界地球日', `Earth day`],
    '0501': ['国际劳动节', `International labour day`],
    '0504': ['青年节', `Youth day`],
    '0512': ['国际护士节', `International nurses day`],
    '0518': ['国际博物馆日', `International museum day`],
    '0601': ['国际儿童节', `International children's day`],
    '0605': ['世界环境日', `World environment day`],
    '0623': ['国际奥林匹克日', `International olympic day`],
    '0624': ['世界骨质疏松日', `World osteoporosis day`],
    '0701': ['建党节', `Party's building day`],
    '0801': ['建军节', `Army's day`],
    '0910': ['教师节', `Teacher's day`],
    '1001': ['国庆', 'National day'],
    '1024': ['中国程序员节', `Chinese programmer's day`],
    '1224': ['平安夜', `Christmas Eve`],
    '1225': ['圣诞节', `Christmas Day`],
    '1226': ['毛泽东诞辰', `Zedong Mao birthday`],
    '1117': ['世界学生日', `World student's day`],
    '1201': ['世界艾滋病日', `World AIDS day`],
    '*0101': ['春节', 'Chinese year'],
    '*0115': ['元宵节', 'Lantern day'],
    '*0202': ['龙头节', 'Dragon head day'],
    '*0505': ['端午节', 'Dragon boat day'],
    '*0707': ['乞巧节', 'Qi qiao day'],
    '*0715': ['中元节', 'Ghost day'],
    '*0815': ['中秋节', 'Moon day'],
    '*0909': ['重阳节', 'Chongyang day'],
    '*1001': ['寒衣节', 'Winter clothing day'],
    '*1015': ['下元节', 'Xiayuan day'],
    '*1208': ['腊八节', 'Laba day'],
    '*1223': ['祭灶节', 'Stove day'],
    '*1229': lunarInfo.isLeap ? ['除夕', `Year's Eve`] : '',
    '*1230': lunarInfo.isLeap ? '' : ['除夕', `Year's Eve`],
    '#0520': ['母亲节', `Mother's day`],
    '#0630': ['父亲节', `Father's day`],
    '@0256': ['俄罗斯程序员节', `Russian programmer's day`]
}

配置 Api(Configuration API)

key值说明(Key description)

代码示例(DEMO)

  /**
   * 示例3
   * demo 3
   **/
  // 修改与新增节日配置(未被修改的节日依然有效)
  // Modified and added holiday config (unmodified holidays are still valid)
  date.editHolidayConf = {
    '0214': ['小三节', 'Other woman day'], // 修改(edit)
    '0715': ['示例节', `Demo's day`], // 修改(edit)
    '#0836': ['纪念日', 'Acommemoration day'], // 新增(add)
    '*1213': ['作者生日', `Author's birthday`] // 新增(add)
  }
  
  // 替换节日配置(默认配置的节日全部失效)
  // Replace the holiday config (the default preparation of the holiday is all invalid)
  date.replaceHolidayConf = { // 替换(replace)
    '0214': ['小三节', 'Other woman day'],
    '0715': ['示例节', `Demo's day`],
    '#0836': ['纪念日', 'Acommemoration day'],
    '*1213': ['作者生日', `Author's birthday`]
  }
  
  date('Y-m-d fh', new Date()) // -> 2019-07-15 示例节
  date('Y-m-d lh', new Date()) // -> 2019-07-15 demos day

试一试(try)

格式化持续时间/剩余时间/倒计时(duration/count down)(1.7.0+)

> 用法 / usage：
date.duration([tplChars:string='D天h:i:s'[, duration:number=0 [,isMs: boolean=true]]])
date.duration([‘模板字符’[, 持续时间:时间戳 [,是否毫秒: true]]])  

  date.duration('n月j天 h小时i分钟s秒',  314159265 ) //" 0月3天 15小时15分钟59秒"
  date.duration('高考倒计时：D天h小时i分钟s秒',  1591491612345 - 1577808654321 ) //" 高考倒计时：158天08小时49分钟18秒"
  date.duration('倒计时：D天h小时i分钟s秒',  13682958024 ) // 倒计时：158天08小时49分钟18秒
  date.duration('cou\\nt \\d\\ow\\n：D \\d\\a\\y h:i:s',  1591491612345 - 1577808654321 ) // count down：158 day 08:49:18  date.duration('D天h小时i分钟s.v秒',  86400000 + 12345) // 1天00小时00分钟12.345秒
  date.duration('H小时i分钟s.v秒',  86400000 + 7654321) // 26小时07分钟34.321秒
  date.duration('D天h小时i分钟s.v秒',  86400000 - 12345) // 0天23小时59分钟47.655秒
  date.duration('1970年至今已有D天h小时i分钟s.v秒',  new Date()) // "从1970年至今已有18322天11小时20分钟15.092秒"

试一试(try)

黑科技的使用方式(Interesting to use)

可以非常简单的实现一个时钟，就象下面的一样。
Coded a clock is so easy, just like the following.

咦！这个时间的毫秒是不是有点怪？这是setInterval的问题。(虽然这只是一张图片\^_\^，但目的是抛出Javascript确实存在的问题。)
What! Is the millisecond of this Datetime a bit strange? This is a problem with setInterval. (Although this is just a picture ^_^, the purpose is to throw the problem Javascript does exist.)

<!doctype html>
<html>
<head>
	<title>test</title>
</head>
<body>
	<div class=“now”>
	    <div class=“clock”><span>当前时间：</span> <span class=“date-time”>--:--</span></div>
	    <div class=“clock”><span>now time：</span> <span class=“date-time”>--:--</span></div>
	</div>
	<script src="//unpkg.com/date-php"></script>
	<script type=“text/javascript”>
	    var nowClock = document.getElementsByClassName(‘date-time’)
	    
	    setInterval(function() {
	        for(let i=0; i<nowClock.length; i+=1){
	            nowClock[i].innerHTML=date(‘Y-m-d H:i:s.v’)
	        }
	    }, 1000);
	</script>
</body>
</html>

关于鸣谢(About)

Github Npmjs rollup eslint flow uglifyJs