En el siguiente tema se incluye información sobre el widget en ThingWorx 9.3.3 o versión posterior. Si se utiliza una versión anterior de ThingWorx, consulte Widget de selector de fecha y hora.

Se puede utilizar el widget de selector de fecha y hora para permitir a los usuarios seleccionar una sola fecha u hora; o un rango en un mashup. En tiempo de ejecución, el widget se muestra en estado contraído. Al pulsar en el icono de calendario, se abre una vista de calendario en la que se muestran listas desplegables de selección además de los días de cada mes. Las listas desplegables de calendario son cuadros de combinación que soportan la entrada del teclado. Se puede introducir un valor para seleccionar un elemento con mayor rapidez. El botón de calendario permite abrir un calendario emergente en el que se pueden seleccionar fechas de forma interactiva. Se muestran diferentes controles en el calendario según la configuración del selector de fechas. El widget se puede configurar de las siguientes maneras:

Las selecciones de fecha solo se guardan cuando se pulsa en el botón Seleccionar y no se guardan cuando se pulsa en un área fuera del widget o cuando se pulsa la tecla ESC.

Se añaden cuadros de selección adicionales al widget, en función de la selección de fecha configurada. En la siguiente tabla se enumeran las opciones disponibles:

Al seleccionar un rango, la primera selección se utiliza como el inicio del rango. Sin embargo, las fechas se cambian automáticamente para conservar un rango válido cuando la selección de la segunda fecha es anterior a la primera fecha. Además, al pulsar en una nueva fecha, se borra el rango existente y se inicia la selección de un nuevo rango.

Es posible restringir el rango de fechas que está disponible para la selección en el calendario de una de las tres siguientes maneras:

Por defecto, el selector de fecha y hora permite seleccionar fechas. La activación de la selección de horas permite a los usuarios seleccionar una hora específica o un rango de horas, además de las fechas del calendario. Para añadir la selección de horas al widget, defina la propiedad DateOnly del widget en falso. Por defecto, la selección de horas está configurada para horas y minutos. Se puede permitir que los usuarios seleccionen segundos definiendo la propiedad DisplaySeconds en verdadero. En la siguiente imagen se muestra el widget con una selección de horas en la que se incluyen los segundos.

Por defecto, en el widget se muestran todas las fechas. La propiedad MaxRange se puede utilizar para restringir la selección de fecha a un rango específico. Por ejemplo, para definir el rango posible en 20 días. Defina la propiedad DateRange en verdadero y la propiedad MaxRange del panel Validación en 20.

En la siguiente imagen se muestra un valor de rango seleccionado y las fechas que están fuera de rango. El rango se calcula en tiempo de ejecución después de que el usuario seleccione una fecha de inicio o una fecha de fin. MaxRange se encuentra dentro de las fechas mínimas y máximas de inicio y fin. Si se realiza una selección, las fechas que se encuentran fuera del valor definido se desactivan; consulte el ejemplo número 3 en la imagen.

La hora se muestra por defecto con formato de 24 horas. Para mostrar la hora con un formato de 12 horas, defina la propiedad TwelveHourClock del widget en verdadero. Se muestra una lista desplegable adicional para la selección AM o PM.

Utilice la propiedad Interval para desviar el valor seleccionado por defecto en relación con la fecha u hora actual cuando el widget se muestra en tiempo de ejecución. Es posible desviar el valor seleccionado hacia delante o hacia atrás por días, horas, minutos o segundos mediante la propiedad IntervalType. Por ejemplo, para avanzar la hora seleccionada en el widget de selector de fechas en 30 minutos, defina la propiedad IntervalType en Minutos y la propiedad Interval en 30.

Por defecto, el orden de fechas se define automáticamente según la configuración regional del usuario que visualiza el mashup. Por ejemplo, en algunas geografías, las fechas se muestran con el formato día-mes-año, mientras que otras utilizan mes-día-año. Se puede definir manualmente el orden para todos los usuarios mediante la propiedad DateOrder del widget. Cuando se aplica un orden específico, MonthFormat y DateDelimiter se añaden a la lista de propiedades.

Se puede definir el formato de fecha configurando la propiedad FormatToken del widget según la sintaxis de la biblioteca MomentJS. Para obtener más información sobre las opciones de formato para las fechas, consulte Formato de fecha y hora para widgets.

Por defecto, en el widget se muestra una cadena de caracteres que indican el formato de fecha u hora que el widget soporta. Mediante el cuadro de combinación, los usuarios pueden escribir un valor de widget más rápidamente, sin abrir el calendario. Se pueden desactivar las máscaras de entrada al definir la propiedad DisableMaskedInput en verdadero. En la siguiente imagen se muestra una fecha de actualización en la que se muestra una máscara de entrada.

Además de las propiedades comunes, se pueden utilizar las propiedades MaxDate y MinDate para restringir el rango de fechas disponible en el widget. Cuando se selecciona una fecha fuera del rango, se muestra un mensaje de fallo.

Para configurar el mensaje de fallo por defecto, utilice las propiedades MinDateFailureMessage y MaxDateFailureMessage o la propiedad MaxRangeFailureMessage.

Para obtener más información sobre las propiedades de validación comunes, consulte Aplicación de validación a widgets.