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 |
---|---|
format |
Valeur par défaut : préférence utilisateur de date/heure. Les valeurs valides sont celles acceptées par Java Les caractères de format de date et d'heure respectent la casse. |
TimeZoneId |
Les valeurs valides sont celles acceptées par Java Lorsque vous utilisez TimeZoneID, placez le paramètre |
Tableau 11-8 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 |
---|---|
|
23/3/02 |
|
23-mar-02 |
|
Mardi, mars 23, 2002 |
|
12:52:05 PM |
|
12:52:05 PM Heure standard de l'Est |
|
Mardi, mars 23, 2002, 12:52:05 PM Heure standard de l'Est |
|
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. |