Skip to content

step1ov/period-selector

Repository files navigation

Period Selector

NPM version Build npm-typescript License

Period selector component based on Ant Design 5 and dayjs.

Alt text

Provides such period options: today, yesterday, week, month, quarter, year, date selection, date range.

Live Demo

Installation

npm install @antd-extensions/period-selector

or

yarn add @antd-extensions/period-selector

Also, you need antd and dayjs to be installed in you project

yarn add antd dayjs

Component dependencies:

{
  "peerDependencies": {
    "react": ">=16",
    "antd": ">=5",
    "dayjs": ">=1"
  }
}

Usage

Basic usage:

import React, {useState} from 'react';
import PeriodSelector, {PeriodSelectorDefault} from "@antd-extensions/period-selector";

const BasicUsageExample = () => {
  const [period, setPeriod] = useState<PeriodSelectorValue>(PeriodSelectorDefault);

  return (
      <PeriodSelector
        value={period}
        onChange={setPeriod}
      />
  )
}

Localized usage:

import React, {useState} from 'react';
import PeriodSelector, {PeriodSelectorDefault} from '@antd-extensions/period-selector';
import 'dayjs/locale/ru';
import pickerLocale from 'antd/es/date-picker/locale/ru_RU';
import locale from '@antd-extensions/locales/ru_RU';

const LocalizationExample = () => {
  const [period, setPeriod] = useState<PeriodSelectorValue>(PeriodSelectorDefault);

  return (
    <PeriodSelector
      value={period}
      onChange={setPeriod}
      locale={locale}
      pickerLocale={pickerLocale}
      pickerFormat={'DD.MM.YYYY'}
    />
  )
}

export default LocalizationExample;

About

Dates period selector component based on antd and dayjs

Resources

License

Stars

Watchers

Forks

Packages

No packages published