Control Selector de fecha y hora

Este control es una interfaz de usuario en la que un usuario puede ver y especificar una fecha y hora en un campo de entrada o en un widget de calendario. Este control se utiliza generalmente cuando se necesita una fecha en un coach.

En los dispositivos móviles con sistema operativo Android o iOS, el control Selector de fecha y hora muestra el selector nativo de fecha y hora que se incluye con el sistema operativo. Este comportamiento significa que los usuarios ven distintos selectores de fecha y hora. Por ejemplo, en un sistema operativo Android, un usuario podría trabajar en una tarea con Google Chrome y ver el selector de fecha y hora nativo de Android. Si el usuario cambia a un iPhone de Apple, en su lugar verá el selector de fecha y hora de nativo de iOS.

Aunque la fecha se almacena en una hora UTC, la fecha y la hora que se muestra se ajusta para el huso horario del sistema del usuario.

Restricciones y limitaciones

Si el usuario escribe contenido que no es una fecha completa o no tiene un formato válido, el elemento de datos enlazado es nulo cuando el usuario desencadena un suceso de límite, como por ejemplo pulsar un botón. Si el flujo vuelve al coach, el control está vacío. Los demás controles que están enlazados al mismo elemento de datos también están vacíos.

Utilizar los selectores nativos de fecha y hora significa que algunas opciones de configuración no se aplican, como por ejemplo las propiedades siguientes:

Días de la semana inhabilitados
Fechas de Inactividad
Fecha de inicio de prohibición de operaciones
Fecha de finalización de prohibición de operaciones
Inicio de semana
Tipo de calendario (cuando se selecciona Hebreo o Islámico)
Tipo de selector de fecha (cuando se selecciona en línea)

Enlace de datos

Defina o modifique el enlace de datos para el control en la pestaña de propiedades Generales. El enlace de datos contiene la fecha y hora iniciales a mostrar y almacena las actualizaciones de este valor. El tipo de datos es Date.

Propiedades de configuración

Puede definir o modificar las propiedades de configuración del control, como por ejemplo las propiedades de aspecto y comportamiento, en la pestaña de propiedades de Configuración.

Tamaño de pantalla: Una propiedad de configuración que tenga el icono Tamaños de pantalla además del nombre de propiedad, puede tener distintos valores para cada tamaño de pantalla. Si no define un valor, el tamaño de la pantalla hereda el valor del siguiente tamaño de pantalla más grande como su valor predeterminado. Si está utilizando el editor del escritorio de Process Designer, está estableciendo el valor para el tamaño de pantalla grande. Los otros tamaños de pantalla heredan este valor.

Definiciones de temas: Las definiciones de temas especifican los colores y estilos de un control y determinan el aspecto del control. Puede obtener una vista previa del aspecto de los controles en el editor de temas. Consulte Temas.

En la tabla siguiente se muestran las propiedades de configuración del aspecto del control Selector de fecha y hora:

