Expressions de date et date-heure

Vous trouverez ci-après des exemples d’expressions de rapport concernant des questions Date et Date-heure.

Remarque :

Ces expressions ne s’appliquent pas aux questions Heure stockées sous forme de chaînes.

Pour être sûr que les questions de type date et date-heure sont présentées au format correspondant à votre région, vous pouvez utiliser une expression pour mettre en forme la question de sorte qu’elle corresponde à la langue indiquée. Placez la méthode locale en premier dans l’expression, le code régional doit figurer en minuscules :

${datetime | locale:"pt-br"}

Remarque :

Pour plus d’informations sur le code régional d’une langue donnée, consultez Liste des codes ISO 639-1 sur Wikipédia. Cependant, les langues ne sont pas toutes prises en charge par Survey123.

Toutes les valeurs de type date et date-heure d’une couche d’entités sont stockées en temps universel coordonné (UTC). Par défaut, toutes les valeurs de type date et date-heure renvoyées dans un rapport relèvent du même fuseau horaire que celui du navigateur Web utilisé pour réclamer la génération du rapport. Si vous souhaitez modifier l’affichage de ces valeurs dans un rapport, utilisez la méthode utcOffset pour définir un fuseau horaire spécifique. Dans l’expression suivante, la réponse à une question de type date-heure est affichée avec un décalage d’une heure de plus (+1) par rapport au temps universel coordonné (UTC) :

${datetime | utcOffset:"+01:00"}

La méthode utcOffset prend en charge les formats +01:00, +0100 et +01, et renvoie le même résultat. Vous pouvez utiliser cette méthode pour modifier l’affichage de l’heure d’envoi des réponses.

Pour les questions de type date et date-heure, vous pouvez utiliser une expression pour formater la date à l’aide d’emplacements réservés JJ, MM et AAAA pour le jour, le mois et l’année respectivement. L’expression suivante affiche uniquement le jour et le mois, sans omettre l’année :

${date | format:"DD/MM"}

Vous pouvez également formater l’heure dans les questions de type date-heure, à l’aide d’espaces réservés HH, mm et ss pour heures, minutes et secondes respectivement. L’expression suivante affiche le jour, le mois, les heures et les minutes :

${datetime | format:"DD/MM HH:mm"}

Vous pouvez afficher les dates et les heures au format ISO 8601 de AAAA-MM-JJTHH:mm:ss±HH:mm en laissant vierge la valeur pour la méthode format, comme indiqué dans l’exemple suivant :

${datetime | format:""}

Pour plus d’informations à propos des formats de date et d’heure, consultez le tableau ci-dessous.

Remarque :

Vous devez placer la méthode format à la fin de l’expression.

Vous pouvez imprimer la date et l’heure de génération du rapport à l’aide du mot-clé $date. Utilisez la méthode format pour indiquer si la date, l’heure ou les deux doivent être imprimées. L’exemple suivant imprime la date de génération du rapport (sans l’heure) au format de date par défaut pour votre région :

${$date}

L’expression suivante imprime le mois, le jour, les heures et les minutes pour la date et l’heure de génération du rapport :

${$date | format:"MM/DD/YYYY HH:mm"}

L’expression suivante imprime l’heure de génération du rapport (sans la date) en heures, minutes et secondes au format horaire de 12 heures :

${$date | format:"h:mm:ss A"}

Le mot-clé $date prend également en charge les méthodes utcOffset et locale. La méthode locale est ignorée lorsque format et locale sont spécifiés.

Formats de date et heure

Le tableau suivant répertorie les emplacements réservés les plus courants pouvant être utilisés avec la méthode format pour mettre en forme les dates et heures dans les questions Date et Date-heure dans un rapport :

Emplacement réservé	Description
AA	Les deux derniers chiffres de l’année. Exemple : 2023 est représenté sous la forme 23.
AAAA	Les quatre chiffres de l’année. Exemple : 2023 est représenté sous la forme 2023.
V	Le numéro du mois, de 1 à 12. Exemple : janvier est représenté sous la forme 1.
MM	Le numéro du mois sur deux chiffres. Exemple : janvier est représenté sous la forme 01.
MMM	Le mois en trois lettres. Exemple : janvier est représenté sous la forme jan.
MMMM	Le mois en toutes lettres. Exemple : janvier est représenté sous la forme janvier.
D	Le numéro du jour, de 1 à 31. Exemple : le premier jour du mois est représenté sous la forme 1.
DD	Le numéro du jour sur deux chiffres. Exemple : le premier jour du mois est représenté sous la forme 01.
Do	Le numéro du jour avec son suffixe ordinal. Exemple : le premier jour du mois est représenté sous la forme 1er.
H	Le numéro de l’heure au format 24 heures. Exemple : 11 p.m. (11 heures du soir) est représenté sous la forme 23.
HH	Le numéro de l’heure au format 24 heures sur deux chiffres. Exemple : 2 a.m (2 heures du matin) est représenté sous la forme 02.
h	Le numéro de l’heure au format 12 heures. Exemple : 11 p.m. (11 heures du soir) est représenté sous la forme 11.
hh	Le numéro de l’heure au format 12 heures sur deux chiffres. Exemple : 2 a.m (2 heures du matin) est représenté sous la forme 02.
m	Le numéro de minute, de 0 à 59. Exemple : 8 minutes est représenté sous la forme 8.
mm	Le numéro de minute sur deux chiffres. Exemple : 8 minutes est représenté sous la forme 08.
ss	Le numéro de seconde sur deux chiffres. Exemple : 9 secondes est représenté sous la forme 09.
Z	Le décalage horaire en heures avec séparateur. Exemples : -07:00, +13:00
ZZ	Le décalage horaire en heures sans séparateur. Exemples : -0700, +1300
x	Horodatage UNIX en millisecondes. Exemple : 9 p.m. (9 heures du soir) le 4 mai 2023 GMT est représenté sous la forme 1683234000000.
x	Horodatage UNIX. Exemple : 9 p.m. (9 heures du soir) le 4 mai 2023 GMT est représenté sous la forme 1683234000.
a	Notation du matin ou de l’après-midi en minuscules. Exemple : a.m. est représenté sous la forme am, et p.m. est représenté sous la forme pm.
A	Notation du matin ou de l’après-midi en majuscules. Exemple : a.m. est représenté sous la forme AM, et p.m. est représenté sous la forme PM.