0.2.2 • Published 2 years ago

jackdou-timejs v0.2.2

Weekly downloads
-
License
MIT
Repository
-
Last release
2 years ago

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

0.2.2

2 years ago

0.2.1

2 years ago

0.2.0

2 years ago

0.1.2

2 years ago

0.1.1

2 years ago

0.1.0

2 years ago