Tabla 1. Propiedades de configuración del aspecto del control Selector de fecha y hora
Propiedad de configuración del aspecto	Descripción	Tipo de datos
Tipo de selector de fecha	El tipo de visualización de calendario para el control Selector de fecha y hora: Entrada de texto: Esta visualización de calendario dispone de un recuadro de entrada de texto e inicialmente oculta el calendario. Cuando se pulsa en el recuadro de texto se visualiza el calendario. En línea: Esta visualización de calendario dispone de un calendario en línea y oculta el recuadro de entrada de texto. El valor predeterminado es Entrada de texto.	`DatePickerType`
Anchura	La anchura del control Selector de fecha y hora cuando se ha seleccionado el tipo Entrada de texto en la propiedad Tipo de selector de fecha. Puede especificar la anchura en `px` (píxeles), en `%` (porcentaje) o en unidades `em`. Por ejemplo, `200px`. Si no se especifica ningún tipo de unidad con el valor numérico, se presupone que es `px` De forma predeterminada, no hay ninguna anchura especificada.	`String`
Tamaño	El tamaño del texto del control, el tamaño del texto de etiqueta y la cantidad de relleno alrededor del texto. Por ejemplo, para que el texto y la etiqueta sean más legibles en los teléfonos inteligentes, puede establecer esta opción de configuración en `Grande` para compensar el tamaño pequeño de la pantalla.	`TextSizeStyle`
Colocación de etiqueta	La ubicación de colocación etiqueta para el control.	`LabelPlacement`
Formato	El formato utilizado para mostrar y analizar texto que se entra en el campo de texto, como por ejemplo `MM/dd/aaaa` o `dd/MM/aaaa`. Esta opción de configuración admite los mismos formatos que `SimpleDateFormat` de Java™. Para obtener información, consulte el tema Clase SimpleDateFormat. Esta opción de configuración solo se aplica cuando un navegador no tiene un selector nativo de fecha y hora.	`String`
Inicio de semana	El día con que empieza la semana. El valor predeterminado es Domingo.	`DatePickerWeekStart`
Días de la semana inhabilitados	Uno o más días de la semana que se bloquearán en el calendario. De forma predeterminada, no hay ningún día inhabilitado.	`DatePickerDisabledWeekDays`
Mostrar botón Hoy	Mostrar u ocultar el botón Hoy, que establece la fecha con el valor de la fecha de hoy. De forma predeterminada, este botón no se muestra.	`Boolean`
Mostrar botón Borrar	Mostrar u ocultar el botón Borrar, que borra el valor de fecha. De forma predeterminada, este botón no se muestra.	`Boolean`
Orientación	Las orientaciones del calendario cuando se pulsa en el mismo.	`DatePickerOrientation`
Estilo de color	El estilo de color del control. Los colores corresponden a variables en el tema especificado. El valor predeterminado es Predeterminado(azul oscuro).	`DatePickerColorStyle`
Mostrar número de semana	En los calendarios gregorianos, muestra el número de semana dentro del año. Por ejemplo, la última semana de un año gregoriano es la semana número `52`. De forma predeterminada, no se muestra el número de semana.	`Boolean`
Resaltar hoy	Especifica si se muestra resaltada la fecha de hoy en el calendario. De forma predeterminada, la fecha de hoy no aparece resaltada.	`Boolean`
Ocultar cabecera	Ocultar la cabecera en la parte superior del selector de fecha y hora personalizado. De forma predeterminada, la cabecera no está oculta.	`Boolean`

En la tabla siguiente se muestran las propiedades de configuración del comportamiento del control Selector de fecha y hora:

