@mutt/widget-datetime

Mutt Forms Widget - Date and Time Input
632
Install
npm install @mutt/widget-datetime
Latest Version:1.8.0
Vue:2
License:MIT
Last Updated:Apr 22, 2021
Links: npm
Maintainer: stevenroberts-bbm

Mutt Forms Widget - Datetime

Mutt Forms Vue widget for date and time entry.

Field Options

The datetime widget accepts the following options:

option type description default
min ISO-8601 formatted String The minimum date allowed null
max ISO-8601 formatted String The maximum date allowed null
dateFormat String The date fields and the order in which you wish them to appear 'day-month-year'
showTime Boolean If true, will display hour, minute and seconds fields after the date fields false
default Date or String The default date to set null
hideDay Boolean Can be used to hide the day field - better to set dateFormat instead where possible false
dateFieldSeparator String A character or string of characters that adds a span containing the character between the date field inputs

Emitted events

When a valid date format is entered (i.e. a complete and existing date) the widget will emit the dateValidated event with the following object:

key: this.field.name,
value: this.field.value,
action: 'populated',
validated, // true if the date passes all other validation rules, e.g min/max
bubble: true,

Complete Example

The following example sets the minumum date to Today minus 40 years and the maximum date to Today minus 4 weeks.

dob: {
  help:
    '<p>If you don’t know the exact date of birth, please provide a considered estimate.</p>',
  label: null,
  max: 'P-4W',
  min: 'P-40Y',
  natural: {
    prefix: ' and you were born on ',
    suffix: '.',
    title: 'What is your date of birth?',
    trigger: '',
  },
  serialize: 'date',
  widget: 'naturaldatetime',
  dateFieldSeparator: '/'
},

The following example sets the date format to year/month/day.

dob: {
  help:
    '<p>If you don’t know the exact date of birth, please provide a considered estimate.</p>',
  label: null,
  dateFormat: 'year-month-day'
  natural: {
    prefix: ' and you were born on ',
    suffix: '.',
    title: 'What is your date of birth?',
    trigger: '',
  },
  serialize: 'date',
  widget: 'naturaldatetime',
},

Related Packages

@mutt/widget-personnummer

Mutt Forms Widget - Swedish Personnummer Input

868
mutt-forms-vue

Mutt forms - VueJS integration

1,674
@mutt/widgets-vue

Mutt forms - VueJS integration

1,582
@formio/vue

A vue.js renderer for form.io forms.

73,476 122
vue-formio

A vue.js renderer for form.io forms.

33,583 122

Version History

Version Released Vue License
1.8.0 ^2.5.21 MIT
1.7.0 ^2.5.21 MIT
1.6.1 ^2.5.21 MIT
1.6.0 ^2.5.21 MIT
1.5.1 ^2.5.21 MIT
Pre-releases (2)
Version Released Vue License
1.8.0-beta.0 ^2.5.21 MIT
1.7.0-beta.0 ^2.5.21 MIT