Vue-datetime3

---

> Mobile friendly datetime picker for Vue. Supports date, datetime and time modes, i18n and more.

This is a fork and port of Vue 2 vue-datetime by mariomka
to support Vue 3 and typescript. For older versions of Vue refer to aforementioned project.

[//]: # ([](LICENSE))

[//]: # ([](https://npmjs.com/package/vue-datetime))

[//]: # ([](https://www.npmjs.com/package/vue-datetime))

[//]: # ([](https://vuejs.org))

[//]: # ([](https://travis-ci.org/mariomka/vue-datetime))

[//]: # ([](https://codecov.io/gh/mariomka/vue-datetime))

Demo

Go to demo.


Installation

$3

``bash
yarn add luxon vue-datetime3 weekstart
`

Or

`bash
npm install --save luxon vue-datetime3 weekstart
`

weekstart is optional, is used to get the first day of the week.

#### Register

`js
import createApp from 'vue'
import createDatetime from 'vue-datetime'
// You need a specific loader for CSS files
import 'vue-datetime/dist/style.css'

const app = createApp();

app.use(createDatetime());
`

Usage

$3

`html

`

Setup

$3

| Parameter | Type | Default | Description |
|----------------------|-------------------------------|---------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| v-model (required) | ISO 8601 String | - | Datetime. |
| type | String | date | Picker type: date, datetime or time. |
| input-id | String | '' | Id for the input. |
| input-class | String, Array or Object | '' | Class for the input. |
| input-style | String, Array or Object | '' | Style for the input. |
| hidden-name | String | null | Name for hidden input with raw value. See #51. |
| value-zone | String | UTC | Time zone for the value. |
| zone | String | local | Time zone for the picker. |
| format | Object or String | DateTime.DATE_MED, DateTime.DATETIME_MED or DateTime.TIME_24_SIMPLE | Input date format. Luxon presets or tokens. |
| phrases | Object | {ok: 'Ok', cancel: 'Cancel'} | Phrases. |
| use12-hour | Boolean | false | Display 12 hour (AM/PM) mode |
| hour-step | Number | 1 | Hour step. |
| minute-step | Number | 1 | Minute step. |
| min-datetime | ISO 8601 String | null | Minimum datetime. |
| max-datetime | ISO 8601 String | null | Maximum datetime. |
| auto | Boolean | false | Auto continue/close on select. |
| week-start | Number | auto from locale if _weekstart_ is available or 1 | First day of the week. 1 is Monday and 7 is Sunday. |
| flow | Array | Depends of type | Customize steps flow, steps available: time, date, month, year. Example: ['year', 'date', 'time'] |
| title | String | '' | Popup title. |
| hide-backdrop | Boolean | false | Show/Hide backdrop. |
| backdrop-click | Boolean | true | Enable/Disable backdrop click to cancel (outside click). |
| color | String | #3f51b5 | Color theme of the component |
| fixed-date | Boolean | false | Enables 'datetime' to have fixed date, input acts like a time picker, returns datetime value |
| fixed-time | Boolean | false | Enables 'datetime' to have fixed time, input acts like a date picker, returns datetime value |

Input inherits all props not defined above but style and class will be inherited by root element. See inheritAttrs option

The component is based on Luxon, check out documentation to set time zones and format.

$3

Date internationalization depends on luxon. Set the default locale.

`js
import { Settings } from 'luxon'

Settings.defaultLocale = 'es'
`

$3

Component emits the input event to work with v-model. More info.

close event is emitted when the popup closes.

Also, input text inherits all component events.

$3

You can customize the component using named slots.

Available slots: before, after, button-cancel and button-confirm

#### Button customization example:

`html

Field Label
The field description



`

You can also use slot-scope to determine which view is currently active:

`html

`

Theming

Theming is supported by defining a color in props. color should be a valid css
color option, it's default value is #3f51b5.

Development

$3

`bash
npm run test
`

Note: Currently not working. Tests need to be rewritten to ViTest.

$3

`bash
npm run demo
`

$3

Bundle the js and css to the dist folder:

`bash
npm run build
``

License

The MIT License