Tabla 2. Propiedades de configuración del comportamiento del control Selector de fecha y hora
Propiedad de configuración del comportamiento	Descripción	Tipo de datos
Solo selector personalizado	Mostrar siempre el selector de fecha y hora en los dispositivos móviles en lugar del selector de fecha y hora nativo. En los dispositivos móviles, siempre se intenta inicialmente mostrar el selector de fecha y hora nativo. No obstante, siempre que se especifica alguna de las siguientes propiedades de configuración no soportadas, se muestra el selector de fecha y hora personalizado: Días de la semana inhabilitados Fechas de Inactividad Fecha de inicio de prohibición de operaciones Fecha de finalización de prohibición de operaciones Inicio de semana Tipo de calendario (cuando se selecciona Hebreo o Islámico) Tipo de selector de fecha (cuando se selecciona en línea) De forma predeterminada, se utiliza el selector de fecha y hora personalizado y el selector de fecha y hora nativo según corresponda en cada momento.	`Boolean`
Incluir selector de tiempo	Mostrar el selector de hora con el control Selector de fecha y hora. De forma predeterminada, el selector de hora no se muestra.	`Boolean`
Tipo de calendario	El tipo de calendario: Gregoriano Hebreo Islámico El valor predeterminado es Gregoriano.	`CalendarType`
Índice de pestañas	El índice de secuencia de las pestañas del control de formulario. Los índices de pestañas empiezan en 1 y se pueden establecer de forma dispersa. Por ejemplo, puede utilizar 1, 5, 10. La propiedad Índice de pestañas controla la secuencia de las pestañas al desplazarse entre las distintas áreas de un coach pulsando la tecla Tabulador.	`String`
Texto de marcador de posición	El texto de marcador de posición a utilizar cuando no se ha especificado ninguna fecha. generalmente, el texto es una breve descripción o ejemplo de la entrada que requiere el usuario. Si el elemento de datos enlazados no contiene un valor, los usuarios verán la sugerencia hasta que escriban en el campo. De forma predeterminada, no hay ningún texto de marcador de posición especificado.	`String`
Fecha de inicio disponible	Especifica la fecha y hora de inicio disponible. Todas las fechas anteriores a la fecha de inicio disponible se bloquean. El formato de la fecha de inicio disponible se especifica en la propiedad Formato de las propiedades de aspecto. De forma predeterminada, no hay ninguna fecha de inicio disponible especificada.	`Date`
Fecha de finalización disponible	La fecha y hora de finalización disponible. Todas las fechas posteriores a la fecha de finalización disponible se bloquean. El formato de la fecha de finalización disponible se especifica en la propiedad Formato de las propiedades de aspecto. De forma predeterminada, no hay ninguna fecha de finalización disponible especificada.	`Date`
Fechas de Inactividad	Una fecha o una lista de varias fechas no consecutivas a descartar. Si se proporciona una lista de fechas de prohibición de operaciones, el control utiliza el selector de fecha y hora personalizado en lugar del selector de fecha y hora del navegador nativo. De forma predeterminada, no se especifican fechas de prohibición de operaciones.	`Date (Lista)`
Fecha de inicio de prohibición de operaciones	La fecha de inicio de un rango de fechas consecutivas que desea descartar. De forma predeterminada, no hay ninguna fecha de inicio de prohibición de operaciones especificada.	`Date`
Fecha de finalización de prohibición de operaciones	La fecha de finalización de un rango de fechas consecutivas que desea descartar. De forma predeterminada, no hay ninguna fecha de finalización de prohibición de operaciones especificada.	`Date`
Vista de inicio	El nivel de granularidad con el que se debe iniciar el calendario: Mes Año Década El valor predeterminado es Mes.	`DatePickerStartView`
Modalidad de vista mínima	Los niveles de granularidad de fecha mínimos a utilizar en el calendario. Días Meses Años El valor predeterminado es Días.	`DatePickerMinViewMode`
Sin cierre automático	Especifica que el calendario no se cerrará cuando se seleccione una fecha. En vez de eso, el calendario se cerrará cuando el control pierda el foco. De forma predeterminada, el calendario se cierra automáticamente cuando se selecciona una fecha.	`Boolean`

Ejemplo

Si desea tener un botón de calendario en el que se pueda pulsar, puede colocar un control Selector de fecha y hora dentro de un control de grupo de entrada. En las propiedades del control de grupo de entrada, defina la propiedad Tipo de botón a Icono y defina la propiedad Información de botón a calendario. En el suceso Al pulsar el botón del control de grupo de entrada, escriba la siguiente serie.

${Control_ID}._instance.pickerControl.show();

Sucesos

Establezca o modifique los manejadores de sucesos para el control en la pestañaSucesos. Puede definir que los sucesos se desencadenen mediante programación o cuando el usuario interactúa con el control. Para obtener información sobre cómo definir y codificar sucesos, consulte Sucesos definidos por el usuario. El control Selector de fecha y hora tiene los siguientes tipos de manejadores de sucesos:

Al cargar: Se activa cuando se carga la página. Por ejemplo:
var workerStart = ${StartDate}.getDate(); me.setStart(workerStart);
Al cambiar: Se activa cuando se detecta un cambio. Por ejemplo:
return confirm("¿Está seguro de que desea modificar la fecha?")
En representación de celda de día: Se activa cuando hay una representación de celda de día. Se desencadena antes de que se muestre la fecha en el control. Por ejemplo:
me.setDate("01/01/2015")

Según el suceso específico, puede utilizar lógica de JavaScript para modificar los efectos del control. Puede obtener más información sobre la utilización de sucesos con controles en el tema Sucesos definidos por el usuario.

Métodos

Para obtener información detallada sobre los métodos disponibles para el control Selector de fecha y hora, consulte la documentación de JavaScript.

Recursos adicionales

Para obtener información sobre cómo crear un coach, consulte Creación de coaches.
Para obtener información sobre las propiedades estándar (General, Configuración, Posicionamiento, Visibilidad y Atributos HTML), consulte Propiedades de vista de coach.