Dayuts
构造函数
IMPORTANT
构造颜色对象请不要直接 new Dayuts(),而是通过 dateLib.dayuts() 函数创建。
| 名称 | 类型 | 必备 | 默认值 | 描述 |
|---|---|---|---|---|
| cfg | LDayutsConfig | 是 | - | 处理后的输入日期配置 |
方法
| 名称 | 参数 | 返回值 | 描述 |
|---|---|---|---|
| isValid | - | Boolean | 检查日期对象是否有效。 |
| isSame | (input: string|number|Date|Dayuts, units?: string = null) | Boolean | 检查当前日期是否与给定的日期在指定的时间单位内相同。 |
| isAfter | (input: string|number|Date|Dayuts, units?: string = null) | Boolean | 检查给定的日期或时间是否在当前 Dayuts 对象的指定时间单位之后。 |
| isBefore | (input: string|number|Date|Dayuts, units?: string = null) | Boolean | 检查给定的日期或时间是否在当前 Dayuts 对象的指定时间单位之前。 |
| isSameOrBefore | (input: string|number|Date|Dayuts, units?: string = null) | Boolean | 根据指定的时间单位,判断当前 Dayuts 对象是否与给定的输入在同一时间或之前。 |
| isSameOrAfter | (input: string|number|Date|Dayuts, units?: string = null) | Boolean | 根据指定的时间单位,判断当前 Dayuts 对象是否与给定的输入在同一时间或之后。 |
| isBetween | (input: any, input2: any, units: LDayutsUnit = 'millisecond', interval : string = '()') | Boolean | 根据指定的时间单位,判断当前 Dayuts 对象是否在给定的两个时间之间。 |
| isLeapYear | - | Boolean | 判断当前Dayuts对象所在的年份是否为闰年 |
| isToday | - | Boolean | 判断当前Dayuts对象所在日期是否是今天 |
| unix | - | Number | 获取当前 Dayuts 对象的 Unix 时间戳(以秒为单位)。 |
| startOf | (units : LDayutsUnit, startOf : boolean = true) | Dayuts | 将当前 Dayuts 对象设置到一个时间的开始。 |
| endOf | (units : LDayutsUnit, startOf : boolean = true) | Dayuts | 将当前 Dayuts 对象设置到一个时间的结束。 |
| set | (string : LDayutsUnit, int : number) | Dayuts | 创建一个当前对象的副本,并设置指定的时间单位的值。 |
| get | (units : LDayutsUnit) | Number | 获取当前 Dayuts 对象的指定时间单位的值。 |
| year | (input ?: number = null) | Number | Dayuts | 获取或设置年份。传入参数则设置为指定年份并返回当前对象,不传入参数则返回年份。 |
| month | (input ?: number = null) | Number | Dayuts | 获取或设置月份。传入参数则设置为指定月份并返回当前对象,不传入参数则返回月份。 |
| day | (input ?: number = null) | Number | Dayuts | 获取或设置星期几。传入参数则设置为指定星期几并返回当前对象,不传入参数则返回星期几。 |
| date | (input ?: number = null) | Number | Dayuts | 获取或设置月份中的某一天。传入参数则设置为指定月份中的某一天并返回当前对象,不传入参数则返回月份中的某一天。 |
| hour | (input ?: number = null) | Number | Dayuts | 获取或设置小时。传入参数则设置为指定小时并返回当前对象,不传入参数则返回小时。 |
| minute | (input ?: number = null) | Number | Dayuts | 获取或设置分钟。传入参数则设置为指定分钟并返回当前对象,不传入参数则返回分钟。 |
| second | (input ?: number = null) | Number | Dayuts | 获取或设置秒。传入参数则设置为指定秒并返回当前对象,不传入参数则返回秒。 |
| millisecond | (input ?: number = null) | Number | Dayuts | 获取或设置毫秒。传入参数则设置为指定毫秒并返回当前对象,不传入参数则返回毫秒。 |
| add | (number : number, units : LDayutsUnit) | Dayuts | 在当前 Dayuts 实例上添加指定的时间长度。 |
| subtract | (number : number, units : LDayutsUnit) | Dayuts | 在当前 Dayuts 实例上减去指定的时间长度。 |
| format | (formatStr ?: string = null) | String | 根据给定格式(包含格式占位符),返回格式化后的日期文本 |
| utcOffset | - | Number | 获取 Dayuts 实例的 UTC 偏移量(以分钟为单位)。 |
| diff | (input : string|number|Date|Dayuts, units : LDayutsUnit = 'millisecond', float : boolean = false) | Number | 计算两个日期之间的差值。float=true 时返回浮点数结果。 |
| toDate | - | Date | 将当前 Dayuts 对象转换为原生 Date 对象。 |
| toJSON | - | String | null | 如果 Dayuts 对象有效,则返回 ISO 8601 格式的字符串,否则返回 null |
| toISOString | - | String | 返回 ISO 8601 格式的字符串 |
| toObject | - | String | 返回 LDayutsObject 类型的对象 |
| toArray | - | Array<Number> | 返回包含当前时间信息的数组 |
| valueOf | - | Number | 获取当前日期的毫秒数 |
| daysInMonth | - | Number | 获取当前 Dayuts 对象所在月份的天数。 |
| locale | (preset ?: string = null) | String | Dayuts | 设置或获取 Dayuts 实例的本地化配置。如果传入参数,则返回国际化后的 Dayuts 实例,否则返回当前实例的语言名称 |
| clone | - | Dayuts | 返回复制后的 Dayuts 对象 |
| toString | - | String | 返回字符串 |
| dayOfYear | (input ?: number = null) | Number | Dayuts | 计算给定日期在当年的第几天,或者设置给定日期为当年的第几天。如果提供了输入值,则返回调整后的日期。如果没有提供输入值,则返回当前日期在当年的第几天。 |
| fromToBase | (input : string|number|Date|Dayuts, withoutSuffix : boolean, instance : Dayuts, isFrom : boolean) | String | 根据输入的时间计算与当前时间的相对时间差,并以指定的格式返回。 |
| to | (input : string|number|Date|Dayuts, withoutSuffix : boolean = false) | String | 返回当前实例到 X 的相对时间 |
| from | (input : string|number|Date|Dayuts, withoutSuffix : boolean = false) | String | 返回 X 到当前实例的相对时间。 |
| toNow | (withoutSuffix : boolean = false) | String | 返回当前实例到现在的相对时间。 |
| fromNow | (withoutSuffix : boolean = false) | String | 返回现在到当前实例的相对时间。 |
