TimeJS

更被 PHP 开发者熟悉的 JS 时间处理库，无额外第三方依赖，小巧快速

Usage

npm install jackdou-timejs

import Time from 'jackdou-timejs'

// 实例化参数和标准库对象 Date 完全一致，可以无缝迁移
const t = new Time()

// 使用UTC时区时间，默认 UTC = false 使用本地时区时间
t.UTC = true

// 格式化日期，layout 参数不传默认为 'Y-m-d H:i:s'
console.log(t.format()) // 2022-08-01 10:00:14

// 支持标准库 Date 的所有 API
// !注意，getMonth 和 getUTCMonth 方法现在不是返回0-11，而是1-12
console.log(t.getMonth()) // 8 表示8月

// 日期计算
t.addYear(1).addMonth(-1).addHours("10").addDays("-30").addMinutes(59).addSeconds(136)

Functions

• 支持 PHP 模板类型的日期格式化功能

  • 语法: t.format(layout String)
  • 示例:
    • t.format('Y-m-d H:i:s')
    • t.format('y年m月d号 H时i分s秒')

  /**
   * 格式化时间
   * 
   * ------------- 日 ---------------
   * 
   * d	月份中的第几天，有前导零的 2 位数字	01 到 31
   * j	月份中的第几天，没有前导零	1 到 31
   * l（“L”的小写字母）	星期几，完整的文本格式	周日 到 周一
   * N	ISO-8601 格式数字表示的星期中的第几天	1（表示星期一）到 7（表示星期天）
   * z	年份中的第几天	0 到 365
   * 
   * ------------- 星期 --------------
   * 
   * W	ISO-8601 格式年份中的第几周，每周从星期一开始	例如：42（当年的第 42 周）
   * 
   * ------------- 月份 --------------
   * 
   * m	数字表示的月份，有前导零	01 到 12
   * n	数字表示的月份，没有前导零	1 到 12
   * t	指定的月份有几天	28 到 31
   * 
   * ------------- 年 ----------------
   * 
   * L	是否为闰年	如果是闰年为 1，否则为 0
   * Y	4 位数字完整表示的年份	例如：1999 或 2003
   * y	2 位数字表示的年份	例如：99 或 03
   * 
   * ------------- 时间 --------------
   * 
   * g	小时，12 小时格式，没有前导零	1 到 12
   * G	小时，24 小时格式，没有前导零	0 到 23
   * h	小时，12 小时格式，有前导零	01 到 12
   * H	小时，24 小时格式，有前导零	00 到 23
   * i	有前导零的分钟数	00 到 59>
   * s	秒数，有前导零	00 到 59>
   * u	毫秒数 	示例: 654
   * 
  */

• 支持日期增减

  • API： t.add*()
  • 示例：
    • t.addDays(1)
    • t.addSeconds("-100")

Author

JackDou

License

MIT