A continuación se proporcionan ejemplos de expresiones de informe para preguntas sobre fecha y fecha y hora.
Nota:
Estas expresiones no se aplican a las preguntas sobre la hora que se almacenan como cadenas de texto.
Para garantizar que las preguntas de fecha y fecha y hora se presentan de forma que sean precisas según el formato de su región, puede usar una expresión para dar formato a la pregunta de manera que coincida con una configuración regional proporcionada. Coloque el parámetro locale primero en la expresión y el código de configuración regional debe estar en minúscula.
${datetime | locale:"pt-br"}
Nota:
Para obtener información sobre el código de configuración regional de un idioma concreto, consulte la Lista de códigos ISO 639-1 de la Wikipedia. Sin embargo, Survey123 no admite todos estos idiomas.
Todos los valores de fecha y de fecha y hora en una capa de entidades se almacenan en formato de hora universal coordinada (UTC). De forma predeterminada, todos los valores de fecha y de fecha y hora devueltos en un informe están en la misma zona horaria que el navegador web que se utilizó para solicitar la generación del informe. Puede usar el método utcOffset para alterar la visualización de estos valores en un informe y referirlos a una zona horaria específica. La siguiente expresión muestra la respuesta a una pregunta de fecha y hora con una diferencia de una hora respecto de la hora UTC:
${datetime | utcOffset:"+01:00"}
El método utcOffset admite los formatos +01:00, +0100 y +01, y devuelve el mismo resultado. También puede utilizar este método para modificar la visualización de la hora de envío de la respuesta.
Para las preguntas de fecha y fecha-hora, puede usar una expresión para formatear la fecha con los marcadores de posición DD, MM y YYYY para el día, el mes y el año, respectivamente. La siguiente expresión solo muestra el día y el mes, omitiendo el año:
${date | format:"DD/MM"}
También puede formatear la hora en las preguntas de fecha y hora, usando HH, mm y ss como marcadores de posición para las horas, los minutos y los segundos, respectivamente. La siguiente expresión visualiza el día, el mes, las horas y los minutos:
${datetime | format:"DD/MM HH:mm"}
Puede mostrar las fechas y horas en el formato ISO 8601 de AAAA-MM-DDTHH:mm:ss±HH:mm; para ello, deje en blanco el valor del método format, como se muestra en el siguiente ejemplo:
${datetime | format:""}
Para más información sobre los formatos de fecha y hora, consulte la tabla siguiente.
Nota:
Debe colocar el método format al final de la expresión.
Puede imprimir la fecha y hora de creación del informe utilizando la palabra clave $date. Utilice el método format para controlar si se imprime la fecha, la hora o ambas. El siguiente ejemplo imprime la fecha en la que se generó el informe (sin la hora) en el formato de fecha predeterminado para su configuración regional:
${$date}
La siguiente expresión imprime el mes, día, año, horas y minutos de la fecha y hora en que se generó el informe:
${$date | format:"MM/DD/YYYY HH:mm"}
La siguiente expresión imprime la hora a la que se generó el informe (sin la fecha) en horas, minutos y segundos en formato de 12 horas:
${$date | format:"h:mm:ss A"}
La palabra clave $date también admite los métodos utcOffset y locale. El método locale se ignora si se especifica tanto format como locale.
Formatos de fecha y hora
En la siguiente tabla se indican los marcadores de posición más comunes que pueden utilizarse con el método format para dar formato a fechas y horas en preguntas sobre la fecha y la fecha y la hora en un informe:
| Marcador de posición | Descripción |
|---|---|
AA | Los dos últimos dígitos del año. Por ejemplo: 2023 se representaría como 23. |
AAAA | Cuatro dígitos del año. Por ejemplo: 2023 se representaría como 2023. |
M | Número de mes entre 1 y 12. Por ejemplo: enero se representaría como 1. |
MM | Número de mes en dos dígitos. Por ejemplo: enero se representaría como 01. |
MMM | Mes en tres letras. Por ejemplo: enero se representaría como Ene. |
MMMM | Mes escrito con su nombre completo. Por ejemplo: enero se representaría como Enero. |
D | Número de día entre 1 y 31. Por ejemplo: el primer día del mes se representa como 1. |
DD | Número de día en dos dígitos. Por ejemplo: el primer día del mes se representa como 01. |
Permitido | Número de día con sufijos ordinales. Por ejemplo: el primer día del mes se representa como 1.º. |
H | Número de hora en formato de 24 horas. Por ejemplo: 11 p. m. se representaría como 23. |
HH | Número de hora en formato de 24 horas con dos dígitos. Por ejemplo: 2 a.m. se representaría como 02. |
h | Número de hora en formato de 12 horas. Por ejemplo: 11 p. m. se representaría como 11. |
hh | Número de hora en formato de 12 horas con dos dígitos. Por ejemplo: 2 a.m. se representaría como 02. |
m | Número de minutos entre 0 y 59. Ejemplo: 8 minutos se representarían como 8. |
mm | Número de minutos en dos dígitos. Ejemplo: 8 minutos se representarían como 08. |
ss | Número de segundos en dos dígitos. Ejemplo: 9 segundos se representaría como 09. |
Z | Desplazamiento de zona horaria en horas usando separador. Ejemplos: -07:00, +13:00 |
ZZ | Desplazamiento de zona horaria en horas sin separador. Ejemplos: -0700, +1300 |
x | Marca de tiempo con milisegundos UNIX. Ejemplo: las 9 p.m. del 4 de mayo de 2023 GMT se representaría como 1683234000000. |
X | Marca de tiempo UNIX. Ejemplo: las 9 p.m. del 4 de mayo de 2023 GMT se representaría como 1683234000. |
a | Notación de la mañana o de la tarde en minúscula. Ejemplo: a.m. se representaría como am y p.m. se representaría como pm. |
A | Notación de la mañana o de la tarde en mayúscula. Ejemplo: a.m. se representaría como AM y p.m. se representaría como PM. |