Date et heure

Un formulaire XLSForm peut comporter des questions Date, Heure ou Date/heure. Il est possible de styliser ces questions pour faciliter la capture des données à l’aide des apparences.

Vous pouvez mettre en forme les dates et les heures à l’aide de la fonction format-date dans la colonne de calcul des questions Date, Heure ou Date/heure. Pour plus d’informations, reportez-vous à la rubrique Mise en forme des dates.

Les types de champs ArcGIS auxquels les questions Date et Heure sont attribuées par défaut par Survey123 peuvent être modifiés pour capturer la date uniquement, l’heure uniquement ou le décalage de l’horodatage. Pour en savoir plus, reportez-vous à la rubrique Colonnes personnalisées Esri.

Attention :

La version de novembre de Survey123 Connect 3.19 et les versions antérieures ne peuvent pas attribuer des champs de type date uniquement, heure uniquement ou décalage de l’horodatage. Bien que la mise à jour de février de Survey123 Connect 3.19 puisse publier des types de données sur ArcGIS Enterprise 11.2, elles ne sont pas complètement prises en charge et leur utilisation dans des couches Web de ArcGIS Enterprise 11.2 est considérée comme une fonctionnalité bêta.

Les questions de début et de fin capturent automatiquement les heures et date de début et de fin de l’enquête et servent à calculer le temps nécessaire à la réalisation d’une enquête.

Formats de date et heure

Vous pouvez utiliser les trois formats de date et heure suivants dans Survey123 : le format ISO 8601, l’heure Epoch (Unix) time et l’heure décimale.

Le tableau ci-après récapitule ces formats.

Nom	Description	Exemples
Format ISO 8601	Chaîne pouvant inclure le décalage UTC. Ce format est pris en charge par l’application Web et l’application de terrain Survey123. Il est utile pour les valeurs par défaut et les contraintes car il est intelligible.	2015-08-31T09:07:01Z 2015-08-31T09:07:01Z-07:00
Heure Epoch (Unix)	Entier représentant le nombre de millisecondes qui se sont écoulées depuis le 1er janvier 1970 à 00:00:00 (temps universel coordonné, UTC). Ce format n’est pas pris en charge dans l’application Web Survey123. L’heure Epoch correspond à la façon dont les données sont stockées dans ArcGIS Online ou ArcGIS Enterprise.	1441011600000
Heure décimale	Nombre décimal représentant le nombre de jours qui se sont écoulés depuis le 1er janvier 1970 à 00:00:00 (temps universel coordonné, UTC). Ce format est pris en charge par l’application Web et l’application de terrain Survey123. Lors de l’ajout ou de la soustraction à partir d’une valeur de date, vous devez utiliser l’heure décimale.	16678.375

Conseil :

Pour vous assurer que les enquêtes fonctionnent de manière cohérente à la fois dans l’application de terrain et l’application Web, vous devez utiliser le format ISO 8601 ou l’heure décimale dans les calculs de date et d’heure.

Calculs d’heure Epoch et d’heure décimale

Le tableau ci-après présente les équivalences entre l’heure Epoch et l’heure décimale et l’heure intelligible.

Heure intelligible	Heure Epoch	Heure décimale
1 seconde	1000	0.00001157407407 (1 / 24 / 60 / 60)
1 minute	60 000 (1000 * 60)	0,00069444444444 (1 / 24 / 60)
1 heure	3600000 (1000 * 60 * 60)	0,04166666666667 (1 / 24)
1 jour	86400000 (1000 * 60 * 60 * 24)	1
1 semaine	604800000 (1000 * 60 * 60 * 24 * 7)	7
1 mois	2630880000 (1000 * 60 * 60 * 24 * 30.45)	30,45
1 an	31557600000 (1000 * 60 * 60 * 24 * 365.25)	365,25

Si vous disposez d’enquêtes qui ont été créées avec des calculs d’heure Epoch, vous devez les convertir en heure décimale pour qu’elles fonctionnent correctement dans l’application Web Survey123. Voici des exemples d’expressions converties de l’heure Epoch en heure décimale :

Objectif	Calcul d’heure Epoch	Calcul d’heure décimale
15 minutes dans le futur	now() + 15 * 60 * 1000	date-time(decimal-date-time(now()) + 0.0104166675)
Deux semaines dans le futur	now() + 14 * 24 * 60 * 60 * 1000	date(decimal-date-time(now()) + 14)
Temps consacré au déjeuner en minutes	int(${LunchEnd} - ${LunchStart}) div (1000 * 60)	int((decimal-date-time(${lunchends}) - decimal-date-time(${lunchstarts})) * 24 * 60)
Calculer l’âge à partir d’un anniversaire (en années)	int((today() - ${birth_date}) div (1000 * 24 * 60 * 60 * 365,25))	int((decimal-date-time(today()) - decimal-date-time(${birth_date})) div 365.25)

Une fois que vous avez identifié les changements nécessaires à votre enquête, la procédure de mise à jour est la suivante :

1. Dans Survey123 Connect, actualisez les calculs d’heure Epoch de façon à utiliser les calculs de date décimale. Il est conseillé d’enregistrer une copie de sauvegarde du formulaire XLSForm avant de continuer.
2. Testez les calculs mis à jour dans l’aperçu Survey123 Connect pour vérifier qu’ils fonctionnent comme prévu.
3. Republiez l’enquête. Comme les mises à jour apportées aux calculs ne déclenchent pas la republication de la couche d’entités, aucune donnée existante n’est perdue via cette opération.
4. Permettez aux utilisateurs sur le terrain de mettre à jour l’enquête dans l’application de terrain Survey123.