Widget de selector de fecha y hora (con temas)
El selector de fecha y hora permite al usuario seleccionar valores de fecha y hora en un mashup. En tiempo de ejecución, los usuarios pueden especificar fechas seleccionando el mes, el año y el día. Opcionalmente, se puede configurar el widget para que incluya horas, minutos y segundos. En este tema se incluyen las siguientes secciones:
Anatomía de widgets
1. Text field
2. Fecha de inicio
3. Fecha de fin
4. Lista desplegable del mes
5. Lista desplegable del año
6. Rótulo del día
7. Fecha seleccionada
Modo de selección de rangos
Para activar la selección de rangos, defina la configuración DateRange en verdadero, el modo de selección de rangos permite al usuario limitar la fecha y la hora a un rango específico. También se puede restringir la selección de rangos escribiendo un valor numérico en la propiedad YearRange.
Selección de hora
Por defecto, el selector de fecha y hora permite seleccionar fechas. Para activar la selección de hora, defina la propiedad DateOnly en falso. La desactivación de la propiedad permite a los usuarios seleccionar la fecha y la hora. Para añadir segundos, defina la propiedad DisplaySeconds en verdadero.
Propiedades del intervalo
Utilice la propiedad Interval para desviar el valor seleccionado por defecto en relación con la fecha u hora vigente cuando se abre el calendario. 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 el elemento IntervalType en Minutos y el elemento Interval en 30.
Formato de fecha y hora
Se puede dar formato a la fecha y la hora mediante las siguientes propiedades.
• La propiedad DateOrder permite definir el orden de fechas. Por defecto, el orden de fechas se define automáticamente en tiempo de ejecución según la configuración regional del usuario en tiempo de ejecución.
• El elemento FormatToken permite personalizar el formato de fecha y hora, la propiedad FormatToken sustituye a las siguientes propiedades DisplaySeconds, DateOnly, DateDelimiter MonthFormat y DateOrder.
◦ DisplaySeconds: la propiedad DisplaySeconds permite a los usuarios mostrar los segundos en dos formatos diferentes.
a. 0:59
b. 00 59.
◦ DateOnly: la propiedad DateOnly permite a los usuarios mostrar los días del mes en tres formatos.
a. El día del mes como un rango de números comprendido entre 1 y 31.
b. El día del mes como un rango de números comprendido entre 1 y 31, incluido un indicador ordinal, donde el primer día es 1.º y el último día es 31.º.
c. Se muestra el número del día entre 01 y 31.
◦ DateDelimiter: la propiedad DateDelimiter permite a los usuarios utilizar uno de los cinco tipos diferentes de caracteres de puntuación como separadores entre las distintas unidades de tiempo y fecha.
a. 
◦ MonthFormat: la propiedad MonthFormat permite a los usuarios mostrar los meses del año en uno de los cinco formatos diferentes.
a. Se muestra el número del mes como un rango entre 1 y 12, donde enero es 1 y diciembre es 12.
b. Se muestra el número del mes como un rango entre 1 y 12 con un indicador ordinal, donde enero es 1.º y diciembre es 12.º.
c. Se muestra el número del mes como un rango entre 01 y 12, donde enero es 01 y diciembre es 12.
d. Permite mostrar el mes como una cadena abreviada, donde enero es Ene.
e. Se muestra el nombre completo del mes como una cadena: Enero
◦ DateOrder: la propiedad DateOrder: permite a los usuarios definir el orden de la fecha en uno de los tres pedidos distintos.
a. Día-Mes-Año. Este es el formato por defecto.
b. Mes-Día-Año.
c. Año-Mes-Día.
Para obtener más información, consulte Formato de fecha y hora para widgets.
Propiedad | Descripción | Tipo base | Valor por defecto. | ¿Es enlazable? (Sí/No) | ¿Es localizable? | ||
Label | El texto que se muestra en el rótulo del widget de selector de fecha y hora. | STRING | N/D | S | S | ||
Disabled | Esta propiedad se utiliza para desactivar el widget en el mashup. El widget se muestra en el mashup, pero no se puede pulsar en él. | BOOLEAN | FALSO | S | N | ||
HintText | Se muestra el texto del marcador que explica lo que debe introducirse en el campo. | STRING | SELECCIONAR FECHA Y HORA | S | S | ||
DateOnly | Permite mostrar solo la fecha. | BOOLEAN | VERDADERO | N | No | ||
DisplaySeconds | Permite mostrar la hora con segundos. | BOOLEAN | FALSO | N | No | ||
DateDelimter | Permite definir el carácter utilizado para separar el día, el mes y el año. Por ejemplo, — (guion) o / (barra diagonal) como 05/10/2020. | STRING | N/D | N | S | ||
MonthFormat | Permite mostrar el mes en formato completo, corto o numérico. | STRING | FULL | N | No | ||
PrimaryActionPosition | Permite definir la posición del botón de acción principal a la Izquierda o a la Derecha. La acción principal es el botón • Terminado en el grupo de botones. | STRING | IZQUIERDA | N | No | ||
DateOrder | Permite definir el formato de la visualización de fecha. Los distintos formatos son Automático, Día-Mes-Año, Mes-Día-Año y Año-Mes-Día. Cuando se selecciona Automático por defecto, la fecha del sistema aparece en el widget. Además, el widget desactiva las propiedades DateDelimiter y MonthFormat. | STRING | AUTO | N | No | ||
FormatToken | Cuando se selecciona la opción Automático por defecto, se utiliza la configuración regional del usuario para dar formato a la fecha. Esta propiedad reemplaza a las propiedades DateDelimiter y MonthFormat.
| STRING | N/D | N | S | ||
IntervalType | Permite definir un intervalo como Horas, Minutos o Días.
| STRING | HORAS | N | No | ||
Interval | Permite definir un intervalo como Horas, Minutos o Días.
| NUMBER | 0 | No | No | ||
MaxRange | Permite definir el número máximo de días que los usuarios pueden seleccionar entre las fechas de inicio y fin.
| NUMBER | N/D | N | No | ||
MaxRangeFailureMessage | El mensaje que se debe mostrar cuando el rango seleccionado entre las fechas de inicio y fin superan el valor MaxRange.
| STRING | N/D | S | S | ||
CustomClass | Permite definir la CSS en el elemento div superior del widget. Pueden introducirse varias clases, separadas por un espacio. | STRING | N/D | S | N | ||
TabSequence | La secuencia en la que se realzan los widgets cuando el usuario pulsa la tecla del tabulador. | NUMBER | N/D | N | No | ||
WeeklyCalendarStart | Permite definir que el calendario semanal empiece por el domingo o el lunes. | STRING | LUNES | N | No | ||
InitializeWithCurrentDateTime | Permite definir la propiedad DateTime en la fecha y hora actuales. Si no se selecciona esta propiedad, el usuario debe introducir la fecha y hora. | BOOLEAN | VERDADERO | N | No | ||
LabelAlignment | Permite alinear el rótulo a la izquierda, la derecha o el centro en el widget. | STRING | IZQUIERDA | N | No | ||
DateTime | Origen del valor de fecha y hora del selector de fecha y hora. | DATETIME | N/D | S | N | ||
Changed | Evento enlazable que se activa al modificar los datos de este widget. | N/D | N/D | S | N | ||
ResetToDefaultValue | Permite restaurar los valores por defecto de las entradas de este widget. | N/D | N/D | S | N | ||
DateRange | Permite definir un rango de fechas en años, meses y días. Cuando se selecciona esta propiedad, se añaden las siguientes propiedades: • StartDate • StartDateLabel • EndDate • EndDateLabel • RangeHintText • RangedChanged
| BOOLEAN | Falso | N | No | ||
Width | El ancho del widget. | NUMBER | N/D | N | No | ||
Height | La altura del widget. La altura se define en el ancho máximo del rótulo por defecto. Aumenta si el widget tiene un rótulo de varias líneas. Introduzca un valor en el panel de propiedades o cambie el tamaño del widget en el lienzo para definir un tamaño de altura fijo. | NUMBER | N/D | N | No | ||
CurrentDateButton | Permite añadir un botón mediante el que se puede seleccionar la fecha actual. | BOOLEAN | Verdadero | No | No | ||
YearRange | Permite seleccionar el rango de años del mashup. | NUMBER | 10 | N | No |
