19 KiB
DatePicker
Utiliza Date Picker para introducir fecha.
<<<<<<< HEAD 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.
Entrar fecha
Selector de fecha básico limitado por día.
:::demo Ésta medición es decidido por el atributo 'type'.Puedes permitir rápidas opcíones por crear un picker-options
objecto con propiedad shortcuts
.La fecha minusválida es establecido por
la función disabledDate
.
<template>
<div class="block">
<span class="demonstration">Default</span>
<el-date-picker
v-model="value1"
type="date"
placeholder="Pick a day">
</el-date-picker>
</div>
<div class="block">
<span class="demonstration">Picker with quick options</span>
<el-date-picker
v-model="value2"
type="date"
placeholder="Pick a day"
:picker-options="pickerOptions1">
</el-date-picker>
</div>
</template>
<script>
export default {
data() {
return {
pickerOptions1: {
disabledDate(time) {
return time.getTime() > Date.now();
},
shortcuts: [{
text: 'Today',
onClick(picker) {
picker.$emit('pick', new Date());
}
}, {
text: 'Yesterday',
onClick(picker) {
const date = new Date();
date.setTime(date.getTime() - 3600 * 1000 * 24);
picker.$emit('pick', date);
}
}, {
text: 'A week ago',
onClick(picker) {
const date = new Date();
date.setTime(date.getTime() - 3600 * 1000 * 24 * 7);
picker.$emit('pick', date);
}
}]
},
value1: '',
value2: '',
};
}
};
</script>
:::
<<<<<<< HEAD
Otras mediciones
Puede seleccionar la semana, el mes o el año extendiendo el componente date picker estándar.
Otras medidas
Puedes escoger semana,mes o año por ampliar el estándar fecha recogedor componente.
:::demo
<div class="block">
<span class="demonstration">Week</span>
<el-date-picker
v-model="value3"
type="week"
format="Week WW"
placeholder="Pick a week">
</el-date-picker>
</div>
<div class="block">
<span class="demonstration">Month</span>
<el-date-picker
v-model="value4"
type="month"
placeholder="Pick a month">
</el-date-picker>
</div>
<div class="block">
<span class="demonstration">Year</span>
<el-date-picker
v-model="value5"
type="year"
placeholder="Pick a year">
</el-date-picker>
</div>
<script>
export default {
data() {
return {
value3: '',
value4: '',
value5: ''
};
}
};
</script>
:::
<<<<<<< HEAD
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
.
el alcance de fecha
escoger un alcance de fecha es apoyado.
:::demo cuando en la modalidad de fecha,los paneles izquierdos y derechoes son enlazados por defecto.Si queres los dos paneles combiar meses corrientes independientemente,puedes utilizar el atributo unlink-panels
.
<template>
<div class="block">
<span class="demonstration">Default</span>
<el-date-picker
v-model="value6"
type="daterange"
range-separator="To"
start-placeholder="Start date"
end-placeholder="End date">
</el-date-picker>
</div>
<div class="block">
<span class="demonstration">With quick options</span>
<el-date-picker
v-model="value7"
type="daterange"
align="right"
unlink-panels
range-separator="To"
start-placeholder="Start date"
end-placeholder="End date"
:picker-options="pickerOptions2">
</el-date-picker>
</div>
</template>
<script>
export default {
data() {
return {
pickerOptions2: {
shortcuts: [{
text: 'Last week',
onClick(picker) {
const end = new Date();
const start = new Date();
start.setTime(start.getTime() - 3600 * 1000 * 24 * 7);
picker.$emit('pick', [start, end]);
}
}, {
text: 'Last month',
onClick(picker) {
const end = new Date();
const start = new Date();
start.setTime(start.getTime() - 3600 * 1000 * 24 * 30);
picker.$emit('pick', [start, end]);
}
}, {
text: 'Last 3 months',
onClick(picker) {
const end = new Date();
const start = new Date();
start.setTime(start.getTime() - 3600 * 1000 * 24 * 90);
picker.$emit('pick', [start, end]);
}
}]
},
value6: '',
value7: ''
};
}
};
</script>
:::
<<<<<<< HEAD
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.
Valor defecto
Si el usuario no se recoge una fecha,monstra la fecha de hoy por defecto. Puedes utilizar default-value
a establecer otra fecha. Su valor deber ser parseable por new Date()
.
Si el tipo es daterange
,default-value
establece el calendario del lado derecho.
:::demo
<template>
<div class="block">
<span class="demonstration">date</span>
<el-date-picker
v-model="value8"
type="date"
placeholder="Pick a date"
default-value="2010-10-01">
</el-date-picker>
</div>
<div class="block">
<span class="demonstration">daterange</span>
<el-date-picker
v-model="value9"
type="daterange"
start-placeholder="Start Date"
end-placeholder="End Date"
default-value="2010-10-01">
</el-date-picker>
</div>
</template>
<script>
export default {
data() {
return {
value8: '',
value9: ''
};
}
};
</script>
:::
<<<<<<< HEAD
Formato del valor
De forma predeterminada, DatePicker emite el objet Date
. Puede utilizar value-format
para designar el formato del valor emitido, acepta la misma cadena de formato del atributo format
.
:::warning Esta característica está en la etapa alfa. Feedback bienvenido.
Valor Formateado
Por defecto,DatePicker emite el objecto Date
. Puedes utilizar value-format
a designar el formato del valor emitido,acepta cadena del formato mismo del atributo format
.
:::warning escenario Ésta característica es en alfa escenario.Bienvenivo a enviar realimentación.
4c81a5c292
:::
:::demo
<template>
<div class="block">
<span class="demonstration">Emits Date object</span>
<div class="demonstration">Value: {{ value10 }}</div>
<el-date-picker
v-model="value10"
type="date"
placeholder="Pick a Date"
format="yyyy/MM/dd">
</el-date-picker>
</div>
<div class="block">
<span class="demonstration">Emits formatted date</span>
<div class="demonstration">Value: {{ value11 }}</div>
<el-date-picker
v-model="value11"
type="date"
placeholder="Pick a Date"
format="yyyy/MM/dd"
value-format="yyyy-MM-dd">
</el-date-picker>
</div>
</template>
<script>
export default {
data() {
return {
value10: '',
value11: '',
};
}
};
</script>
:::
<<<<<<< HEAD
Atributos
Atributo | Descripción | Tipo | Valores aceptados | Por defecto |
---|---|---|---|---|
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 boton 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/datetime/ week/datetimerange/daterange | date |
format | formato en que se muestra el valor en el input | string | año yyyy , mes MM , dia dd , hora HH , minuto mm , segundo ss |
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() |
— |
value-format | opcional, formato del valor enlazado. Si no esta especificado, el valor enlazado será un objeto Date. | string | año yyyy , mes MM , dia dd , hora HH , minuto mm , segundo ss |
— |
name | igual que name en el input nativo |
string | — | — |
unlink-panels | desvincular los dos paneles de fecha en el range-picker | boolean | — | false |
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 | — | — |
firstDayOfWeek | primer dia 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, convm 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 | (event: Event) |
focus | se dispara cuando el input obtiene el foco | (event: Event) |
Metodos
Metodo | Descripción | Parameteros |
---|---|---|
focus | coloca el foco en el input | — |
=======
Atributos
Atributos | Descripción | Tipo | Valores aceptados | Valor por defecto |
---|---|---|---|---|
readonly | Si la escoja de fecha es lectura sola | boolean | — | false |
disabled | Si la escoja de fecha es deshabilitada | boolean | — | false |
size | tamaño de la entrada | string | large/small/mini | — |
editable | Si la entrada es editable | boolean | — | true |
clearable | Si monstrar el botón de despejar | boolean | — | true |
placeholder | placeholder en la modalidad sin-rango | string | — | — |
start-placeholder | placeholder para el comienzo de fecha en la modalidad de alcance | string | — | — |
end-placeholder | placeholder para el fin de fecha en la modalidad de alcance | string | — | — |
type | tipo de la escoja | string | año/mes/fecha/fecha y hora/semana/rango de fecha y hora /rango de fecha | fecha |
formato | formato del valor desplegado en la caja de entrada | cadena | año yyyy , mes MM , día dd , hora HH , minuto mm , segundo ss |
yyyy-MM-dd |
alinear | ||||
alineación | izquierda/centro/derecho | izquierda | ||
popper-class | nombre de clase clientela por dropdown de DatePicker | cadena | — | — |
picker-options | opciones adicionales, comproba la tabla abaja | objeto | — | {} |
range-separator | separador de alcance | cadena | — | '-' |
default-value | fecha opcional y defectada del calendario | Fecha | cualquier cosa aceptada por new Date() |
— |
value-format | opcional,formato de valor atado.Si no special, el valor atado sería ser un valor de fecha | cadena | año yyyy , mes MM , día dd , hora HH , minuto mm , segundo ss |
— |
name | igual que name en la entrada nativa |
cadena | — | — |
unlink-panels | desconectar dos fecha-paneles en alcance-escoja | boolean | — | falso |
Picker Options
Atributo | Descripción | Tipo | Valores aceptados | Defecto |
---|---|---|---|---|
shortcuts | un { text, onClick } objecto serie para establecer opciones atajos, comprobar la mesa abaja | objeto[] | — | — |
disabledDate | una función determinar si la fecha es minusválida con la fecha como su parámetro.Debería devolver un booleano | función | — | — |
firstDayOfWeek | primera día de semana | Number | 1 to 7 | 7 |
onPick | una llama de vuelta cuando la fecha escogida está cambiada. Solamente por daterange y datetimerange . |
Function({ fecha, minDate }) | - | - |
shortcuts
Atributo | Descripción | Tipo | Valores aceptados | Defecto |
---|---|---|---|---|
text | título del atajo | cadena | — | — |
onClick | función de llama de vuelta, gatillos cuando el atajo se hace clic, con el vm como su parámetro. Puedes cambiar el valor de escoja por emitir el evento pick . Ejemplo: vm.$emit('pick', new Date()) |
function | — | — |
Eventos
Nombre de evento | Descripción | Parámetros |
---|---|---|
change | gatillos cuando usuario confirma el valor | valor atado de componente |
blur | gatillos cuando la entrada difumina | (event: Event) |
focus | gatillos cuando la entrada enfoca | (event: Event) |
Métodos
Método | Descripción | Parámetros |
---|---|---|
focus | enfoque la entrada de componente | — |