# nira-date-picker

> This library Supports Angular CLI versions greater than or equal to 16.1.0.

Latest version **1.3.4** (published 2024-04-30) · 0 weekly downloads

## Install

```sh
npm install nira-date-picker
pnpm add nira-date-picker
yarn add nira-date-picker
bun add nira-date-picker
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities.

Warnings: low downloads.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.3.4 |
| Published | 2024-04-30 |
| First published | 2024-02-03 |
| Weekly downloads | 0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 926.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | nira2024 |

## Links

- npm: https://www.npmjs.com/package/nira-date-picker
- npm.io page: https://npm.io/package/nira-date-picker

## Dependencies (3)

- [tslib](https://npm.io/package/tslib.md) ^2.3.0
- [nira-modal](https://npm.io/package/nira-modal.md) ^1.0.4
- [jalali-moment](https://npm.io/package/jalali-moment.md) ^3.3.11

## Recent versions

- 1.3.4 (latest) — 2024-04-30
- 1.3.3 — 2024-04-30
- 1.3.2 — 2024-04-21
- 1.3.1 — 2024-04-21
- 1.3.0 — 2024-04-03
- 1.2.7 — 2024-03-25
- 1.2.6 — 2024-03-25
- 1.2.4 — 2024-03-16
- 1.2.3 — 2024-03-16
- 1.2.2 — 2024-03-16
- 1.2.1 — 2024-02-04
- 1.2.9 — 2024-02-04
- 1.1.9 — 2024-02-04
- 1.1.8 — 2024-02-03

## README

# NiraDatePicker

This library Supports Angular CLI versions greater than or equal to 16.1.0.

`nira-date-picker` is a date picker with some abilities like customizing theme , setting default date, ...

`nira-date-picker` is a date picker based on **Shamsi date** and [Jalali Moment](https://www.npmjs.com/package/jalali-moment) package is used in it.

## coming soon

the **Gregorian** section in `nira-date-picker` will be activate.

## Installation

`npm i nira-date-picker`

## How To **open** calendar

1. **First** inject `NiraDatePickerModule` in the module you want to use `nira-date-picker` like bellow:

```typescript
import { NiraDatePickerModule } from 'nira-date-picker';
@NgModule({
//other inputs
  imports: [
    NiraDatePickerModule,
   ]})
```

2. You should bind `nira-date-picker` with an HTML **input** tag by `isOpenCalendar` ;a two way bind property; the calendar will be opened by `click` on the `input` and change `isOpenCalendar` value to `true` . like bellow(in `component.html` file):

```html
<input (click)="_isOpenCalendar = true" />
<lib-nira-date-picker
  [(isOpenCalendar)]="_isOpenCalendar">
</lib-nira-date-picker>
```

## How To **Get Selected Date** From `nira-date-picker`

you must get selected date from `datePickerResult` property like bellow (in `component.html` file):

```html
<input (click)="_isOpenCalendar = true" [value]="date" />
<lib-nira-date-picker
  [(isOpenCalendar)]="_isOpenCalendar" 
  (datePickerResult)="date = $event"> 
</lib-nira-date-picker>
```

## How **set default value** to `nira-date-picker`

you must set default value by `defaultDate` property in `nira-date-picker` like bellow (in `.component.html` file):

```html
<input matInput id="datePickerInput " [value]="date" />
<lib-nira-date-picker
  (click)="_isOpenCalendar = true" 
  [defaultDate]="date"
  [(isOpenCalendar)]="_isOpenCalendar"
  (datePickerResult)="date = $event">
</lib-nira-date-picker>
```

## How **Set Current Date** To `input` **If** There Is Not Default Date

you might set `selectToday` property to `true` and get current date from `todayDate` like bellow:

```html
<lib-nira-date-picker
 [selectToday]="true"
 (todayDate)="getToday($event)" 
 [(isOpenCalendar)]="isOpen" 
 [defaultDate]="getDefaultDate()"
 (datePickerResult)="date = $event">
</lib-nira-date-picker>
```

---
_Source: https://npm.io/package/nira-date-picker · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._