Saltar al contenido

TimeField

Abrir en ChatGPT
Shadow dwc-field 23.02
Java API
Inheritance

This class is a Field component, and inherits its features and behaviors. For an overview of Field properties, events, and other important information, please refer to the Field documentation.

TimeField es un componente de interfaz de usuario que permite a los usuarios ingresar o seleccionar horas en horas, minutos y opcionalmente segundos. Proporciona una manera intuitiva y eficiente de manejar información relacionada con el tiempo en diversas aplicaciones.

Mostrar Código

Usos​

El TimeField es ideal para elegir y mostrar horas en tu aplicación. Aquí hay algunos ejemplos de cuándo utilizar el TimeField:

  1. Programación de Eventos: Los campos de tiempo son esenciales en aplicaciones que implican establecer horarios para eventos, citas o reuniones.

  2. Seguimiento y Registro de Tiempo: Las aplicaciones que rastrean el tiempo, como las hojas de tiempo, necesitan campos de tiempo para entradas precisas.

  3. Recordatorios y Alarmas: Usar un campo de tiempo simplifica el proceso de entrada para los usuarios que establecen recordatorios o alarmas en tu aplicación.

Valor mínimo y máximo​

Con los métodos setMin() y setMax(), puedes especificar un rango de horas aceptables.

  • Para setMin(): Si el valor ingresado en el componente es anterior al tiempo mínimo especificado, el componente fallará la validación de restricciones. Cuando tanto los valores mínimo como máximo están establecidos, el valor mínimo debe ser una hora que sea la misma o anterior al valor máximo.

  • Para setMax(): Si el valor ingresado en el componente es posterior al tiempo máximo especificado, el componente fallará la validación de restricciones. Cuando tanto los valores mínimo como máximo están establecidos, el valor máximo debe ser una hora que sea la misma o posterior al valor mínimo.

Manejo de valores y localización​

Internamente, el componente TimeField representa su valor utilizando un objeto LocalTime del paquete java.time. Esto permite a los desarrolladores interactuar con valores de tiempo precisos independientemente de cómo se rendericen visualmente.

Mientras que el componente del lado del cliente muestra la hora utilizando la configuración regional del navegador del usuario, el formato analizado y almacenado siempre se estandariza como HH:mm:ss.

Si se establece un valor de cadena en bruto, utiliza el método setText() con precaución:

timeField.setText("09:15:00"); // válido
aviso

Al usar el método setText(), se lanzará una IllegalArgumentException si el componente no puede analizar la entrada en el formato HH:mm:ss.

Interfaz de selección

La apariencia de la interfaz de entrada del selector de tiempo depende no solo de la configuración regional seleccionada, sino también del navegador y el sistema operativo que se estén utilizando. Esto asegura una consistencia automática con la interfaz con la que los usuarios ya están familiarizados.

Utilidades estáticas​

La clase TimeField también proporciona los siguientes métodos de utilidad estáticos:

  • fromTime(String timeAsString): Convierte una cadena de tiempo en formato HH:mm:ss a un objeto LocalTime que puede ser utilizado con esta clase o en otros lugares.

  • toTime(LocalTime time): Convierte un LocalTime a una cadena de tiempo en formato HH:mm:ss.

  • isValidTime(String timeAsString): Verifica si la cadena dada es un tiempo válido en formato HH:mm:ss. Esto devolverá un valor booleano verdadero si es así, falso de lo contrario.

Mejores prácticas​

  • Proporcionar ejemplos claros de formato de tiempo: Muestra claramente a los usuarios el formato de tiempo esperado cerca del TimeField. Utiliza ejemplos o marcadores de posición para ayudarles a ingresar la hora correctamente. Si es posible, muestra el formato de hora basado en la ubicación del usuario.

  • Accesibilidad: Utiliza el componente TimeField con la accesibilidad en mente, asegurando que cumpla con los estándares de accesibilidad, como proporcionar etiquetas adecuadas, suficiente contraste de color y compatibilidad con tecnologías asistenciales.

  • Opción de restablecer: Proporciona una manera para que los usuarios puedan limpiar fácilmente el TimeField a un estado vacío o predeterminado.