## DatePicker Utilice Date Picker para introducir la fecha. ### Ingresar Fecha Date Picker básico por "día". :::demo La medida está determinada por el atributo `type` . Puede habilitar las opciones rápidas creando un objeto `picker-options` con la propiedad `shortcuts`. La fecha desactivada se ajusta mediante `disabledDate`, que es una función. ```html ``` ::: ### Otras mediciones Puede elegir la semana, el mes, el año o varias fechas ampliando el componente estándar del selector de fechas. :::demo ```html
Week
Month
Year
Dates
``` ::: ### Rango de fechas Se soporta la selección de un rango de fechas. :::demo En modo de rango, los paneles izquierdo y derecho están vinculados por defecto. Si desea que los dos paneles cambien los meses actuales de forma independiente, puede utilizar el atributo `unlink-panels`. ```html ``` ::: ### Rango de mes Se admite la selección de un intervalo de un mes. :::demo Cuando se encuentra en el modo de rango, los paneles izquierdo y derecho están enlazados de forma predeterminada. Si desea que los dos paneles cambien de año en curso de forma independiente, puede utilizar el atributo unlink-panels. ```html ``` ::: ### Valor por defecto Si el usuario no ha escogido una fecha, muestra el calendario de hoy por defecto. Puede utilizar `default-value` para fijar otra fecha. Su valor debe ser definido por `new Date()`. Si el tipo es `daterange`, `default-value` establece el calendario del lado izquierdo. :::demo ```html ``` ::: ### Formatos de Date Utilice `format` para controlar el formato del texto visualizado en el input. Utilice `value-format` para controlar el formato del valor vinculado. Por defecto, el componente acepta y emite un objeto Date. A continuación se soportan cadenas de formato, usando UTC 2017-01-02 03:04:05 como ejemplo: :::warning Preste atención a la capitalización ::: | formato | significado | nota | ejemplo | | ----------- | ------------ | ---------------------------------------- | ------------- | | `yyyy` | año | | 2017 | | `M` | mes | no acepta 0 | 1 | | `MM` | mes | | 01 | | `W` | semana | solamente para semanas en picker's `format`; no acepta 0 | 1 | | `WW` | semana | solamente para semanas en picker's `format` | 01 | | `d` | dia | no acepta 0 | 2 | | `dd` | dia | | 02 | | `H` | hora | 24-hora reloj; no acepta 0 | 3 | | `HH` | hora | 24-hora reloj | 03 | | `h` | hora | 12-hora reloj; debe usarse con `A` o `a`; no acepta 0 | 3 | | `hh` | hour | 12-hora reloj; debe usarse con `A` o `a` | 03 | | `m` | minuto | no acepta 0 | 4 | | `mm` | minuto | | 04 | | `s` | segundo | no acepta 0 | 5 | | `ss` | segundo | | 05 | | `A` | AM/PM | solamente para `format`, mayusculas | AM | | `a` | am/pm | solamente para `format`, minúsculas | am | | `timestamp` | JS timestamp | solamente para `value-format`; valor vinculado debe ser un `number` | 1483326245000 | | `[MM]` | No hay caracteres de escape | Para escapar de los caracteres, colóquelos entre corchetes (ejemplo: [A] [MM]). | MM | :::demo ```html ``` ::: ### Hora por defecto para comienzo y fin de fecha Al seleccionar un intervalo de fechas, puede asignar la hora para la fecha de inicio y la fecha final. :::demo Por defecto, la hora de la fecha de inicio y final es `00:00:00`. Configurar `default-time` puede cambiar la hora respectivamente. Acepta un array de hasta dos cadenas con el formato `12:00:00`. La primera cadena fija la hora para la fecha de inicio y la segunda para la fecha final. ```html ``` ::: ### Atributos | Atributo | Descripción | Tipo | Valores aceptados | Por defecto | | ----------------- | ---------------------------------------- | ----------------- | ---------------------------------------- | -------------------- | | value / v-model | valor enlazado | date(DatePicker) / array(DateRangePicker) | — | — | | readonly | si DatePicker es solo de lectura | boolean | — | false | | disabled | si DatePicker esta deshabilitado | boolean | — | false | | size | tamaño del input | string | large/small/mini | — | | editable | si el input es editable | boolean | — | true | | clearable | si se muestra el botón de borrado | boolean | — | true | | placeholder | placeholder cuando el modo NO es rango | string | — | — | | start-placeholder | placeholder para la fecha de inicio en modo rango | string | — | — | | end-placeholder | placeholder para la fecha final en modo rango | string | — | — | | type | tipo de picker | string | year/month/date/dates/datetime/ week/datetimerange/daterange/ monthrange | date | | format | formato en que se muestra el valor en el input | string | ver [date formats](#/es/component/date-picker#date-formats) | yyyy-MM-dd | | align | alineación | left/center/right | left | | | popper-class | nombre de clase personalizada para el dropdown de DatePicker | string | — | — | | picker-options | opciones adicionales, chequee la tabla debajo | object | — | {} | | range-separator | separador de rangos | string | — | '-' | | default-value | opcional, valor por defecto para el calendario | Date | cualquiera aceptado por `new Date()` | — | | default-time | opcional, los valores para las horas que se deben usar en la seleccion de fechas cuando se usa el modo rango | string[] | Array de dos valores, cada uno es un string del estilo `12:00:00`. El primer elemento es para la fecha de inicio y el segundo es para la fecha final. | — | | value-format | opcional, formato del valor enlazado. Si no esta especificado, el valor enlazado será un objeto Date. | string | ver [date formats](#/es/component/date-picker#date-formats) | — | | name | igual que `name` en el input nativo | string | — | — | | unlink-panels | desvincular los dos paneles de fecha en el range-picker | boolean | — | false | | prefix-icon | Clase personalizada para el icono prefijado | string | — | el-icon-date | | clear-icon | Clase personalizada para el icono `clear` | string | — | el-icon-circle-close | ### Opciones del Picker | Atributo | Descripción | Tipo | Valores aceptados | Por defecto | | -------------- | ------------------------------------------------------------ | ------------------------------ | ----------------- | ----------- | | shortcuts | { text, onClick } un array de objetos para establecer opciones de acceso directo, verifique la tabla siguiente | object[] | — | — | | disabledDate | una función que determina si una fecha está desactivada con esa fecha como parámetro. Debería devolver un valor booleano | function | — | — | | cellClassName | establecer nombre de clase personalizado | Function(Date) | — | — | | firstDayOfWeek | primer día de la semana | Number | 1 to 7 | 7 | | onPick | una función que se dispara cuando se cambia la fecha seleccionada. Solamente para `daterange` y `datetimerange`. | Function({ maxDate, minDate }) | - | - | ### Accesso directo | Atributo | Descripción | Tipo | Valores aceptados | Por defecto | | -------- | ---------------------------------------- | -------- | ----------------- | ----------- | | text | título del acceso directo | string | — | — | | onClick | una función se dispara al hacer clic en el acceso directo, con`vm`como parámetro. Puede modificar el valor del picker emitiendo el evento `pick`. Ejemplo: `vm.$emit('pick', new Date())` | function | — | — | ### Eventos | Nombre | Descripción | Parametros | | ------ | ---------------------------------------- | ---------------------------- | | change | se dispara cuando el usuario confirma el valor | valor enlazado al componente | | blur | se dispara cuando el input pierde el foco | instancia del componente | | focus | se dispara cuando el input obtiene el foco | instancia del componente | ### Metodos | Metodo | Descripción | Parameteros | | ------ | -------------------------- | ----------- | | focus | coloca el foco en el input | — | ### Slots | Name | Description | | --------------- | ------------------------------------- | | range-separator | Separador de los rangos personalizado |