space-datetime-picker
Installation setup
npm install --save @spacepatate/vue-space-datetime-picker
or
yarn add @spacepatate/vue-space-datetime-picker
Register
import { SpaceDatetimePicker, SpaceDaterangePicker } from '@spacepatate/vue-space-datetime-picker';
import '@spacepatate/vue-space-datetime-picker/dist/vue-space-datetime-picker.css';
export default {
name: 'App',
components: {
SpaceDatetimePicker,
SpaceDaterangePicker,
},
Usage
Date picker
<space-datetime-picker v-model="date"></space-datetime-picker>
With time
<SpaceDatetimePicker v-model="datetime" format="DD/MM/YYYY HH:mm:ss" :showTime="true"></SpaceDateTimePicker>
Select months
Select year
Date range picker
<SpaceDaterangePicker v-model="rangeDatetimes"></SpaceDaterangePicker>
SpaceDatetimePicker Parameters
Parameter | Type | Default | Description |
---|---|---|---|
v-model (required) | Date Date
|
- | Date object |
placeholder | String |
'' |
placeholder for default input field |
format | String |
'' |
format to display in default input field, the default display format is YYYY-MM-DD |
locale | String |
undefined |
BCP47 locales, ex: fr-FR, en-BR, en-US... |
showTime | Boolean |
false |
show time input in date picker |
hour12 | Boolean |
false |
show time in 12 hours format |
weekday | String |
narrow |
display week day in long |
showHome | Boolean |
false |
home icon button allow to return back to current datetime |
disabled | Boolean |
false |
disabled all inputs |
stardingDay | Number |
1 |
define the first day of week, 0 is sunday, 1 for monday... |
SpaceDaterangePicker parameters
Parameter | Type | Default | Description |
---|---|---|---|
v-model (required) |
Date Array |
- | Array of Date object |
placeholder |
String Array |
- | Array of strings, ex: ['start date', 'end date'] |
format | String |
'' |
format to display in default input field, the default display format is YYYY-MM-DD |
locale | String |
undefined |
BCP47 locales, ex: fr-FR, en-BR, en-US... |
weekday | String |
narrow |
display week day in long |
disabled | Boolean |
false |
disabled all inputs |
stardingDay | Number |
1 |
define the first day of week, 0 is sunday, 1 for monday... |
Display format
A valid datetime format is combinated of 'YYYY', 'MM', 'DD' for date and 'HH', 'mm', 'ss' for a valid time
for example MM/DD/YYYY HH:mm:ss is valid for dates like 02/18/2020 00:30:30
Default slot
A default slot is available to replace the default input field
<vue-space-datetime-picker v-model="date">
<div>custom input</div>
</vue-space-datetime-picker>