How To: Convert UTC time to the local time zone in ArcGIS Survey123 Connect

Summary

In ArcGIS Survey123, when publishing surveys as feature layers to ArcGIS Online, the date fields are stored in Coordinated Universal Time (UTC) time instead of the local time zone in which the survey is taken. When viewing submitted data, the UTC time is converted to the local time zone in which the data is viewed. This is the expected behavior in ArcGIS Survey123 to standardize date values when analyzing data received from submitters with different time zones. Refer to ArcGIS Online: Published date fields store time in UTC for more information.

When exporting survey data as an Excel file from ArcGIS Survey123, the date field displays the date and time in UTC time instead of the local time zone which can cause confusion due to discrepancies.

This image shows the 'Date and time' field displays the dates and times in UTC time.

This article describes the workflow to display the local time zone when exporting survey data from ArcGIS Survey123.

Procedure

1. In ArcGIS Survey123 Connect, open the survey's XLSForm.
2. Create a survey question to input date and time information.
   1. In the survey worksheet, in the type column, select dateTime from the drop-down list.
   2. Specify the values in the name and label columns. In this example, the question is named 'dt1' and labeled 'Date and time'.

3. Create a survey question to calculate the UTC offset value.
   1. In the type column, select calculate from the drop-down list.
   2. Specify the values in the name and label columns. In this example, the question is named 'utc' and labeled 'utc offset'.
   3. In the calculation column, enter the following expression:

pulldata("@property", 'utcOffset')

4. Create another survey question to calculate the local time in which the survey is taken.
   1. In the type column, select calculate from the drop-down list.
   2. Specify the values in the name and label columns. In this example, the question is named 'adjusted_date' and labeled 'Adjusted date-time'.
   3. In the calculation column, enter the following expression:

• For the field app, use the epoch calculation as follows:

${dt1} + ${utc}*(60*60*1000)

• For the web app, use the epoch calculation as follows:

date-time(decimal-date-time(${dt1}) + ${utc}*0.04166666666667)

Note:
The ArcGIS Survey123 field app supports both epoch time and decimal time, while the web app only supports decimal time. Refer to ArcGIS Survey123: Decimal date time for more information.

In this example, both expressions are entered in separate rows to demonstrate the differences.

4. In the bind::type column, select dateTime from the drop-down list.

5. Save the XLSForm.
6. In ArcGIS Survey123 Connect, click Publish to publish the survey.

The recorded data can be viewed and exported from the survey's Data tab on the ArcGIS Survey123 website. To export the data, refer to ArcGIS Survey123: Download results. In this example, the 'adjusted_date' and 'adjusted_date2' fields in the exported file display the local time zone.

Related Information

• ArcGIS Online: Date fields in ArcGIS Online
• ArcGIS Survey123: Decimal date time
• ArcGIS Survey123: Device and user properties
• ArcGIS Survey123: Formulas

Last Published: 1/31/2023

Article ID: 000024613

Software: ArcGIS Survey123 Connect 3.9, 3.8, 3.7, 3.6, 3.5, 3.4, 3.3, 3.2, 3.16, 3.15, 3.14, 3.13, 3.12, 3.11, 3.10, 3.1, 3.0, 2.9.Classic, 2.8