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.

NomDescriptionExemples

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.

Bien que convertie en date et heure intelligibles une fois affichée dans des applications ArcGIS, l’heure Epoch constitue le mode de stockage des données dans ArcGIS Online et ArcGIS Enterprise et ce qui est renvoyé par l’objet d’entité.

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 intelligibleHeure EpochHeure 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 :

ObjectifCalcul d’heure EpochCalcul 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.