El formulario XLSForm puede contener preguntas de fecha, hora y dateTime. Estas preguntas pueden diseñarse para facilitar la captura de datos mediante el uso de apariencias.
Puede formatear fechas y horas con la función format-date de la columna de cálculo de preguntas de fecha, hora o datTime. Para obtener más información, consulte Formato de fecha.
Los tipos de campo de ArcGIS a los que Survey123 asigna preguntas de fecha y hora de forma predeterminada pueden cambiarse para capturar solamente la fecha, solo la hora o el desfase de marca de hora. Para obtener más información, consulte Columnas personalizadas de Esri.
Precaución:
En la versión de noviembre de Survey123 Connect 3.19 y anteriores no se puede asignar tipos de campo de solo de fecha, solo de hora o desfase de marca de hora. Aunque es posible publicar esos tipos de datos en la actualización de febrero de Survey123 Connect 3.19 a ArcGIS Enterprise 11.2, no son totalmente compatibles y su uso en las capas web de ArcGIS Enterprise 11.2 se considera funcionalidad en versión beta.
Las preguntas inicial y final capturan la fecha y la hora de inicio y finalización de la encuesta de forma automática y pueden utilizarse para calcular el tiempo que se tarda en completar una encuesta.
Apariencia
Si la columna de apariencia se define como year, se presenta una pregunta de fecha como un botón solo de año, con flechas para aumentar o reducir el valor del año.
Si la apariencia se define como month-year, se presenta una pregunta de fecha como un par de botones, uno para el mes y otro para el año. Los dos tienen flechas para aumentar o reducir el valor.
Nota:
Las apariencias year y month-year aparecen si la encuesta se carga con valores del mes y el año actuales. Sin embargo, ya no contienen estos valores, por lo que enviarán un valor vacío a no ser que se editen manualmente o se aplique un valor predeterminado o un cálculo.
Si la apariencia se define como week-number, se sigue presentando una pregunta de fecha con un selector de calendario para elegir la fecha, pero, una vez seleccionada, el resultado se muestra como el número de semana equivalente del año según se define en la ISO 8601. Por ejemplo, si elige el 27 de abril de 2016, la semana 17 se muestra como el resultado.
Nota:
La apariencia week-number no se admite en la aplicación web Survey123.
Formatos de fecha y hora
En Survey123 se pueden utilizar tres formatos de fecha y hora: formato ISO 8601, tiempo Epoch (Unix) y hora decimal.
En la siguiente tabla se resumen estos formatos:
| Nombre | Descripción | Ejemplos |
|---|---|---|
Cadena que puede incluir el desfase UTC. Este formato es útil para los valores predeterminados y las restricciones, ya que es legible. | 2015-08-31T09:07:01Z 2015-08-31T09:07:01Z-07:00 | |
Tiempo Epoch (Unix)* | Número entero que representan el número de segundos transcurridos desde las 00:00:00 hora universal coordinada (UTC) del 1 de enero de 1970. Aunque se convierte en una fecha u hora legible para el usuario cuando se muestra en las aplicaciones de ArcGIS apps, el tiempo Epoch es la forma en que se almacenan los datos en ArcGIS Online y ArcGIS Enterprise, y es lo que devuelve el objeto de entidad. | 1441011600000 |
Tiempo decimal | Número decimal que representan el número de días transcurridos desde las 00:00:00 hora universal coordinada (UTC) del 1 de enero de 1970. Al agregar o sustraer de un valor de fecha, se debe utilizar el tiempo decimal. | 16678.375 |
*El formato de hora Epoch no es compatible con la aplicación web Survey123.
Sugerencia:
Para asegurarse de que las encuestas funcionan de manera uniforme en todas las aplicaciones de envío de Survey123, debe usar el formato ISO 8601 o el tiempo decimal en los cálculos de fecha y tiempo.
Cálculos de tiempo Epoch y tiempo decimal
En la siguiente tabla se describe cómo el tiempo Epoch y el decimal equivalen a la hora legible:
| Tiempo de fácil lectura | Tiempo Epoch | Tiempo decimal |
|---|---|---|
1 segundo | 1000 | 0,00001157407407 (1 / 24 / 60 / 60) |
1 minuto | 60.000 (1000 * 60) | 0,00069444444444 (1 / 24 / 60) |
1 hora | 3.600.000 (1000 * 60 * 60) | 0,04166666666667 (1 / 24) |
1 día | 86.400.000 (1000 * 60 * 60 * 24) | 1 |
1 semana | 604.800.000 (1000 * 60 * 60 * 24 * 7) | 7 |
1 mes | 2.630.880.000 (1000 * 60 * 60 * 24 * 30,45) | 30,45 |
1 año | 31.557.600.000 (1000 * 60 * 60 * 24 * 365,25) | 365,25 |
Si tiene encuestas existentes creadas utilizando cálculos de tiempo basados en el formato Epoch, debe convertirlas a tiempo decimal para que su comportamiento sea correcto en la aplicación web Survey123. A continuación se muestran ejemplos de expresiones convertidas de tiempo Epoch a decimal:
| Objetivo | Cálculo tiempo Epoch | Cálculo tiempo decimal |
|---|---|---|
15 minutos en el futuro | ahora() + 15 * 60 * 1000 | fecha y hora(fecha y hora decimal(ahora()) + 0,0104166675) |
Dos semanas en el futuro | ahora() + 14 * 24 * 60 * 60 * 1000 | fecha(fecha y hora decimal(ahora()) + 14) |
Tiempo pasado en la comida en minutos | int(${LunchEnd} - ${LunchStart}) div (1000 * 60) | int((fecha y hora decimal(${lunchends}) - fecha y hora decimal(${lunchstarts})) * 24 * 60) |
Calcular la edad desde un cumpleaños (en años) | int((hoy() - ${birth_date}) div (1000 * 24 * 60 * 60 * 365.25)) | int((fecha y hora decimal(hoy()) - fecha y hora decimal(${birth_date})) div 365,25) |
Una vez que conozca los cambios que es necesario hacer en su encuesta, el proceso de actualización es el siguiente:
- En Survey123 Studio o Survey123 Connect, actualice los cálculos de tiempo basado en Epoch para utilizar los cálculos de fecha decimal. Se recomienda guardar una copia de seguridad del XLSForm antes de hacer esto.
- Pruebe los cálculos actualizados mediante una vista previa en Survey123 Studio o Survey123 Connect para asegurarse de que funcionan según lo previsto.
- Vuelva a publicar la encuesta. Las actualizaciones de los cálculos no hacen que se vuelva a publicar la capa de entidades, de forma que ningún dato existente se perderá por hacer esto.
- Pida a los usuarios de campo que actualicen la encuesta en Survey123 Mobile o en la aplicación de campo Survey123, o que vuelvan a abrirla en la aplicación web Survey123.