4.22.3 • Published 2 years ago

@uiw/react-date-picker v4.22.3

Weekly downloads
306
License
MIT
Repository
github
Last release
2 years ago

DatePicker 日期选择器

Buy me a coffee Open in unpkg NPM Downloads npm version

显示一个月的日历,并允许用户选择单个日期,常见的应用场景在表单中应用,请查看基于 DatePickerDateInput 组件。

import { DatePicker } from 'uiw';
// or
import DatePicker from '@uiw/react-date-picker';

基础用法

import React from 'react';
import { DatePicker } from 'uiw';

export default function Demo() {
  const [date, setDate] = React.useState(new Date('2019-02-26 02:00:00'));
  
  return (
    <div>
      <DatePicker
        date={date}
        weekday={['Su', 'Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa']}
        monthLabel={['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']}
        todayButton="今天"
        onChange={(selectedDate) => setDate(selectedDate)}
      />
      <DatePicker
        showTime
        date={date}
        todayButton="今天"
        onChange={(selectedDate) => setDate(selectedDate)}
      />
      <DatePicker
        date={date}
        todayButton="今天"
        onChange={(selectedDate) => setDate(selectedDate)}
      />
      <div>{date ? String(date) : 'no date'}</div>
    </div>
  );
}

显示时间

import React from 'react';
import { DatePicker } from 'uiw';

export default function Demo() {
  const [date, setDate] = React.useState(null);
  return (
    <div>
      <DatePicker
        showTime
        date={date}
        todayButton="今天"
        onChange={(selectedDate) => setDate(selectedDate)}
      />
      <div>{date ? String(date) : 'no date'}</div>
    </div>
  )
}

设置本地语言

import React from 'react';
import { DatePicker } from 'uiw';

export default function Demo() {
  const [date, setDate] = React.useState(null);
  return (
    <div>
      <DatePicker
        todayButton="Today"
        weekTitle={['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday']}
        weekday={['Su', 'Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa']}
        monthLabel={['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December']}
        date={date}
        onChange={(selectedDate) => setDate(selectedDate)}
      />
      <div>{date ? String(date) : 'no date'}</div>
    </div>
  )
}

初始展示日期

import React from 'react';
import { DatePicker } from 'uiw';

export default function Demo() {
  const [date, setDate] = React.useState(null);
  return (
    <div>
      <DatePicker
        date={date}
        onChange={(selectedDate) => setDate(selectedDate)}
      />
      <div>{date ? String(date) : 'no date'}</div>
    </div>
  )
}

禁用时间

通过 disabledDate 方法设置,今天和今天之前不能选择。

import React from 'react';
import { DatePicker } from 'uiw';

function disabledDate(currentDate) {
  // 今天和今天之前不能选择
  return currentDate && currentDate.valueOf() < Date.now();
}

export default function Demo() {
  const [date, setDate] = React.useState(null);
  return (
    <div>
      <DatePicker
          disabledDate={disabledDate}
        date={date}
        onChange={(selectedDate) => setDate(selectedDate)}
      />
      <div>{date ? String(date) : 'no date'}</div>
    </div>
  );
}

定制日历单元格

使用 renderDay 可以自定义日期单元格的内容和样式。

import React from 'react';
import { DatePicker } from 'uiw';

export default function Demo() {
  const [date, setDate] = React.useState(null);
  return (
    <div>
      <DatePicker
        renderDay={(day, props) => {
          const style = {}
          const week = props.date.getDay();
          if (week === 0 && !props.prev && !props.next) {
            style.boxShadow = 'inset 0 0 0 1px rgb(255 0 0)';
          }
          return (
            <div style={style}> {day} </div>
          );
        }}
        date={date}
        onChange={(selectedDate) => setDate(selectedDate)}
      />
      <div>{date ? String(date) : 'no date'}</div>
    </div>
  );
}

DatePicker

参数说明类型默认值
date选中的日期Date-
panelDate日历面板默认展示哪一页Datenew Date
today默认高亮当天日期Datenew Date
todayButton展示回到今天按钮,和提示文本。String-
showTime增加时间选择功能,当 showTime 为一个对象时,其属性会传递给内建的 <TimePicker />Boolean/Object-
renderDay增加时间选择功能。 end: 周末,prev: 上个月,next:下个月 @3.0.0+Function(day, { end: bool, prev: bool, next: bool, date: Date })-
disabledDate不可选择的日期,函数返回 true 当前日期被禁用无法选择。end: 周末,prev: 上个月,next:下个月Function(currentDate, { end: bool, prev: bool, next: bool })-
weekTitle星期显示文本提示Array[星期天, 星期一, 星期二, 星期三, 星期四, 星期五, 星期六]
weekday星期显示文本Array[, , , , , , ]
monthLabel月份显示文本Array[一月, 二月, 三月, 四月, 五月, 六月, 七月, 八月, 九月, 十月, 十一月, 十二月]
onChange选择一天时调用。(selectedDate?: Date, dateSource?: IDateSource)-
onPanelChange面板变化事件。(date?: Date, mode?: 'next''prev')-

DatePicker.showTime

参数说明类型默认值
defaultValue默认时间Date-
disabled禁用全部操作Booleanfalse
disabledHours禁止选择部分小时选项Function-
disabledMinutes禁止选择部分分钟选项Function-
disabledSeconds禁止选择部分秒选项Function-
format禁止选择部分秒选项FunctionHH:mm:ss
hourStep禁止选择部分秒选项Function-
4.22.0

2 years ago

4.22.1

