日期选择器

DatePicker 是一个渲染日历以供选择日期的 React 组件。它可以独立使用，也可以作为 DateTimePicker 组件的一部分。

用法

渲染一个 DatePicker。

import { useState } from 'react';
import { DatePicker } from '@wordpress/components';

const MyDatePicker = () => {
    const [ date, setDate ] = useState( new Date() );

    return (
        <DatePicker
            currentDate={ date }
            onChange={ ( newDate ) => setDate( newDate ) }
        />
    );
};

属性

该组件接受以下 props：

currentDate: Date | string | number | null

初始化时的当前日期。可以选择性地传入 null 值以指定当前未选择任何日期。

• 是否必需：否
• 默认值：今天的日期

onChange: ( date: string ) => void

当选中新日期时调用的函数。它将 currentDate 作为参数传递。

• 是否必需：否

events: { date: Date }[]

要在日期选择器中显示的事件列表。每个事件将在其对应的日期上显示为一个点。

• 是否必需：否

isInvalidDate: ( date: Date ) => boolean

一个回调函数，接收代表某一天的 Date 对象作为参数，并应返回一个布尔值以表示该天是否有效。

• 是否必需：否

onMonthPreviewed: ( date: string ) => void

在日期选择器中选择上一月/下一月时调用的回调函数。该回调函数接收 ISO 格式的新月份日期作为参数。

• 是否必需：否

startOfWeek: 0 | 1 | 2 | 3 | 4 | 5 | 6

一周应从哪一天开始。0 表示星期日，1 表示星期一，依此类推。

• 是否必需：否
• 默认值：0