@jsxiaosi/utils

Appearance

On this page

Date ​

isNormalDate ​

判断传入的Date是否是一个正常的日期对象

示例代码
ts
import { isNormalDate } from '@jsxiaosi/utils';

  isNormalDate(new Date()) // true
  isNormalDate(new Date('invalid')) // false

参数:

参数说明类型默认值
date判断的日期Date

返回类型： boolean

parseDate ​

字符串转Date对象

示例代码
ts
import { parseDate } from '@jsxiaosi/utils';

  parseDate('2023-02-22 12:11:33') //Wed Feb 22 2023 12:11:33 GMT+0800 (中国标准时间) Date
  parseDate('2023-02-22 12:11:33.123') // Wed Feb 22 2023 12:11:33 GMT+0800 (中国标准时间) Date

参数:

参数说明类型默认值
dateInput日期字符串string / Date

返回类型： Date

parseDateTime ​

时间转Date对象

示例代码
ts
import { parseDate } from '@jsxiaosi/utils';

  parseDate('12:11:33') // Fri Apr 21 2023 12:11:33 GMT+0800 (中国标准时间) Date
  parseDate('12:11:33.123') // Fri Apr 21 2023 12:11:33 GMT+0800 (中国标准时间) Date

参数:

参数说明类型默认值
dateInput时间字符串string / Date

返回类型： Date

isDateTimeInRange ​

判断时间是否在指定范围内

示例代码
ts
import { isDateTimeInRange } from '@jsxiaosi/utils';

  isDateTimeInRange('12:00:00.100-15:00:00.000', '12:00:00.100') // true
  isDateTimeInRange('12:00:00.100-15:00:00.000', '12:00:00.000') // false

  isDateTimeInRange('12:00:00-15:00:00', '12:00:01') // true
  isDateTimeInRange('12:00:00-15:00:00', '15:00:01') // false

  isDateTimeInRange('12:00-15:00', '12:00:01') // true
  isDateTimeInRange('12:00-15:00', '15:00:01') // false

  isDateTimeInRange('12-15', '12:00:01') // true
  isDateTimeInRange('12-15', '15:00:01') // false

  isDateTimeInRange('12:00-15:00', '12:00') // true
  isDateTimeInRange('12:00-15:00', '15:01') // false

  isDateTimeInRange('12:00-15:00', '12') // true
  isDateTimeInRange('12:00-15:00', '15') // true

⚠️

此函数仅仅作用域判断时间范围，dateTimeRange不能带上日期否则会转换错误
如果要判断日期时间请使用isDateInRange

参数:

参数说明类型默认值
dateTimeRange时间范围string
date日期时间string / Datenew Date()

返回类型： boolean

isDateInRange ​

判断日期是否在指定范围内

示例代码
ts
import { parseDate } from '@jsxiaosi/utils';

  isDateInRange('2023-04-21 12:00:00', '2023-04-21 15:00:00', '2023-04-21 12:33:22.123') // true
  isDateInRange('2023-04-20', '2023-04-22', '2023-04-21') // true
  isDateInRange('2023-04-20', '2023-04-21', '2023-04-22') // false

参数:

参数说明类型默认值
startDateInput开始日期string / Date
endDateInput结束string / Date
date日期时间string / Datenew Date()

返回类型： boolean

compareDates ​

比较日期 判断第一个日期是否大于、大于等于、小于、小于等于第二个日期

示例代码
ts
import { compareDates } from '@jsxiaosi/utils';

  const date1 = '2023-04-21 12:33:22';
  const date2 = '2023-04-21 12:33:23';

  compareDates(date1, date2, 'greater') // false date1不大于data2
  compareDates(date1, date2, 'greaterOrEqual') // false date1不大于等于data2
  compareDates(date1, date2, 'less') // true date1小于data2
  compareDates(date1, date2, 'lessOrEqual') // true date1小于等于data2

参数:

参数说明类型默认值
date待比较日期string / Date
startDate开始日期string / Date
comparison比较类型ComparisonTypegreaterOrEqual

ComparisonType:

参数说明
greater大于
greaterOrEqual大于等于
less小于
lessOrEqual小于等于

返回类型： boolean