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 |
---|---|
|
23/3/17 |
|
23-Mar-17 |
|
Mardi, mars 23, 2017 |
|
12:52:05 PM |
|
12:52:05 PM Heure standard de l'Est |
|
Mardi, mars 23, 2017 Heure AD : 12:52:05 PM Heure standard de l'Est |
|
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. |