Um XLSForm pode conter perguntas do tipo data, hora e data e hora. Essas perguntas podem ser estilizadas para auxiliar na captura de dados usando aparências.
Você pode formatar datas e horas usando a função format-date na coluna de cálculo de data, hora ou perguntas dateTime. Para mais informações, consulte Formatação de data.
Os tipos de campo do ArcGIS aos quais as perguntas de data e hora são atribuídas no Survey123 por padrão, podem ser alterados para capturar somente data, somente hora ou deslocamento do carimbo de data/hora. Para saber mais, consulte Colunas personalizadas da Esri.
Aviso:
A versão de Novembro e anteriores doSurvey123 Connect 3.19 não podem atribuir tipos de campo somente data, somente hora ou deslocamento do carimbo de data/hora. Embora a Atualização de Fevereiro do Survey123 Connect 3.19 possa publicar esses tipos de dados no ArcGIS Enterprise 11.2, eles não são totalmente suportados e seu uso nas camadas da web do ArcGIS Enterprise 11.2 é considerado uma funcionalidade beta.
As perguntas inicial e final capturam automaticamente a data e hora inicial e final da pesquisa e podem ser usadas para calcular o tempo necessário para concluir uma pesquisa.
Aparência
Ao definir a coluna aparência para year, uma pergunta de data é apresentada como um botão de ano somente, com setas para aumentar ou diminuir o valor do ano.
A o definir a aparência para month-year, uma pergunta de data é apresentada como um par de botões, um para o mês e outro para o ano. Cada um tem setas para aumentar ou diminuir o valor.
Anotação:
As aparências year e month-year aparecem quando a pesquisa é carregada com valores para o mês e ano atuais. No entanto, eles ainda não contêm estes valores e enviarão um valor em branco, a menos que tenham sido editados manualmente ou que um padrão ou cálculo tenha sido aplicado.
Ao definir a aparência para week-number, uma pergunta de data ainda é apresentada com um seletor de calendário para escolher a data, mas uma vez selecionada, o resultado é exibido como o número de semana equivalente do ano, conforme definido pela norma ISO 8601. Por exemplo, se você 27 de Abril de 2016, a Semana 17 será exibida como resultado.
Anotação:
A aparência week-number não é suportada no Survey123 web app.
Formatos de data e hora
Existem três formatos de data e hora que você pode usar no Survey123: Formato ISO 8601, hora da época (Unix) e hora decimal.
A tabela a seguir resume esses formatos:
| Nome | Descrição | Exemplos |
|---|---|---|
String que pode incluir deslocamento UTC. Este formato é útil para padrões e restrições porque é legível por humanos. | 2015-08-31T09:07:01Z 2015-08-31T09:07:01Z-07:00 | |
Hora da Época (Unix)* | Número inteiro que representa o número de milissegundos decorridos desde 00:00:00 Tempo Universal Coordenado (UTC) em 1º de janeiro de 1970. Embora convertido para uma data ou hora legível quando exibido em aplicativos ArcGIS, o Tempo de época é como os dados são armazenados no ArcGIS Online e ArcGIS Enterprise e é o que é retornado pelo objeto de feição. | 1441011600000 |
Tempo de decimal | Número decimal que representa a quantidade de dias decorridos desde as 00:00:00 do Tempo Universal Coordenado (UTC) em 1º de janeiro de 1970. Ao adicionar ou subtrair um valor de data, você deve usar o tempo decimal. | 16678.375 |
*O formato de tempo Epoch não é suportado no aplicativo web Survey123.
Dica:
Para garantir que as pesquisas funcionem de forma consistente em todos os aplicativos de envio do Survey123, você deve usar o formato ISO 8601 ou tempo decimal em cálculos de data e hora.
Cálculos de tempo de época e tempo decimal
A tabela a seguir descreve como a época e o tempo decimal equivalem ao tempo legível por humanos:
| Tempo legível ao humano | Tempo de época | Tempo de decimal |
|---|---|---|
1 segundo | 1000 | 0.00001157407407 (1 / 24 / 60 / 60) |
1 minuto | 60,000 (1000 * 60) | 0.00069444444444 (1 / 24 / 60) |
1 hora | 3600000 (1000 * 60 * 60) | 0.04166666666667 (1 / 24) |
1 dia | 86400000 (1000 * 60 * 60 * 24) | 1 |
1 semana | 604800000 (1000 * 60 * 60 * 24 * 7) | 7 |
1 mês | 2630880000 (1000 * 60 * 60 * 24 * 30.45) | 30.45 |
1 ano | 31557600000 (1000 * 60 * 60 * 24 * 365.25) | 365.25 |
Se você tiver pesquisas criadas usando cálculos de tempo baseados em época, deverá convertê-las em tempo decimal para se comportarem corretamente no aplicativo web Survey123. A seguir estão exemplos de expressões convertidas de Época para hora decimal:
| Objetivo | Cálculo do tempo de época | Cálculo do tempo decimal |
|---|---|---|
15 minutos no futuro | now() + 15 * 60 * 1000 | date-time(decimal-date-time(now()) + 0.0104166675) |
Duas semanas no futuro | now() + 14 * 24 * 60 * 60 * 1000 | date(decimal-date-time(now()) + 14) |
Tempo gasto para almoçar em minutos | int(${LunchEnd} - ${LunchStart}) div (1000 * 60) | int((decimal-date-time(${lunchends}) - decimal-date-time(${lunchstarts})) * 24 * 60) |
Calcular idade a partir de um aniversário (em anos) | int((today() - ${birth_date}) div (1000 * 24 * 60 * 60 * 365.25)) | int((decimal-date-time(today()) - decimal-date-time(${birth_date})) div 365.25) |
Após você ter uma compreensão das alterações necessárias para sua pesquisa, o processo de atualização é o seguinte:
- No Survey123 Studio ou Survey123 Connect, atualize quaisquer cálculos de tempo baseados em época para usar data e hora decimal. É recomendado que você salve um backup do XLSForm antes de continuar.
- Teste os cálculos atualizados visualizando-os no Survey123 Studio ou Survey123 Connect para garantir que funcionem conforme o esperado.
- Republique a pesquisa. As atualizações para os cálculos não provocam uma republicação da camada de feição, portanto, nenhum dado existente será perdido ao fazer isto.
- Faça com que os usuários de campo atualizem a pesquisa no Survey123 Mobile ou o aplicativo de campo Survey123, ou reinicie a pesquisa no aplicativo da web Survey123.