DateTime

DateTime est une fonction texte qui renvoie la date et l'heure auxquelles un rapport a été alimenté en données. La date et l'heure sont extraites du serveur de rapport et correspondent au pays dans lequel ce dernier est localisé. Vous pouvez utiliser la fonction DateTime dans une zone de texte, une cellule de texte ou un en-tête de ligne ou de colonne.

Remarque :

Le fuseau horaire utilisé dans les résultats de la fonction texte lors de l'aperçu du rapport dépend du fuseau horaire de chaque utilisateur indiqué dans les Préférences utilisateur.

Syntaxe :

DateTime("DateFormat","TimeFormat")

Remarque :

Si les paramètres de la fonction DateTime sont laissés à blanc (DateTime (), par exemple) ou si la valeur "none" est utilisée dans les deux paramètres (DateTime (none, none), par exemple), les préférences utilisateur Narrative Reporting de Date et Heure seront utilisées pour le format.

Remarque :

Reportez-vous à la rubrique Paramètres pour les fonctions texte pour les définitions de paramètre.

Vous pouvez également indiquer des valeurs locales neutres pour les formats court, moyen, long et complet : DateTime (short|medium|long|full|none, short|medium|long|full|none). (N'utilisez pas de guillemets lors de la saisie de ces valeurs.) Exemples (exemples donnés pour les Etats-Unis) :

  • DateTime(short, short): 01/03/2017 1:54 PM

  • DateTime(medium, medium): Jan 03, 2017 1:54:32 PM

  • DateTime(long, long): Janvier 03, 2017 1:54:32 PM PDT

  • DateTime(full, none): Mardi, janvier 03, 2017 (Remarque : l'heure n'est pas mentionnée).

  • DateTime(none, short): 1:54 PM (Remarque : la date n'est pas mentionnée).

Tableau 11-9 Caractères de formatage de date et d'heure

Caractères de formatage Signification Type de données Exemple

G

indicateur de zone

texte

AD

M

mois de l'année

texte ou nombre

S'il s'agit du mois de juillet, M affiche 7, MM affiche 07, MMM affiche Jul, MMMM affiche Juillet

d

jour du mois

nombre

10

h

heure au format am/pm (1-12)

nombre

11

H

heure de la journée (0-23)

nombre

22

m

minute dans l'heure

nombre

30

s

seconde dans la minute

nombre

25

S

milliseconde

nombre

978

E

jour de la semaine

texte

E : Mar EE : Mardi

D

jour de l'année

nombre

189

F

jour de la semaine dans le mois

nombre

Date("dd-MMM-yy 'est le' F 'è' E 'de' 'MMM") affiche :

24-Déc-02 est le 4è Mar de Déc.

w

semaine dans l'année

nombre

27

W

semaine dans le mois

nombre

2

a

indicateur am/pm

texte

PM

k

heure de la journée (1-24)

nombre

23

K

heure au format am/pm (0-11)

nombre

Aux Etats-Unis, si l'heure est 3:37 PM: 3

z

fuseau horaire

texte

Heure standard du Pacifique

y

année

nombre

2017,02

'

texte littéral

texte

Date(" D'è jour de 'yyyy") affiche : 105è jour de 2017

' '

deux guillemets simples pour générer un guillemet simple

texte

Date("k:mm 'heures de l''après-midi' a") affiche : 6:15 heures de l'après-midi PM

Utilisez 2 guillemets simples pour générer un guillemet simple ou une apostrophe, tel que dans l'après-midi (l''après-midi).

Points à prendre en compte lors de l'utilisation des caractères de formatage :

  • Le nombre de caractères de formatage détermine le format :

    • Pour le texte, l'utilisation de moins de quatre lettres de référence implique une forme courte ou abrégée, le cas échéant.

    • A partir de quatre lettres de référence, la forme complète est utilisée.

    • M ou MM indique l'utilisation d'un chiffre pour le mois.

    • MMM indique l'utilisation d'une abréviation à trois lettres pour le mois.

    • MMMM représente l'utilisation du nom du mois complet.

    Par exemple, si la date est le 24 avril :

    Date("dd-M-yy") affiche 24-4-17

    Date("dd-MM-yy") affiche 24-04-17

    Date("dd-MMM-yy") affiche 24-avr-17

    Date("dd-MMMM-yy") affiche 24-avril-17

  • Pour les nombres, la quantité de lettres de référence correspond au nombre minimal de chiffres. Les nombres plus petits sont complétés avec des zéros. L'année est un cas à part. Si vous utilisez le format "yy", les deux derniers chiffres de l'année s'affichent. En revanche, avec le format "yyyy", les quatre chiffres de l'année apparaissent.

    Par exemple, s'il s'agit du mois de février :

    Date("MM-yyyy") affiche 02-2017

  • Toutes les lettres de l'alphabet en minuscules ou en majuscules sont considérées comme des modèles, qu'elles soient désignées en tant que caractères de formatage ou non.

  • Placez le texte littéral entre guillemets simples. Si le texte littéral contient un guillemet simple, placez-le entre guillemets simples et utilisez une apostrophe double, le cas échéant.

    Par exemple, le format d'impression de la valeur 4 heures de l'après-midi est le suivant :

     Date("hh 'heures de l''après-midi' ")

Exemples :

Format de date Résultat

Date("d/M/yy")

23/3/17

Date("d-MMM-yy")

23-Mar-17

Date("EEEE, MMMM dd, yyyy")

Mardi, mars 23, 2017

Date("h:mm:ss a")

12:52:05 PM

Date("h:mm:ss a zzzz")

12:52:05 PM Heure standard de l'Est

Date("EEEE, MMMM dd, yyyy G 'time:' h:mm:ss a zzzz")

Mardi, mars 23, 2017 Heure AD : 12:52:05 PM Heure standard de l'Est

Date("hh 'heures de l''après-midi' a, zzzz")

12:00 heures de l'après-midi PM Heure standard de l'Est

Vous devez utiliser deux guillemets simples pour générer un guillemet simple dans votre texte final mis en forme.