Expressões de data e data-hora

Exemplos de expressões de relatório para perguntas de data e data-hora são fornecidos abaixo.

Anotação:

Essas expressões não se aplicam a perguntas de tempo que são armazenadas como strings.

Para garantir que as perguntas de data e hora sejam apresentadas de forma precisa para a formatação de sua região, você pode usar uma expressão para formatar a pergunta para corresponder a uma localidade fornecida. Coloque o método locale primeiro na expressão e o código de localidade deve estar em letras minúsculas:

${datetime | locale:"pt-br"}

Anotação:

Para informações sobre os códigos de localidade de um idioma específico, consulte Lista de códigos da ISO 639-1 do Wikipedia. No entanto, nem todos estes idiomas são suportados pelo Survey123.

Todos os valores de data e data-hora em uma camada de feição são armazenados no tempo universal coordenado (UTC). Por padrão, todos os valores de data e data-hora retornados em um relatório estão no mesmo fuso horário do navegador da web usado para solicitar a geração do relatório. Você pode usar o método utcOffset para alterar a exibição desses valores em um relatório para corresponder a um fuso horário específico. A expressão a seguir exibe a resposta a uma pergunta de data e hora compensada +1 hora do UTC:

${datetime | utcOffset:"+01:00"}

O método utcOffset suporta os formatos +01:00, +0100 e +01 e retorna o mesmo resultado. Você também pode usar este método para alterar a exibição do tempo de envio da resposta.

Para perguntas de data e hora, você pode usar uma expressão para formatar a data usando marcadores DD, MM e YYYY para dia, mês e ano, respectivamente. A expressão seguinte exibe somente o dia e mês, omitindo o ano:

${date | format:"DD/MM"}

Você também pode formatar a hora nas perguntas de data e hora, usando HH, mm e ss como marcadores de horas, minutos e segundos, respectivamente. A expressão seguinte exibe o dia, mês, horas e minutos:

${datetime | format:"DD/MM HH:mm"}

Você pode exibir datas e horas no formato ISO 8601 de YYYY-MM-DDTHH:mm:ss±HH:mm deixando o valor do método format em branco, conforme mostrado no exemplo a seguir:

${datetime | format:""}

Para obter mais informações sobre formatos de data e hora, consulte a tabela abaixo.

Anotação:

Você deve colocar o método format no final da expressão.

Você pode imprimir a data e hora na qual o relatório foi gerado usando a palavra-chave $date. Use o método format para controlar se imprimir a data, hora ou ambos. O exemplo a seguir imprime a data em que o relatório foi gerado (sem a hora) no formato de data padrão para sua localidade:

${$date}

A seguinte expressão imprime o mês, dia, ano, horas e minutos para data e hora que o relatório foi gerado:

${$date | format:"MM/DD/YYYY HH:mm"}

A expressão a seguir imprime a hora que o relatório foi gerado (sem a data) em horas, minutos e segundos no formato de 12 horas:

${$date | format:"h:mm:ss A"}

A palavra-chave $date também suporta os métodos utcOffset e locale. O método locale é ignorado quando ambos format e locale são especificados.

Formatos de data e hora

A tabela a seguir lista os espaços reservados mais comuns que podem ser usados ​​com o método format para formatar datas e horas em perguntas de data e data-hora em um relatório:

Espaço Reservado	Descrição
YY	Últimos dois dígitos do ano. Exemplo: 2023 seria representado como 23.
YYYY	Quatro dígitos do ano. Exemplo: 2023 seria representado como 2023.
M	Número do mês entre 1 e 12. Exemplo: Janeiro seria representado como 1.
MM	Número do mês em dois dígitos. Exemplo: Janeiro seria representado como 01.
MMM	Mês em três letras. Exemplo: Janeiro seria representado como Jan.
MMMM	Mês escrito na íntegra. Exemplo: Janeiro seria representado como Janeiro.
D	Número do dia entre 1 e 31. Exemplo: O primeiro dia do mês é representado como 1.
GD	Número do dia em dois dígitos. Exemplo: O primeiro dia do mês é representado como 01.
Do	Número do dia que inclui sufixos ordinais. Exemplo: O primeiro dia do mês é representado como 1º.
A	Número da hora em 24 horas. Exemplo: 23h seria representado como 23.
HH	Número da hora em formato de 24 horas com dois dígitos. Exemplo: 2 a.m. seria representado como 02.
h	Número da hora em 12 horas. Exemplo: 23h seria representado como 11.
hh	Número da hora em 12 horas com dois dígitos. Exemplo: 2 a.m. seria representado como 02.
m	Número do minuto entre 0 e 59. Example: 8 minutes would be represented as 8.
mm	Número do minuto em dois dígitos. Example: 8 minutes would be represented as 08.
ss	Número de segundos em dois dígitos. Exemplo: 9 segundos seriam representados como 09.
Z	Compensação de fuso horário em horas usando separador. Exemplos: -07:00, +13:00
ZZ	Deslocamento de fuso horário em horas sem separador. Exemplos: -0700, +1300
x	Carimbo de hora em milissegundos do UNIX. Exemplo: 21h em 4 de Maio de 2023, o GMT seria representado como 1683234000000.
X	Carimbo de hora do UNIX. Exemplo: 21h em 4 de maio de 2023, o GMT seria representado como 1683234000.
a	Notação matinal ou vespertina em minúsculas. Exemplo: a.m. seria representado como am, e p.m. seria representado como pm.
A	Notação matinal ou vespertina em letras maiúsculas. Exemplo: a.m. seria representado como AM e p.m. seria representado como PM.