DateTimePicker
Seleccionar fecha y hora juntos en un picker.
TIP
DateTimePicker es derivado de DatePicker y TimePicker. Para una explicación más detallada sobre los atributos, puede referirse a DatePicker y TimePicker.
Fecha y hora
Puede seleccionar fecha y hora en un selector al mismo tiempo estableciendo type
a datetime
. La forma de utilizar los atajos es la misma que con Date Picker.
Formato de fecha y hora
Utilice format
para controlar el formato del texto visualizado en el input. Utilice value-format
para controlar el formato del valor enlazado.
Por defecto, el componente acepta y emite un objeto Date
.
Revise la lista aquí de todos los formatos disponibles de Day.js.
WARNING
Preste atención a la capitalización
Date and time formats in dropdown panel
Use date-format
and time-format
to control displayed text's format in the dropdown panel's input box.
Date and time range
You can select date and time range by setting type
to datetimerange
.
Default time value for start date and end date
When picking date range on the date panel with type datetimerange
, 00:00:00
will be used as the default time value for start and end date. We can control it with the default-time
attribute. default-time
accepts an array of up to two Date objects. The first item controls time value of the start date and the second item controls time value of the end date.
Custom icon 2.8.0
Custom icons available with slots.
Attributes
Nombre | Descripción | Tipo | Por defecto |
---|---|---|---|
model-value / v-model | valor enlazado, si es un array, la longitud debe ser de 2 | number / string / object | — |
readonly | si DateTimePicker es solo de lectura | boolean | false |
disabled | si DateTimePicker está deshabilitado | boolean | false |
editable | si el input puede ser editado | boolean | true |
clearable | si mostrar el botón de borrado | boolean | true |
size | tamaño del input | enum | default |
placeholder | placeholder en modo no rango | string | — |
start-placeholder | placeholder para el inicio de fecha en el modo rango | string | — |
end-placeholder | placeholder para el fin de fecha en el modo rango | string | — |
arrow-control | si se puede modificar la hora utilizando botones con flechas | boolean | false |
type | tipo del selector | enum | date |
format | formato de valor mostrado en el input | string see date formats | YYYY-MM-DD HH:mm:ss |
popper-class | nombre de clase personalizado para el Dropdown de DatePicker | string | — |
range-separator | separador de rango | string | '-' |
default-value | opcional, fecha predeterminada del calendario | object | — |
default-time | el valor por defecto de la hora después de elegir una fecha. La hora 00:00:00 se utilizará si no se especifica | object | — |
value-format | opcional, formato del valor enlazado. Si no está especificado, el valor enlazado será un objeto Date | string see date formats | — |
date-format 2.4.0 | optional, format of the date displayed value in TimePicker's dropdown | string see date formats | — |
time-format 2.4.0 | optional, format of the time displayed value in TimePicker's dropdown | string see date formats | — |
id | same as id in native input | string / object | — |
name | same as name in native input | string | — |
unlink-panels | unlink two date-panels in range-picker | boolean | false |
prefix-icon | Custom prefix icon component | string / Component | Date |
clear-icon | Custom clear icon component | string / Component | CircleClose |
shortcuts | an object array to set shortcut options | object | — |
disabled-date | a function determining if a date is disabled with that date as its parameter. Should return a Boolean | Function | — |
cell-class-name | set custom className | Function | — |
teleported | whether datetime-picker dropdown is teleported to the body | boolean | true |
empty-values 2.7.0 | empty values of component, see config-provider | array | — |
value-on-clear 2.7.0 | clear return value, see config-provider | string / number / boolean / Function | — |
show-now 2.8.7 | whether to show the now button | boolean | true |
Events
Nombre | Descripción | Parámetros |
---|---|---|
change | se dispara cuando el usuario confirma el valor | valor vinculado del componente |
blur | se dispara cuando el input pierde el foco | (e: FocusEvent) |
focus | se dispara cuando el input obtiene el foco | (e: FocusEvent) |
clear 2.7.7 | triggers when the clear icon is clicked in a clearable DateTimePicker | Function |
calendar-change | se dispara cuando se cambia la fecha seleccionada. Solamente para datetimerange | [Date, Date] |
visible-change | se dispara cuando el desplegable aparece/desaparece | true cuando aparece, y false de otro modo |
Slots
Nombre | Descripción |
---|---|
default | contenido personalizado de la celda |
range-separator | separador de los rangos personalizado |
prev-month 2.8.0 | prev month icon |
next-month 2.8.0 | next month icon |
prev-year 2.8.0 | prev year icon |
next-year 2.8.0 | next year icon |
Exposes
Método | Descripción | Type |
---|---|---|
focus | focus the DatePicker component | Function |
blur 2.8.7 | blur the DatePicker component | Function |