Saltar a contenido

4.16 Date/Datetime

El componente Date se utiliza para mostrar y recibir fechas. El componente DateTime amplía esta funcionalidad para incluir tanto la fecha como la información horaria.

Con el atributo "pattern", los usuarios pueden especificar el formato en el que desean que se represente la fecha o la fecha y hora. Si se utiliza la hora del epoch de Unix, están disponibles los patrones "seconds" y "milliseconds". Para campos de texto, se pueden aplicar formatos de fecha de Java, como "yyyy-MM-dd".

El atributo "hasTodayButton", que se establece en true por defecto, determina si se debe mostrar el botón "Hoy" (para Date) o el botón "Ahora" (para DateTime), permitiendo a los usuarios llenar fácilmente el campo con la fecha o fecha y hora actual.

Atributo Valor por defecto Tipo Descripción
Comunes id null String Identificador único del componente. Si no tiene id, se le asigna con nomenclatura ${tag}${num}.
render true Boolean o JEXLExpression Expresión EL para evaluar si el componente debe mostrarse.
onBeforeRender null String Método JS a ejecutar antes de que el componente actual sea renderizado.
onAfterRender null String Método JS que se ejecutará una vez renderizado el componente actual.
action null String Identificador de la acción a realizar cuando el usuario interactúa con este componente.
allowsPartialRestore false Boolean Si el estado del componente actual debe restaurarse cuando el usuario vuelva a la vista.
Comunes input label null String Etiqueta del componente.
validator null String Tipo de validación del componente: required, short, long, decimal, double, float, email, iban.
hint null String Texto a modo de ayuda o información. Se mostará un botón de información que al ser pulsado mostrará un panel con el texto aportado.
readonly false Boolean o JEXLExpression Evaluar si el componente debe ser de sólo lectura o no.
placeHolder null String o JEXLExpression Valor del componente cuando el componente no tiene valor.
inputType null Integer Valor inputType de Android que soportará el componente. Ver documentación de Android InputType. Por ejemplo, para PHONE_CLASS, establezca input_type = 3. En el caso de la imagen, mostrará la botonera asociada a la imagen:
  • 1 cámara
  • 2 galería
  • 4 sketch
  • 3 galería y cámara
  • 5 sketch y cámara
  • 6 sketch y galería
  • 7 cámara, galería y sketch
hasDeleteButton true Boolean Indica si se mostrará el botón de borrado del componente.
converter null String Instancia del conversor a aplicar a la propiedad de la entidad.
value null String o JEXLExpression Expresión EL para calcular el valor del componente.
pattern null String Patrón con el que se quiere representar la fecha o fecha-hora.
  • Si tenemos un campo long y queremos almacenarlos en unix epoc, podemos utilizar estos dos patterns: seconds: unixepoch en segundos, milliseconds: unixepoch en milisegundos.
  • Si tenemos un campo texto para almacenar la fecha podemos utilizar formatos de java: pattern =”yyyy-mm-dd”
hasTodayButton true Boolean indica si se debe mostrar el botón de "Today" para date o "Now" para datetime.
<date converter="integer" label="Fecha integer segundos: "
    pattern="unixepoch_s" value="${entity.fecha_integer_seconds}" />
<date converter="integer" label="Fecha integer milisegundos: "
    pattern="unixepoch_m" value="${entity.fecha_integer_milliseconds}" />
<date converter="string" label="Fecha string: "
    pattern="yyyy/MM/dd" value="${entity.fecha_text}" />

<datetime converter="integer" label="Fecha integer segundos: "
    pattern="unixepoch_s" value="${entity.fecha_integer_seconds}" />
<datetime converter="integer" label="Fecha integer milisegundos: "
    pattern="unixepoch_m" value="${entity.fecha_integer_milliseconds}" />
<datetime converter="string" label="Fecha string: "
    pattern="yyyy/MM/dd" value="${entity.fecha_text}" />

Image 1 Image 2
Image 3 Image 4 Image 5