@nader-eloshaiker/mat-datetimepicker-moment

Material Datetimepicker for @angular/material 8 and 9

Demo

You can view this component in action on github pages

Note: link has been fixed for the demo

Versions

• download v4.x.x for Angular 8
• download v5.x.x for Angular 9.x

Description

The datetimepicker is taken from Promact/md2 and modified to use @angular/material as base and added theming support. Angular v8 migration is based upon v7 from kuhnroyal

Like the @angular/material datepicker it contains a native-datetime-adapter as well as a moment-datetime-adapter.

Usage

Installation

Install:

npm install @nader-eloshaiker/mat-datetimepicker

And for the moment adapter:

npm install @angular/material-moment-adapter
npm install @nader-eloshaiker/mat-datetimepicker-moment

Setup

Basically the same way the @angular/material datepicker is configured and imported.

imports: [
  ...
  MatDatepickerModule,
  // use this if you want to use native javascript dates and INTL API if available
  // MatNativeDatetimeModule,
  MatMomentDatetimeModule,
  MatDatetimepickerModule
]

@see src/app/app.module.ts

Using the component

<form [formGroup]="group">
  <mat-form-field>
    <mat-placeholder>Start DateTime</mat-placeholder>
    <mat-datetimepicker-toggle [for]="datetimePicker" matSuffix></mat-datetimepicker-toggle>
    <mat-datetimepicker #datetimePicker type="datetime" openOnFocus="true" timeInterval="5"></mat-datetimepicker>
    <input matInput formControlName="start" [matDatetimepicker]="datetimePicker" required autocomplete="false">
  </mat-form-field>
</form>

Date formatting

In order to change the default input/output formats, a custom instance of MAT_DATETIME_FORMATS needs to be provided in the global configuration.

Input/output formats can be changed separately for the existing datetime picker types date, month , datetimeand time.

Native

Parsing does not work with the native adapter because the Intl.DateTimeFormat API does not provide that feature.

  providers: [
    {
      provide: MAT_DATETIME_FORMATS,
      useValue: {
        parse: {},
        display: {
          dateInput: {year: "numeric", month: "2-digit", day: "2-digit"},
          monthInput: {month: "long"},
          datetimeInput: {year: "numeric", month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit"},
          timeInput: {hour: "2-digit", minute: "2-digit"},
          monthYearLabel: {year: "numeric", month: "short"},
          dateA11yLabel: {year: "numeric", month: "long", day: "numeric"},
          monthYearA11yLabel: {year: "numeric", month: "long"},
          popupHeaderDateLabel: {weekday: "short", month: "short", day: "2-digit"}
      }
    }
  ]

@see defaults in native-datetime-formats.ts
@see Intl.DateTimeFormat API documentation

Moment

  providers: [
    {
      provide: MAT_DATETIME_FORMATS,
      useValue: {
        parse: {
          dateInput: "L",
          monthInput: "MMMM",
          timeInput: "LT",
          datetimeInput: "L LT"
        },
        display: {
          dateInput: "L",
          monthInput: "MMMM",
          datetimeInput: "L LT",
          timeInput: "LT",
          monthYearLabel: "MMM YYYY",
          dateA11yLabel: "LL",
          monthYearA11yLabel: "MMMM YYYY",
          popupHeaderDateLabel: "ddd, DD MMM"
        }
      }
    }
  ]

@see defaults in moment-datetime-formats.ts
@see moment.js documentation

Theming

@import '~@nader-eloshaiker/mat-datetimepicker/datetimepicker/datetimepicker-theme.scss';

// Using the $theme variable from the pre-built theme you can call the theming function
@include mat-datetimepicker-theme($theme);

@see src/styles.scss

Development

Performing a local build

npm install
npm build

Running the sample app locally

npm install
npm run build
npm run start

Using the local build in some project

cd my-project

Add the dependencies to your package.json:

"dependencies": {
    "@nader-eloshaiker/mat-datetimepicker": "4.0.0",
    "@nader-eloshaiker/mat-datetimepicker-moment": "4.0.0",
}

Link the local built modules:

npm link "@nader-eloshaiker/mat-datetimepicker"
npm link "@nader-eloshaiker/mat-datetimepicker-moment"