Convertit une DateHeure en une chaîne de caractères. Peut également renvoyer la DateHeure du système d'exploitation en cours d'utilisation.
Syntaxe
DATETIME(<DateHeure> <;format>)
Paramètres
Nom | Type | Description |
---|---|---|
DateHeure
optionnel |
DateHeure |
Le champ, l'expression, ou la valeur littérale à convertir. Si ce paramètre est omis, c'est la date du système d'exploitation en cours d'utilisation qui est renvoyée. |
format
optionnel |
caractère |
Le format à appliquer à la chaîne de sortie, par exemple "JJ/MM/AAAA".. Si ce paramètre est ignoré, le format d'affichage de la date actuel d'Analytics est utilisé. Vous ne pouvez pas indiquer de format si vous avez ignoré date/DateHeure. |
Sortie
Caractère.
Exemples
Exemples basiques
Entrée DateHeure littérale
Renvoie "20141231 235959" dans les formats d'affichage des date et heures actuelles d'Analytics :
DATETIME(`20141231 235959`)
Renvoie "31-Dec-2014 11:59 P" :
DATETIME(`20141231 235959`; "JJ-MMM-AAAA hh:mm A")
Renvoie les date et heure du système d'exploitation en cours d'utilisation sous forme de chaîne de caractères, au format d'affichage des date et heures actuelles d'Analytics.
DATETIME()
Entrée de champ
Renvoie chaque valeur du champ Reçu_horodatage sous forme de chaîne de caractères à l'aide des formats d'affichage des date et heure Analytics actuelles :
DATETIME(Reçu_horodatage)
Renvoie chaque valeur du champ Reçu_horodatage sous forme de chaîne de caractères à l'aide des formats d'affichage des date et heure spécifiés :
DATETIME(Reçu_horodatage; "JJ/MM/AAAA hh:mm:ss")
Remarques
Longueur de la chaîne de sortie
La chaîne de sortie comporte toujours 27 caractères. Si le format indiqué pour générer les résultats ou que les formats d'affichage de la date et de l'heure d'Analytics comportent moins de 27 caractères, la chaîne générée est complétée par des espaces en fin de chaîne.
Informations sur les paramètres
Un champ indiqué pour DateHeure peut utiliser n'importe quel format de DateHeure, tant que la définition de champ définit correctement le format.
Si vous utilisez format pour contrôler la manière dont la chaîne de sortie est affichée, vous êtes limité aux formats de la table ci-dessous.
- Vous pouvez utiliser n'importe quelle combinaison des formats de date, d'heure et formats AM/PM.
- La date doit précéder l'heure. Placer un séparateur entre les deux n'est pas requis car Analytics utilise automatiquement un espace unique en tant que séparateur dans la chaîne de sortie.
- Le format AM/PM est facultatif et il est placé en dernier.
- format doit être indiqué à l'aide de guillemets simples ou doubles.
Par exemple : "JJ MMM AAAA hh:mm:ss AM"
Formats de date |
Formats d'heure |
Formats AM/PM |
Exemples |
---|---|---|---|
tous les formats d'affichage de la date pris en charge par Analytics |
hh:mm:ss |
aucun horloge de 24 heures |
"JJ/MM/AAAA hh:mm:ss" |
|
hhmmss |
AM, ou PM horloge de 12 heures |
"MMJJAA hhmmss PM" |
hh:mm |
A, ou P horloge de 12 heures |
"JJ-MMM-AAAA hh:mm A" |
|
|
hhmm |
|
|
hh |
|
|
Spécification d'une valeur littérale de DateHeure
Lorsque vous indiquez une valeur littérale de DateHeure pour DateHeure, vous êtes limité aux formats de la table ci-dessous, et vous devez entourer la valeur de guillemets inversés – par exemple, `20141231 235959`.
N'utilisez aucun séparateur comme les barres obliques (/) ou les deux points (:) entre les composants individuels des dates ou des heures.
-
Valeurs DateHeure : vous pouvez utiliser n'importe laquelle des combinaisons de formats de date, de séparateur et d'heure répertoriées dans le tableau ci-dessous. La date doit précéder l'heure, et vous devez utiliser un séparateur entre les deux. Les séparateurs valides sont un espace unique, la lettre « t » ou la lettre « T ».
-
Valeurs heure : vous devez indiquer l'heure à l'aide de l'horloge de 24 heures. Les décalages par rapport à l'heure universelle coordonnée (UTC) doivent être préfacés d'un signe plus (+) ou d'un signe moins (-).
Exemples de formats
Exemples de valeurs littérales
AAAAMMJJ hhmmss
`20141231 235959`
AAMMJJthhmm
`141231t2359`
AAAAMMJJThh
`20141231T23`
AAAAMMJJ hhmmss+/-hhmm
(décalage UTC)
`20141231 235959-0500`
AAMMJJ hhmm+/-hh
(décalage UTC)
`141231 2359+01`
Remarque
N'utilisez pas hh seul dans le format d'heure principal avec des données qui ont un décalage UTC. Par exemple, évitez : hh+hhmm. Il se peut que les résultats ne soient pas fiables.
Autres fonctions de conversion DateHeure
Conversion DateHeure en Caractère
Fonction | Description |
---|---|
Extrait la date d'une date ou d'une DateHeure spécifiée et la renvoie sous forme de chaîne de caractères. Peut également renvoyer la date du système d'exploitation en cours d'utilisation. |
|
Extrait l'heure d'une heure ou d'une DateHeure spécifiée et la renvoie sous forme de chaîne de caractères. Peut également renvoyer l'heure du système d'exploitation en cours d'utilisation. |
Conversion Caractère ou Numérique en DateHeure
Fonction | Description |
---|---|
Convertit une valeur de date au format Caractère ou Numérique en date. Cette fonction peut également extraire la date d'une valeur de type DateHeure au format Caractère ou Numérique et la renvoyer sous forme de date. Abréviation de "Caractère à Date". |
|
Convertit une valeur DateHeure au format Caractère ou Numérique en DateHeure. Abréviation de "Caractère à DateHeure". |
|
Convertit une valeur de type heure au format Caractère ou Numérique en heure. Cette fonction peut également extraire l'heure d'une valeur de type DateHeure au format Caractère ou Numérique et la renvoyer sous forme d'heure. Abréviation de "Caractère à Heure". |
Conversion Sérielle en DateHeure
Fonction | Description |
---|---|
Convertit une date sérielle – c'est-à-dire, une date exprimée sous forme d'intègre – en valeur de date. Abréviation de "Sérielle à Date". |
|
Convertit une valeur DateHeure sérielle – c'est-à-dire, une DateHeure exprimée sous forme d'une intègre, et une portion fractionnelle de 24 heures – en une valeur correspondant à une DateHeure. Abréviation de "Sérielle à DateHeure". |
|
Convertit une valeur horaire sérielle – c'est-à-dire une heure exprimée sous forme d'une portion fractionnelle de 24 heures, où 24 heures équivalent à 1 – en une valeur correspondant à une heure. Abréviation de "Sérielle à Heure". |