Date

Date est une fonction de texte qui renvoie la date et l'heure auxquelles un rapport en ligne a été alimenté en données ou la date et l'heure d'enregistrement d'un rapport figé. La date et l'heure sont extraites du serveur de rapport. Elles correspondent au pays dans lequel le serveur de rapport est implanté. La fonction Date peut être utilisée dans une zone ou une cellule de texte, ou dans un en-tête de ligne et de colonne.

Remarque :

Le format de date et d'heure varie en fonction des paramètres régionaux. Les exemples de cette rubrique concernent les Etats-Unis.

Syntaxe :

<<Date("format,TimeZoneId")>>

Argument Description

Argument	Description
format	Valeur par défaut : préférence utilisateur de date/heure. Les valeurs valides sont celles acceptées par Java `SimpleDateFormat`, "user" ou une chaîne vide ("user"). Les caractères de format de date et d'heure respectent la casse.
TimeZoneId	Les valeurs valides sont celles acceptées par Java `TimeZone.getTimeZone()` ou le fuseau horaire du serveur. Par exemple, pour `TimeZone.getTimeZone()`, pour indiquer la côte Est, entrez : "America/New_York". Lorsque vous utilisez TimeZoneID, placez le paramètre `format` entre guillemets. Cette règle ne s'applique que si TimeZoneId est indiqué. Vous n'avez pas besoin de mettre à jour les rapports antérieurs à l'amélioration apportée à TimeZoneId.

format

Valeur par défaut : préférence utilisateur de date/heure. Les valeurs valides sont celles acceptées par Java SimpleDateFormat, "user" ou une chaîne vide ("user").

Les caractères de format de date et d'heure respectent la casse.

TimeZoneId

Les valeurs valides sont celles acceptées par Java TimeZone.getTimeZone() ou le fuseau horaire du serveur. Par exemple, pour TimeZone.getTimeZone(), pour indiquer la côte Est, entrez : "America/New_York".

Lorsque vous utilisez TimeZoneID, placez le paramètre format entre guillemets. Cette règle ne s'applique que si TimeZoneId est indiqué. Vous n'avez pas besoin de mettre à jour les rapports antérieurs à l'amélioration apportée à TimeZoneId.

Tableau -14 Caractères de format de date et d'heure

Caractères de format	Signification	Type de données	Exemple
G	indicateur d'ère	texte	Apr. J.-C.
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' E 'de' 'MMM")>> affiche : 24-déc-02 est le 4e mardi 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	Si l'heure est 3:37 PM : 3
z	fuseau horaire	texte	Heure standard du Pacifique
y	année	nombre	2002,02
'	texte littéral	texte	<<Date("D'e jour de 'yyyy")>> affiche : 105e jour de 2002
' '	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 Remarque : 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).

Remarques concernant l'utilisation des caractères de format :

Le nombre ou le compte des caractères de format détermine le format :
- Pour le texte, moins de quatre lettres de référence impliquent l'utilisation d'une forme courte ou abrégée, si possible.
- Au-delà de quatre lettres de référence, on utilise la forme entière.
- M ou MM signifie l'utilisation d'un chiffre pour le mois.
- MMM signifie l'utilisation d'une abréviation à trois lettres pour le mois.
- MMMM signifie l'utilisation du nom du mois complet.
Par exemple, pour le 24 avril :

<<Date("dd-M-yy")>> affiche 24-4-02

<<Date("dd-MM-yy)>> affiche 24-04-02

<<Date("dd-MMM-yy")>> affiche 24-Avr-02

<<Date("dd-MMMM-yy")>> affiche 24-Avril-02
Pour les nombres, la quantité de lettres de référence correspond à la quantité minimale de chiffres. Des zéros sont ajoutés aux nombres plus petits. 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, pour le mois de février :

<<Date("MM-yyyy")>> affiche 02-2002
Toutes les lettres de l'alphabet, qu'elles soient en majuscule ou en minuscule et désignées ou non comme des caractères de format, sont prises en compte.
Placez le texte littéral entre guillemets simples. Pour utiliser un guillemet simple dans du texte littéral, placez le texte entre guillemets simples et utilisez deux guillemets simples pour l'apostrophe.

Par exemple, le format d'affichage pour 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/02
`<<Date("d-MMM-yy")>>`	23-mar-02
`<<Date("EEEE, MMMM dd, yyyy")>>`	Mardi, mars 23, 2002
`<<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 'heure:' h:mm:ss a zzzz")>>`	Mardi, mars 23, 2002, 12:52:05 PM Heure standard de l'Est
`<<Date("hh 'heures de l''après-midi' a, zzzz")>>`	12:00 PM Heure standard de l'Est Remarque : Vous devez utiliser deux guillemets simples pour générer un guillemet simple dans votre texte final mis en forme.