0.4.2 • Published 4 years ago

@domi7891/vuejs-datetime-picker v0.4.2

Weekly downloads
-
License
-
Repository
github
Last release
4 years ago

GitHub top language Version GitHub last commit npm bundle size npm

A date and time picker Vue component.

Support

Install

npm install @domi7891/vuejs-datetime-picker
import {
  Datetimepicker,
  Datepicker,
  Timepicker,
} from '@domi7891/vuejs-datetime-picker'

export default {
  // ...
  components: {
    Datetimepicker,
    Datepicker,
    Timepicker,
    //...
  },
  //...
}

Usage

<datetimepicker></datetimepicker>
<!-- or -->
<datepicker></datepicker>
<!-- or -->
<timepicker></timepicker>

Pass a start value as value. Preferred a Date object Supported String formats:

  • DateTime: MM/dd/yyyy HH:mm, MM.dd.yyyy HH:mm, MM-dd-yyyy HH:mm
  • Date: MM/dd/yyyy, MM.dd.yyyy, MM-dd-yyyy
  • Time: HH:mm
<script>
  var date = new Date()
</script>
<datetimepicker :value="date"></datetimepicker>
<!-- or string May 2, 2020 -->
<datetimepicker :value="05/02/2020"></datetimepicker>

Events

<datetimepicker
  v-on:selected="doWhenDateSelected"
  v-on:cleared="doWhenDateCleared"
></datetimepicker>

Properties

PropertyTypeDefaultDescription
valueDate | StringnoneStart value of the picker
formatString | Function'dd/MM/yyyy HH:mm a'Date format
picker-idString'picker'Id of a picker. When using multiple pickers, specify id for each
input-idStringnoneId of the picker input
nameStringnoneName of the picker input
ref-nameStringnoneReference of the picker input
placeholderStringPick Date-Time or (Date | Time)Placeholder text of the input
input-classString | ObjectnoneCSS class of the input element
time-classString | ObjectnoneCSS class of the time picker
calendar-classString | ObjectnoneCSS class of the date picker
wrapper-classString | ObjectnoneCSS class of the wrapper div
time-buttonsBooleanfalseTo show buttons at the time picker
disabledBooleanfalseDisable the picker
requiredBooleanfalseSet input as required field
editableBooleanfalseInput can be edited by typing
initial-pickerStringlowest-pickerOpen date picker on specified level
lowest-pickerStringdayLowest level of datepicker
highest-pickerStringyearHighest level of datepicker

Events

EventReturn TypeDescription
selectedDate | nullA date or time has beend selected
clearednoneCurrent date or time has beend cleared
pickerOpenednoneA picker has beend opened
pickerClosednoneA picker has beend closed
changedDayObjectA new day has been selected
changedMonthObjectA new month has been selected
changedYearObjectA new year has been selected
changedHourNumberA new hour has been selected
changedMinuteNumberA new minute has been selected

Formats

Function as formatter

A Function can be provided as format value. The values will be passed to the function and returns. A string value has to be the return value of the function.

Example

<script>
  //..
  methods: {
    //..
    formatterFunction(date){
      return `${date.getDate()}.${date.getMonth() + 1}.${date.getFullYear()}`

    }
  }
</script>
<datepicker :format="formatterFunction"></datepicker>

String format

LetterDescriptionExample
dnumbered day3
ddnumbered day with leading 003
Dshort day nameWed
Mnumbered motnh9
MMnumbered month with leading 009
MMMshort month nameSept
MMMMmonth nameSeptember
yy2 digit year20
yyyy4 digit year2020
HHhour with leading 005
mmminute with leading 001
0.4.1

4 years ago

0.4.2

4 years ago

0.4.0

4 years ago

0.3.0

4 years ago

0.2.9

4 years ago

0.2.8

4 years ago

0.2.7

4 years ago

0.2.6

4 years ago

0.2.5

4 years ago

0.2.4

4 years ago

0.2.3

4 years ago

0.2.2

4 years ago

0.2.1

4 years ago

0.2.0

4 years ago

0.1.0

4 years ago