Datum und Uhrzeit

Ein XLSForm kann Fragen vom Typ "date", "time" und "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" oder "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.

Aussehen

Wenn Sie die Spalte appearance auf year festlegen, wird eine Datumsfrage als Schaltfläche zur Jahresangabe dargestellt, die Pfeile zum Erhöhen oder Verringern des Jahreswertes aufweist.

Wenn Sie appearance auf month-year festlegen, wird eine Datumsfrage als Schaltflächenpaar dargestellt – eine Schaltfläche für den Monat und eine für das Jahr. Jede Schaltfläche hat Pfeile zum Erhöhen oder Verringern des Wertes.

Hinweis:

Die Aussehentypen year und month-year werden angezeigt, wenn der Survey mit Werten für den aktuellen Monat und das aktuelle Jahr geladen wird. Sie enthalten diese Werte jedoch nicht bereits automatisch; es werden leere Werte übergeben, sofern keine manuelle Bearbeitung erfolgt oder ein Standardwert oder eine Berechnung angewendet wurde.

Wenn Sie appearance auf week-number festlegen, wird eine Datumsfrage zwar mit einer Kalenderauswahl zum Wählen des Datums dargestellt, aber nach Auswahl des Datums wird das Ergebnis als entsprechende Wochennummer des Jahres gemäß ISO 8601 angezeigt. Wenn Sie beispielsweise das Datum 27. April 2016 auswählen, wird "Week 17" als Ergebnis angezeigt.

Hinweis:

Das Aussehen week-number wird in der Survey123-Web-App nicht unterstützt.

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
ISO 8601-Format	Zeichenfolge, die UTC-Versatz beinhalten kann. 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. 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. Beim Addieren oder Subtrahieren von einem Datumswert müssen Sie Dezimalzeit verwenden.	16678.375

* Das Unixzeitformat wird in der Survey123-Web-App nicht unterstützt.

Tipp:

Um sicherzustellen, dass Surveys in allen Survey123-Apps für die Übermittlung 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:

1. Aktualisieren Sie in Survey123 Studio oder Survey123 Connect Unixzeit-basierte Berechnungen auf Dezimaldatums-basierte Berechnungen. Es wird empfohlen, zuvor eine Sicherungskopie des XLSForm zu speichern.
2. Testen Sie die aktualisierten Berechnungen in der Survey123 Studio- oder Survey123 Connect-Vorschau, um sicherzustellen, dass sie wie erwartet funktionieren.
3. 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.
4. Lassen Sie Außendienstmitarbeiter den Survey in Survey123 Mobile oder in der mobilen Survey123-App aktualisieren, oder starten Sie den Survey in der Survey123-Web-App neu.