Ion2-datetime-picker

Ion2 Datetime Picker--An Ionic2 Custom Datetime Picker Component based on ion-multi-picker by raychenfj

Simulate IOS date and time column pickers by ionic2 picker. Default Ionic DateTime Component work with only independent columns that has some validation problems. Also there is min and max issue with time validation. This one helps to solve these problems.

Note: MomentJS requred for using some features of the package

Github: https://github.com/byzg/ion2-datetime-picker

NPM: https://www.npmjs.com/package/ion2-datetime-picker

Demo

Code of this example here

Installation

npm install ion2-datetime-picker --save

Usage

1.Import MultiPickerModule to your app/module.

import { MultiPickerModule } from 'ion2-datetime-picker';

@NgModule({
  declarations: [
    MyApp,
    AboutPage,
    ContactPage,
    HomePage,
    TabsPage,
  ],
  imports: [
    IonicModule.forRoot(MyApp),
    MultiPickerModule //Import MultiPickerModule
  ],
  bootstrap: [IonicApp],
  entryComponents: [
    MyApp,
    AboutPage,
    ContactPage,
    HomePage,
    TabsPage,
  ],
  providers: []
})
export class AppModule {}

2.Add ion-multi-picker to your html template.

    <ion-item>
        <ion-label>Simple TimePicker</ion-label>
        <ion-multi-picker item-content></ion-multi-picker>
    </ion-item>

Note: Don't miss the item-content attribute

Like other ionic components, you can use [formControl] to bind your data.

import { FormBuilder, FormGroup } from '@angular/forms';
...
constructor() {
  this.formGroup = new FormBuilder().group({
    time: [moment().format()]
  });
}

	<ion-item>
        <ion-label>Default Value</ion-label>
        <ion-multi-picker item-content [formControl]="formGroup.controls.time"></ion-multi-picker>
    </ion-item>

Set type to date to use datepicker.

    <ion-item>
        <ion-label>Disabled Picker</ion-label>
        <ion-multi-picker item-content type="date" [formControl]="formGroup.controls.date"></ion-multi-picker>
    </ion-item>

Attributes

| Attribute | Description | Data type | Values | Picker type | Default| |-----------|-------------|-----------|--------|-------------|--------| |item-content|Required, add this attribute so that this custom component can be display correctly under ion-item tag| - | - | all | - | |type| Sets waht to use: date- or timepicker | String | date or time| - | time | |displayFormat| Format of picked data | String | moment formats | all | DD.MM.YYYY HH:mm | |pickerFormat| Format of picking data. Note: now supports only months | String | moment formats | date | displayFormat | | min | Validation minimum attribute | ISO 8601 String or moment.Moment | | time | Beginning of the year, which precedes the current 2 years | | max | Validation maximum attribute | ISO 8601 String or moment.Moment | | time | End of the year that follows the current 2 years | | minuteRounding | Minutes will be equal this one or aliquot | String or Number | 60 must be divisible by this | time | 1 | | cancelText | Text of picker cancel button | String | | all | Cancel | | doneText | Text of picker done button | String | | all | Done | | weekends | Numbers of days of week that should be disabled on datepicker. Note: Monday is the first day and Sunday is a seventh day | String or Array of string | E.g.: ['6', '7'] | date | [] | | filterDays | Function like (days, month, year)=> that should return array of day numbers that should NOT be disabled in given month and year | Function | E.g.: (days, month, year)=> days | date | Lodash identity | | dateContext | By default if initail model value is given then date of min and max setups to date of this model value. But if initail model value is given is not given then date of min and max setups to current date. Set dateContext attribute to change it | ISO 8601 String or moment.Moment | | time | |

Exceptions

If for some reason, all the possible values of the column are non-valid, this exception is raised:

• Ion2 datetime picker: column "<column.name> " should have at least one option -

Utils

You can use some utils methods:

import { MultiPickerUtils } from 'ion2-datetime-picker';

let variable = MultiPickerUtils.minuteRound('2016-12-10T11:32:44+03:00', 15);

• minuteRound(val: string|moment.Moment, rounding: number): moment.Moment

Returns nearest from below moment for val with minutes that multiple for rounding

Contribution

Welcome issue report, PR and contributors. Help me improve it.

Fork and git clone this project, most code for the multi picker is under src/app/components/multi-picker.

The unit test framework is karma + webpack + jasmine. And e2e test is protractor.

Add your unit test and use npm test to start karma.

Debug your unit test using npm run test-watch and open http://localhost:9876/debug.html

Add your e2e test, run ionic serve and then in another terminal use npm run e2e to run protractor.

You can also add your use case in the app/pages.

Finally, send me a PULL REQUEST.

Build

gulp default npm publish

License

MIT