0.1.0 • Published 7 years ago
date-master v0.1.0
Date-Master
Date Utils
Getting Started
Installation
yarn add date-master
or
npm i date-master -S
Methods
key | params | description |
---|---|---|
getFullYear() | 获取完成年份 | |
getMonth() | Boolean | 获取月份, 参数表示值小与10时, 是否补0, 如 '01', 默认 false |
getDate() | Boolean | 获取日, 参数表示值小与10时, 是否补0, 如 '01', 默认 false |
getDay() | Boolean | 获取天, 参数表示值小与10时, 是否补0, 如 '01', 默认 false |
getHours() | Boolean | 获取小时, 参数表示值小与10时, 是否补0, 如 '01', 默认 false |
getMinutes() | Boolean | 获取分钟, 参数表示值小与10时, 是否补0, 如 '01', 默认 false |
getSeconds() | Boolean | 获取秒, 参数表示值小与10时, 是否补0, 如 '01', 默认 false |
getDayName() | String | 获取中文${params}几, 默认 星期 |
isSameDay() | Vaild Date Param | 是否为同一天, 参数为需要比较的时间,用法参考 Example |
format() | String | 格式化时间, 具体用法参考 Example |
getTimeInterval() | Vaild Date Param, Array | 获取时间间隔, 第一个参数表示需要比较的时间, 第二个参数表示拼接字符串需要的单位, 具体用法参考 Example |
nativeDate | 实例化传入的参数或传入数组的第一个值 的原生Date对象,可调用Date上任意方法。 if u use this package without babel, i think u may not need this getter |
Example
import DateMaster from 'date-master'
const seconds1 = 1506807200000
const seconds2 = 1507019639139
/** getFullYear */
new DateMaster(seconds1).getFullYear() // 2017
new DateMaster([seconds1, seconds2]).getFullYear() // [2017, 2017]
/** getMonth */
new DateMaster(seconds1).getMonth() // 10
new DateMaster([seconds1, seconds2]).getMonth() // [10, 10]
/** getDate */
new DateMaster(seconds1).getDate() // 1
new DateMaster(seconds1).getDate(true) // '01'
new DateMaster([seconds1, seconds2]).getDate(true) // ['01', '03']
/** getDay */
new DateMaster(seconds1).getDay() // 0
/** getHours */
new DateMaster(seconds1).getHours() // 5
new DateMaster(seconds1).getHours(true) // 05
/** getMinutes */
new DateMaster(seconds1).getMinutes() // 33
/** getSeconds */
new DateMaster(seconds1).getSeconds() // 20
/** getDayName */
new DateMaster(seconds1).getDayName() // '星期日'
new DateMaster(seconds1).getDayName('周') // '周日'
new DateMaster([seconds1, seconds2]).getDayName('周') // ['周日', '周二']
/** isSameDay */
new DateMaster(seconds1).isSameDay(new Date()) // false
new DateMaster(seconds1).isSameDay(new Date(seconds1)) // true
/** format */
new DateMaster(seconds1).format('Y-MM-DD') // '2017-10-01'
new DateMaster(seconds1).format('Y.M.D') // '2017.10.1'
new DateMaster(seconds1).format('Y-M-D HH:II:SS') // '2017-10-1 05:33:20'
/** getTimeInterval */
new DateMaster(seconds1).getTimeInterval('2017-10-20') // [18, 18, 26, 40]
new DateMaster(seconds1).getTimeInterval('2017-10-20', ['天', '小时', '分钟', '秒']) // '18天18小时26分钟40秒')
new DateMaster(seconds1).getTimeInterval(['2017-10-20', '2017-10-22'], ['天', '小时', '分钟', '秒']) // ['18天18小时26分钟40秒', '20天18小时26分钟40秒']
/** Native Date Object */
new DateMaster(seconds1).nativeDate.getMonth() // 9
new DateMaster(seconds1).nativeDate.getDay() // 0
new DateMaster(seconds1).nativeDate.getHours() // 5
new DateMaster(seconds1).nativeDate.toDateString() 'Sun Oct 01 2017'