# cordova-plugin-materialdatetime

> A cordova plugin based on material Date and Time pickers

Latest version **0.1.1** (published 2018-09-26) · MIT license · 0 weekly downloads

## Install

```sh
npm install cordova-plugin-materialdatetime
pnpm add cordova-plugin-materialdatetime
yarn add cordova-plugin-materialdatetime
bun add cordova-plugin-materialdatetime
```

## Health

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

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.1 |
| Published | 2018-09-26 |
| First published | 2018-09-26 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 59.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | moda20 |
| Maintainers | moda20 |
| Keywords | ecosystem:cordova, cordova-android |

## Links

- npm: https://www.npmjs.com/package/cordova-plugin-materialdatetime
- npm.io page: https://npm.io/package/cordova-plugin-materialdatetime

## Alternatives

- [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads
- [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads
- [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads
- [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads
- [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads

## Recent versions

- 0.1.1 (latest) — 2018-09-26
- 0.1.0 — 2018-09-26

## README

# Cordova Material DateTime Picker

**Based On :** 
Material DateTime : https://github.com/wdullaer/MaterialDateTimePicker


**Cordova plugin : cordova-plugin-materialdatetime** 

Platforms available : **android**


***install :***

1 ) run `cordova plugin add https://github.com/moda20/cordova-plugin-MaterialDateTimePicker.git`

2 ) use directly from the `window` available `cordova` object.

# Usage

***Example :***

```Javascript
let DatePickerargs = {
            title: 'title',
            color: '#c60808',
            oktext: 'Ok', // OK button text
            canceltext: 'No', // Cancel button text
            mindate: '', // MUST BE IN dd-MM-yyyy format
            maxdate: '', // MUST BE IN dd-MM-yyyy format
            highlitedDates: ['', ''], // DATES MUST BE IN dd-MM-yyyy format
            showyearpickerbeforemonth: false,
            vibrateontouch: true,
            autodismiss: true, // DIsmiss when choosing a date automatically
        }

        let Timepickerargs = {
            title: 'title',
            color: '#c60808',
            oktext: '', // OK button text
            canceltext: '', // Cancel button text
            /*     mintime:'', // ARRAY of HOURS, MINUTES, SECONDS [23,12,44]
                 maxtime:'', // ARRAY of HOURS, MINUTES, SECONDS [23,12,44]*/
            enableSeconds: false,
            enableminute: true,
            vibrateontouch: true,
        }

        window.cordova.plugins.CordovaMaterialDateTime.TimePicker(Timepickerargs).then(
            function (res) {
                console.log(res);
            }
        ).catch(e => {
            console.log(e);
            alert("Errored")
        })
```
***Docs :***
```
The `CordovaMaterialDateTime` has only Two method : `TimePicker` and `DatePicker`.
```

# TimePicker
**The function arguments are a single object** 


| Attribute      | Description                                                                            | Type                        |
|----------------|----------------------------------------------------------------------------------------|-----------------------------|
| title          | a title to display on top of the  timepicker                                           | String                      |
| color          | the general color for the time picker. includes the circle headed arrow and the  title | String, ex :#c60808         |
| oktext         | The text for the OK button                                                             | String                      |
| canceltext     | the text for the cancel button                                                         | String                      |
| mintime        | an array of the minimum time possible to  pick : [hours,minutes,seconds]               | Array of Int, ex [23,12,44] |
| maxtime        | an array of the maximum time possible to  pick : [hours,minutes,seconds]               | Array of Int, ex [23,12,44] |
| enableSeconds  | whether to enable or disable the seconds  picker defaults to False                     | Boolean                     |
| enableminute   | whether to enable or disable the minutes  picker defaults to False                     | Boolean                     |
| vibrateontouch | Wether to vibrate when touching the time picker  or not                                | Boolean                     |
    

The `TimePicker` function returns a promise that resolves with the time chosen. 

# DatePicker
**The function arguments are a single object** 


| Attribute                 | Description                                                                            | Type                                                               |
|---------------------------|----------------------------------------------------------------------------------------|--------------------------------------------------------------------|
| title                     | a title to display on top of the  timepicker                                           | String                                                             |
| color                     | the general color for the time picker. includes the circle headed arrow and the  title | String, ex :#c60808                                                |
| oktext                    | The text for the OK button                                                             | String                                                             |
| canceltext                | the text for the cancel button                                                         | String                                                             |
| mindate                   | an array of the minimum time possible to  pick : [hours,minutes,seconds]               | String, must be date in the`dd-MM-yyyy` format                     |
| maxdate                   | an array of the maximum time possible to  pick : [hours,minutes,seconds]               | String,  must be date in the`dd-MM-yyyy` format                    |
| highlitedDates            | Dates that are highlighted in the calendar :                                           | Array of String,[] Strings must be date in the `dd-MM-yyyy` format |
| showyearpickerbeforemonth | whether to show the year picker before the month's                                     | Boolean                                                            |
| vibrateontouch            | whether to vibrate when touching the time picker  or not                               | Boolean                                                            |
| autodismiss               | whether to dismiss the datepicker automatically  when the user chooses a date          | Boolean                                                            |

The `DatePicker` function returns a promise that resolves with the chosen date. 

```
Plugin.xml :

You may have to change the com.android.support:appcompat-v7:27.1.1 to a certain version.
Note that this version needs to be unique with all components in your app, so make sure you have it fixed.

```

# ChangeLog
 
    
# Licence 

MIT

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