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

CTODT( )

Convertit une valeur DateHeure au format Caractère ou Numérique en DateHeure. Abréviation de "Caractère à DateHeure".

CTOT( )

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

DATE( )

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.

DATETIME( )

Convertit une DateHeure en une chaîne de caractères. Peut également renvoyer la DateHeure du système d'exploitation en cours d'utilisation.

TIME( )

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

STOD( )

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".

STODT( )

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".

STOT( )

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".

Guide de création de scripts ACL 14.1