2 years ago

4.22.2

2 years ago

4.22.3

2 years ago

4.21.26

2 years ago

4.21.25

2 years ago

4.21.28

2 years ago

4.21.27

2 years ago

5.0.0-bate.2.1

2 years ago

5.0.0-bate.2.0

2 years ago

4.21.24

2 years ago

5.0.0-bate-19

3 years ago

4.21.22

2 years ago

4.21.21

2 years ago

4.21.23

2 years ago

5.0.0-bate-18

3 years ago

5.0.0-bate-14

3 years ago

5.0.0-bate-17

3 years ago

5.0.0-bate-10

3 years ago

5.0.0-bate-11

3 years ago

5.0.0-bate-12

3 years ago

5.0.0-bate-9

3 years ago

5.0.0-bate-7

3 years ago

5.0.0-bate-8

3 years ago

5.0.0-bate-6

3 years ago

4.21.20

3 years ago

4.21.19

3 years ago

4.21.18

3 years ago

4.21.15

3 years ago

4.21.17

3 years ago

4.21.16

3 years ago

5.0.0-bate-5

3 years ago

5.0.0-bate-3

3 years ago

5.0.0-bate-4

3 years ago

5.0.0-bate-1

3 years ago

5.0.0-bate-2

3 years ago

5.0.0-bate-0

3 years ago

4.21.13

3 years ago

4.21.14

3 years ago

4.21.11

3 years ago

4.21.12

3 years ago

4.21.10

3 years ago

4.21.1

3 years ago

4.21.2

3 years ago

4.21.3

3 years ago

4.21.4

3 years ago

4.21.0

3 years ago

4.20.0

3 years ago

4.21.9

3 years ago

4.21.5

3 years ago

4.21.6

3 years ago

4.21.7

3 years ago

4.21.8

3 years ago

4.18.1

3 years ago

4.18.0

3 years ago

4.17.0

3 years ago

4.16.0

3 years ago

4.16.1

3 years ago

4.16.2

3 years ago

4.19.0

3 years ago

4.15.1

3 years ago

4.14.1

3 years ago

4.14.2

3 years ago

4.14.0

3 years ago

4.13.7

3 years ago

4.13.8

3 years ago

4.13.9

3 years ago

4.13.11

3 years ago

4.13.12

3 years ago

4.13.10

3 years ago

4.15.0

3 years ago

4.10.5

3 years ago

4.10.6

3 years ago

4.10.7

3 years ago

4.9.9

3 years ago

4.10.1

3 years ago

4.10.2

3 years ago

4.10.3

3 years ago

4.10.4

3 years ago

4.10.0

3 years ago

4.13.6

3 years ago

4.13.2

3 years ago

4.13.3

3 years ago

4.13.4

3 years ago

4.13.5

3 years ago

4.13.0

3 years ago

4.13.1

3 years ago

4.12.0

3 years ago

4.12.1

3 years ago

4.12.2

3 years ago

4.11.4

3 years ago

4.11.5

3 years ago

4.11.6

3 years ago

4.9.11

3 years ago

4.9.10

3 years ago

4.11.0

3 years ago

4.11.1

3 years ago

4.11.2

3 years ago

4.11.3

3 years ago

4.9.7

4 years ago

4.9.6

4 years ago

4.9.4

4 years ago

4.9.3

4 years ago

4.9.2

4 years ago

4.9.1

4 years ago

4.9.0

4 years ago

4.8.9

4 years ago

4.8.8

4 years ago

4.7.16

4 years ago

4.8.5

4 years ago

4.8.4

4 years ago

4.8.7

4 years ago

4.8.6

4 years ago

4.8.1

4 years ago

4.8.0

4 years ago

4.8.3

4 years ago

4.8.2

4 years ago

4.7.13

4 years ago

4.7.14

4 years ago

4.7.15

4 years ago

4.7.12

4 years ago

4.7.10

4 years ago

4.7.11

4 years ago

4.7.9

4 years ago

4.7.8

4 years ago

4.7.7

4 years ago

4.7.6

4 years ago

4.7.5

4 years ago

4.7.4

4 years ago

4.7.3

4 years ago

4.7.2

4 years ago

4.7.0

4 years ago

4.6.19

5 years ago

4.6.15

5 years ago

4.6.16

5 years ago

4.6.17

5 years ago

4.6.18

5 years ago

4.6.14

5 years ago

4.6.13

5 years ago

4.6.12

5 years ago

4.6.11

5 years ago

4.6.10

5 years ago

4.6.9

5 years ago

4.6.8

5 years ago

4.6.7

5 years ago

4.6.6

5 years ago

4.6.3

5 years ago

4.6.4

5 years ago

4.6.2

5 years ago

4.6.1

5 years ago

4.6.0

5 years ago

4.5.0

5 years ago

4.4.1

5 years ago

4.4.0

5 years ago

4.3.1

5 years ago

4.2.3

5 years ago

4.2.5

5 years ago

4.3.0

5 years ago

4.2.14

5 years ago

4.2.1

5 years ago

4.2.0

5 years ago

4.1.2

5 years ago

4.1.1

5 years ago

4.1.0

5 years ago

4.0.0

5 years ago

4.0.0-alpha.8

5 years ago

4.0.0-alpha.7

5 years ago

4.0.0-alpha.6

5 years ago

4.0.0-alpha.3

5 years ago

4.0.0-alpha.2

5 years ago

4.0.0-alpha.1

5 years ago

4.0.0-alpha.0

5 years ago