zaman

Zaman

Zaman is a lightweight React component for creating a Jalali/Georgian datepicker. There is also a range datepicker and timepicker in Zaman. The module can also be customized to match the appearance of your designs.

Design

I appreciate Ali Samandar's design of this library. Give him your support.

check out the codesandbox link.

Install

with npm

$ npm i zaman

with yarn

$ yarn add zaman

Props

Date Picker and Calendar

props	type	default
defaultValue	timestamp | Date | Dayjs	undefined
weekend	number[]	undefined
round	string one of thin | x1 | x2 | x3 | x4	thin
accentColor	string	#0D59F2
locale	string one of fa | en	fa
direction	string one of rtl | ltr	rtl
onChange	function	undefined
range	boolean	false
from	timestamp | Date | Dayjs	undefined
to	timestamp | Date | Dayjs	undefined
show	boolean	false
inputClass	string	null
inputAttributes	object of InputHTMLAttributes	null
className	string	null
customShowDateFormat	string ex: YYYY MMMM DD or DD/MM etc.	undefined
position	right | left | center	right

Calendar Provider

props	type	default
round	string one of thin | x1 | x2 | x3 | x4	thin
accentColor	string	#0D59F2
locale	string one of fa | en	fa
direction	string one of rtl | ltr	rtl
children	ReactNode	null

Time Picker

props	type	default
defaultValue	timestamp | Date | Dayjs	Date
round	string one of thin | x1 | x2 | x3 | x4	thin
accentColor	string	#0D59F2
locale	string one of fa | en	fa
clockTime	number one of 12 | 24	24
inputClass	string	null
inputAttributes	object of InputHTMLAttributes	null

Usages

Date picker

import { DatePicker } from "zaman";

function App() {
  return (
    <DatePicker onChange={(e) => console.log(e.value)} />
  )
}

Range date picker

import { DatePicker } from "zaman";

function App() {
  return (
    <DatePicker onChange={(e) => console.log(e.from, e.to)} range />
  )
}

Calendar

import { Calendar, CalendarProvider } from "zaman";

function App() {
  const [calendarValue, setCalendarValue] = useState(new Date())

  return (
    <CalendarProvider>
      <Calendar
        defaultValue={calendarValue}
        onChange={(e) => setCalendarValue(new Date(e.value))}
      />
    </CalendarProvider>
  )
}

Time picker

import { TimePicker } from "zaman";

function App() {
  return (
    <TimePicker
      onChange={(e) => console.log(e.hour, e.minute, e.timeConvention)}
    />
  )
}

License

MIT License