Day.js使用重载的getter和setter,也就是说,调用这些不带参数的方法作为getter,调用带参数的方法作为setter。
它们映射到本地Date对象上的相应函数。
dayjs().second(30).valueOf() // => new Date().setSeconds(30)
dayjs().second() // => new Date().getSeconds()
如果您处于UTC mode
,它们将映射到等效的UTC。
dayjs.utc().seconds(30).valueOf()// => new Date().setUTCSeconds(30)
dayjs.utc().seconds()// => new Date().getUTCSeconds()
# 毫秒
获取或设置毫秒。 接受0到999的数字。如果超过这个范围,将持续到秒。
dayjs().millisecond()
dayjs().millisecond(1)
# 秒
获取或设置秒。
接受0到59的数字。如果超过这个范围,将持续到分钟。
dayjs().second()
dayjs().second(1)
# 分钟
获取或设置分钟。
接受0到59的数字。如果超过这个范围,将持续到小时。
dayjs().minute()
dayjs().minute(59)
# 小时
获取或设置小时。
接受0到59的数字。如果超过这个范围,将持续到日。
# 日期
获取或设置月份的日期。
接受从1到31的数字。如果超过这个范围,将持续到日
dayjs().date()
dayjs().date(1)
注意
dayjs#date表示月份的日期,而dayjs#day表示星期的日期。
# 星期
获取或设置星期几。
接受0(星期日)到6(星期六)的数字。如果超过这个范围,将持续到几周。
dayjs().day()
dayjs().day(0)
# ISO星期
获取或设置ISO day of the week (opens new window),其中1为星期一,7为星期日。
注意
此功能依赖IsoWeek插件
dayjs.extend(isoWeek)
dayjs().isoWeekday()
dayjs().isoWeekday(1); // Monday
# 年-日期
获取或设置一年中的日期。
接受1到366的数字。如果超过了这个范围,将持续到数年。 ::: waring 注意 此功能依赖DayOfYear插件 :::
dayjs.extend(dayOfYear)
dayjs('2010-01-01').dayOfYear() // 1
dayjs('2010-01-01').dayOfYear(365) // 2010-12-31
# 年-星期
获取或设置一年中的星期。 ::: waring 注意 此功能依赖WeekOfYear插件 :::
dayjs.extend(weekOfYear)
dayjs('2018-06-27').week() // 26
dayjs('2018-06-27').week(5) // set week
# 年-星期(ISO)
获取或设置ISO week of the year。
注意
此功能依赖IsoWeek插件
dayjs.extend(isoWeek)
dayjs().isoWeek()
dayjs().isoWeek(2)
# 月
获取或设置月份。
接受0到11的数字。如果超过这个范围,将一直持续到年底。
dayjs().month()
dayjs().month(0)
::: waring 注意 月份的索引为0,因此January是第0个月。 :::
# 季度
获取或设置季度。 ::: waring 注意 此功能依赖QuarterOfYear插件 :::
dayjs.extend(quarterOfYear)
dayjs('2010-04-01').quarter() // 2
dayjs('2010-04-01').quarter(2)
# 年
获取或设置年份。
dayjs().year()
dayjs().year(2000)
# 周年
获取本地周年
注意
此功能依赖WeekYear插件
dayjs.extend(weekYear)
dayjs.extend(weekOfYear)
dayjs().weekYear()
# 周年(ISO)
获取ISO week-year。
注意
此功能依赖IsoWeek插件
dayjs.extend(isoWeek)
dayjs().isoWeekYear()
# 年周数(ISO)
根据ISO weeks
获取当前年度的周数。
注意
此功能依赖IsoWeeksInYear插件
dayjs.extend(isoWeeksInYear)
dayjs.extend(isLeapYear)
dayjs('2004-01-01').isoWeeksInYear() // 53
dayjs('2005-01-01').isoWeeksInYear() // 52
# 获取
字符串getter,返回从Day.js对象中获取的相应信息。
语法:
dayjs().get(unit) === dayjs()[unit]()
单位不区分大小写,支持复数和缩写形式。
dayjs().get('year')
dayjs().get('month') // start 0
dayjs().get('date')
dayjs().get('hour')
dayjs().get('minute');
dayjs().get('second');
dayjs().get('millisecond');
所有可用单位列表
单位 | 缩写 | 描述 |
---|---|---|
date | D | 日期 |
day | d | 星期(星期日0,星期六6) |
month | M | 月份(0-11) |
year | y | 年 |
hour | h | 小时 |
minute | m | 分钟 |
second | s | 秒 |
millisecond | ms | 毫秒 |
# 设置
泛型setter接受unit作为第一个参数,value作为第二个参数,返回一个带有更改的新实例。
语法:
dayjs().set(unit, value) === dayjs()[unit](value)
单位不区分大小写,支持复数和缩写形式。
dayjs().set('date', 1)
dayjs().set('month', 3) // April
dayjs().set('second', 30)
# 最大值
返回给定Day.js实例的最大值。 ::: wanring 注意 此功能依赖MinMax插件 :::
dayjs.extend(minMax)
dayjs.max(dayjs(), dayjs('2018-01-01'), dayjs('2019-01-01'))
# 最小值
返回给定Day.js实例的最小值。
注意
此功能依赖MinMax插件
dayjs.extend(minMax)
dayjs.min([dayjs(), dayjs('2018-01-01'), dayjs('2019-01-01')])