Fonction CTOD( )
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".
Syntaxe
CTOD(chaîne/chiffre <;format>)
Paramètres
Nom | Type | Description |
---|---|---|
chaîne/chiffre |
caractère numérique |
Le champ, l'expression, ou la valeur littérale à convertir en date, ou à partir desquels extraire la date. |
format
optionnel |
caractère |
Format de date de chaîne/chiffre. Le format est requis pour les valeurs qui utilisent tout format de date autre que AAAAMMJJ ou AAMMJJ, par exemple "JJ/MM/AAAA". Remarque Si vous utilisez la fonction CTOD avec une valeur de type DateHeure qui requiert le paramètre format, indiquez uniquement la partie du format correspondant à la date, et pas la partie correspondant à l'heure. Par exemple : CTOD("31/12/2014 23:59:59"; "JJ/MM/AAAA") Spécifier la partie heure empêche l'affichage des résultats. |
Sortie
DateHeure. La valeur de date est générée à l'aide du format d'affichage de date Analytics actuel.
Exemples
Exemples basiques
Valeur d'entrée littérale de type caractère
Renvoie `20141231` affiché au format 31 déc 2014 en supposant que le format d'affichage actuel de la date dans Analytics soit JJ MMM AAAA :
CTOD("20141231")
CTOD("31/12/2014"; "JJ/MM/AAAA")
CTOD("20141231 235959")
Valeur d'entrée littérale numérique
Renvoie `20141231` affiché au format 31 déc 2014 en supposant que le format d'affichage actuel de la date dans Analytics soit JJ MMM AAAA :
CTOD(20141231)
CTOD(31122014; "DDMMYYYY")
CTOD(20141231,235959)
Valeur d'entrée de champ de type caractère
Renvoie chaque valeur du champ caractère spécifié sous la forme d'une date, à l'aide du format d'affichage de la date d'Analytics actuel :
CTOD(Date_facture, "DD/MM/YYYY")
CTOD(Reçu_horodatage)
Valeur d'entrée de champ numérique
Renvoie chaque valeur du champ numérique spécifié sous forme de date à l'aide du format d'affichage de la date Analytics actuel :
CTOD(Date_échéance; "DDMMYYYY")
CTOD(Paiement_horodatage)
Exemples avancés
Comparaison d'un champ Caractère ou Numérique avec une date
Utilisez la fonction CTOD( ) pour comparer une date avec des champs de type caractère ou numérique, contenant des valeurs représentant des dates.
Le filtre ci-après compare deux valeurs :
- le champ numérique Date_échéance stockant les dates sous forme de nombre au format JJMMAAAA
- la valeur date littérale au 1er juillet 2014
SET FILTER TO CTOD(Date_échéance; "JJMMAAAA") < `20140701`
Remarques
Formats date requis
Les champs de caractères et les champs numériques contenant des valeurs de date ou de DateHeure doivent correspondre aux formats de la table ci-dessous. Les valeurs de DateHeure peuvent utiliser n'importe quelle combinaison de formats de date, séparateur et heure valides pour leur type de données. La date doit précéder l'heure, et il doit y avoir un séparateur entre les deux.
Les dates, ou la portion correspondant à la date des valeurs DateHeure, peuvent utiliser n'importe quel format de date pris en charge par Analytics, et valide pour ce type de données, tant que les formats autres que AAAAMMJJ ou AAMMJJ sont correctement définis par le paramètre format.
Formats de date |
Formats des séparateurs |
Formats d'heure |
---|---|---|
Champs de type caractère |
||
AAAAMMJJ |
espace unique |
hhmmss hh:mm:ss |
AAMMJJ |
la lettre ‘t’ |
hhmm hh:mm |
n'importe quel format de date pris en charge par Analytics, valide pour ce type de données, s'il est défini par format |
la lettre ‘T’ |
hh |
|
+/-hhmm +/-hh:mm (décalage UTC) |
|
|
|
+/-hh (décalage UTC) |
|
|
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. Les résultats peuvent être non fiables.) |
Champs numériques |
||
AAAAMMJJ |
point de décimale |
hhmmss |
AAMMJJ |
|
hhmm |
n'importe quel format de date pris en charge par Analytics, valide pour ce type de données, s'il est défini par format |
|
hh |
Autres fonctions de conversion DateHeure
Conversion Caractère ou Numérique en DateHeure
Fonction | Description |
---|---|
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 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. |
|
Convertit une DateHeure en une chaîne de caractères. Peut également renvoyer la DateHeure 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 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". |