Ein XLSForm kann Fragen vom Typ "date", "time" oder "dateTime" enthalten. Zur besseren Datenerfassung können diese Fragen mittels Aussehentypen gestylt werden.
Datums- und Uhrzeitangaben können Sie mit der Funktion format-date in der Spalte "calculation" von Fragen des Typs "date", "time" und "dateTime" formatieren. Weitere Informationen finden Sie unter Datumsformatierung.
Sie können die ArcGIS-Feldtypen, die Fragen des Typs "date" und "time" standardmäßig von Survey123 zugewiesen werden, in "Nur Datum", "Nur Zeit" und "Zeitstempelversatz" ändern und so die Zeiterfassung entsprechend anpassen. Weitere Informationen finden Sie unter Benutzerdefinierte Spalten von Esri.
Vorsicht:
In Survey123 Connect-Version 3.19 vom November 2023 oder früher können die Feldtypen "Nur Datum", "Nur Zeit" und "Zeitstempelversatz" nicht zugewiesen werden. Mit der Aktualisierung vom Februar 2024 für Survey123 Connect-Version 3.19 können diese Datentypen zwar in ArcGIS Enterprise 11.2 veröffentlicht werden, sie werden aber nicht vollständig unterstützt und ihre Verwendung in ArcGIS Enterprise-11.2-Web-Layern ist eine Funktionalität im Beta-Status.
Mit Fragen vom Typ "start" und "end" werden Start- und Enddatum sowie Start- und Endzeit des Survey automatisch erfasst. Daraus kann die zum Ausfüllen eines Survey benötigte Zeit berechnet werden.
Datums- und Zeitformate
In Survey123 gibt es drei verschiedene Datums- und Zeitformate, die Sie verwenden können: ISO 8601, UNIX-Zeit und Dezimalzeit.
Die folgende Tabelle enthält eine Übersicht der Formate.
| Name | Beschreibung | Beispiele |
|---|---|---|
Zeichenfolge, die UTC-Versatz beinhalten kann. Dieses Format wird sowohl von der mobilen Survey123-App als auch von der Web-App unterstützt. Dieses Format eignet sich für Standardeinstellungen und Beschränkungen, da es in Klarschrift dargestellt wird. | 2015-08-31T09:07:01Z 2015-08-31T09:07:01Z-07:00 | |
UNIX-Zeit | Ganze Zahl, die die Anzahl der Millisekunden angibt, die seit Mitternacht (00:00:00), koordinierte Weltzeit (UTC), des 1. Januar 1970 verstrichen sind. Dieses Format wird nicht in der Survey123-Web-App unterstützt. Die UNIX-Zeit wird zwar zur Anzeige in ArcGIS-Apps in eine normale Datums- oder Zeitangabe konvertiert, jedoch als solche in ArcGIS Online und ArcGIS Enterprise gespeichert und vom Feature-Objekt zurückgegeben. | 1441011600000 |
Dezimalzeit | Dezimalzahl, die die Anzahl der Tage angibt, die seit Mitternacht (00:00:00), koordinierte Weltzeit (UTC), des 1. Januar 1970 verstrichen sind. Dieses Format wird sowohl von der mobilen Survey123-App als auch von der Web-App unterstützt. Beim Addieren oder Subtrahieren von einem Datumswert müssen Sie Dezimalzeit verwenden. | 16678.375 |
Tipp:
Um sicherzustellen, dass Surveys in der mobilen App und in der Web-App konsistent funktionieren, müssen Sie für Zeitberechnungen das ISO 8601-Format oder Dezimalzeit verwenden.
UNIX-Zeit- und Dezimalzeit-basierte Berechnungen
In der nachfolgenden Tabelle werden die Werte von UNIX-Zeit und Dezimalzeit der entsprechenden normalen Datumsangabe gegenübergestellt.
| Normale Datumsangabe | UNIX-Zeit | Dezimalzeit |
|---|---|---|
1 Sekunde | 1000 | 0,00001157407407 (1 / 24 / 60 / 60) |
1 Minute | 60000 (1000 * 60) | 0,00069444444444 (1 / 24 / 60) |
1 Stunde | 3600000 (1000 * 60 * 60) | 0,04166666666667 (1 / 24) |
1 Tag | 86400000 (1000 * 60 * 60 * 24) | 1 |
1 Woche | 604800000 (1000 * 60 * 60 * 24 * 7) | 7 |
1 Monat | 2630880000 (1000 * 60 * 60 * 24 * 30,45) | 30,45 |
1 Jahr | 31557600000 (1000 * 60 * 60 * 24 * 365,25) | 365,25 |
Wenn Sie über vorhandene Surveys verfügen, die mithilfe von UNIX-Zeit-basierten Berechnungen erstellt wurden, müssen Sie sie in Dezimalzeit umwandeln, damit sie in der Survey123-Web-App ordnungsgemäß funktionieren. Nachfolgend sind Beispiele für Ausdrücke aufgeführt, die von UNIX-Zeit in Dezimalzeit umgewandelt wurden:
| Ziel | UNIX-Zeitberechnung | Dezimalzeitberechnung |
|---|---|---|
15 Minuten in die Zukunft | now() + 15 * 60 * 1000 | date-time(decimal-date-time(now()) + 0.0104166675) |
Zwei Wochen in die Zukunft | now() + 14 * 24 * 60 * 60 * 1000 | date(decimal-date-time(now()) + 14) |
Zeitaufwand für Mittagessen in Minuten | int(${LunchEnd} - ${LunchStart}) div (1000 * 60) | int((decimal-date-time(${lunchends}) - decimal-date-time(${lunchstarts})) * 24 * 60) |
Alter ab Geburt berechnen (in Jahren) | int((today() - ${birth_date}) div (1000 * 24 * 60 * 60 * 365.25)) | int((decimal-date-time(today()) - decimal-date-time(${birth_date})) div 365.25) |
Nachdem Sie sich mit den für Ihren Survey erforderlichen Änderungen vertraut gemacht haben, wird die Aktualisierung folgendermaßen durchgeführt:
- Aktualisieren Sie in Survey123 Connect Unixzeit-basierte Berechnungen auf Dezimaldatums-basierte Berechnungen. Es wird empfohlen, zuvor eine Sicherungskopie des XLSForm zu speichern.
- Testen Sie die aktualisierten Berechnungen in der Survey123 Connect-Vorschau, um sicherzustellen, dass sie wie erwartet funktionieren.
- Veröffentlichen Sie den Survey erneut. Da Aktualisierungen von Berechnungen keine erneute Veröffentlichung des Feature-Layers auslösen, gehen dabei keine vorhandenen Daten verloren.
- Lassen Sie Außendienstmitarbeiter den Survey in der mobilen Survey123-App aktualisieren.