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

Syntaxe

DATE(<date/DateHeure> <;format>)

Paramètres

Nom Type Description
date/DateHeure

optionnel

DateHeure

Le champ, l'expression, ou la valeur littérale à partir desquels extraire la date. 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

Renvoie "20141231" dans le format d'affichage de la date actuelle d'Analytics :

DATE(`20141231 235959`)

Renvoie "31-Déc-2014" :

DATE(`20141231 235959`; "DD-MMM-YYYY")

Renvoie la date du système d'exploitation en cours d'utilisation sous forme de chaîne de caractères, au format d'affichage de la date actuelle d'Analytics.

DATE( )

Renvoie chaque valeur du champ Reçu_horodatage sous forme de chaîne de caractères à l'aide du format d'affichage de la date Analytics actuel :

DATE(Reçu_horodatage)

Renvoie chaque valeur du champ Reçu_horodatage sous forme de chaîne de caractères à l'aide du format d'affichage de la date spécifié :

DATE(Reçu_horodatage; "DD/MM/YYYY")

Remarques

Longueur de la chaîne de sortie

La chaîne de sortie comporte toujours 12 caractères. Si le format indiqué pour générer les résultats, ou le format d'affichage de la date d'Analytics, comporte moins de 12 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 date/DateHeure peut utiliser n'importe quel format de date ou 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 s'affiche, vous pouvez utiliser n'importe quel format d'affichage de la date pris en charge par Analytics. Par exemple :

  • JJ/MM/AAAA

  • MM-JJ-AA

  • JJ MMM AAAA

format doit être indiqué à l'aide de guillemets simples ou doubles – par exemple, "JJ MMM AAAA".

Spécification d'une valeur littérale de date ou de DateHeure

Lorsque vous indiquez une valeur littérale de date ou de DateHeure pour date/DateHeure, vous êtes limité aux formats de la table ci-dessous, et vous devez entourer la valeur de guillemets inversés – par exemple, `20141231`.

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

    `20141231`

    AAMMJJ

    `141231`

    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.

     

Fonctions associées

Si vous devez renvoyer l'heure actuelle du système d'exploitation sous forme de valeur DateHeure, utilisez TODAY( ) plutôt que DATE( ).

Autres fonctions de conversion DateHeure

Conversion DateHeure en Caractère

Fonction Description

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 Caractère ou Numérique en DateHeure

Fonction Description

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

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