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

Syntaxe

TIME(<heure/DateHeure> <;format>)

Paramètres

Nom Type Description
heure/DateHeure

optionnel

DateHeure

Le champ, l'expression, ou la valeur littérale à partir desquels extraire l'heure. Si ce paramètre est omis, c'est l'heure actuelle du système d'exploitation qui est renvoyée au format hh:mm:ss.
format

optionnel

 caractère

Format à appliquer à la chaîne de sortie, par exemple "hh:mm:ss". Si ce paramètre est ignoré, le format d'affichage de l'heure actuel d'Analytics est utilisé. Vous ne pouvez pas indiquer de format si vous avez ignoré heure/DateHeure.

Sortie

Caractère.

Exemples

Exemples basiques

Valeurs d'introduction littérales

Renvoie "23:59:59" en supposant que le format d'affichage de l'heure Analytics soit hh:mm:ss:

TIME(`20141231 235959`)

Renvoie "11:59 P":

TIME(`20141231 235959`; "hh:mm A")

Renvoie l'heure actuelle du système d'exploitation renvoyée sous forme de chaîne de caractères au format hh:mm:ss format (horloge de 24 heures) :

TIME()

Champ comme valeurs d'introduction

Renvoie une chaîne de caractères pour chaque valeur du champ Reçu_horodatage, à l'aide du format d'affichage de l'heure actuelle d'Analytics :

TIME(Reçu_horodatage)

Renvoie une chaîne de caractères pour chaque valeur du champ Reçu_horodatage, à l'aide du format d'affichage de l'heure spécifié :

TIME(Reçu_horodatage;  "hh:mm:ss")

Exemples avancés

Calcul du temps écoulé pendant l'exécution d'une commande ou d'un script

Utilisez la fonction TIME( ) pour vous aider à calculer la durée d'exécution d'une commande Analytics en particulier ou d'un script tout entier.

Juste avant la commande sur laquelle vous souhaitez appliquer la fonction TIME, ou au début du script, indiquez cette ligne pour créer une variable qui stocke l'heure du système d'exploitation en cours d'utilisation :

ASSIGN Heure_début = TIME()

Juste après la commande, ou à la fin du script, indiquez les deux lignes ci-dessous.

La première ligne crée une variable qui stocke l'heure du système d'exploitation à la fin de l'exécution de la commande ou du script. La deuxième ligne calcule la différence entre les heures de début et de fin, puis convertit le résultat dans un format facilement lisible.

Astuce

Vous pouvez double-cliquer sur l'entrée de la trace CALCULATE afin de voir le temps écoulé pendant l'exécution de la commande ou du script.

ASSIGN Heure_fin = TIME()
CALCULATE STOT(CTOT(Heure_fin) - CTOT(Heure_début))

Si l'exécution de la commande ou du script franchit la ligne de changement de date, utilisez plutôt cette deuxième ligne :

CALCULATE `T000000` - (CTOT(Heure_début) - CTOT(Heure_fin))

Remarques

Longueur de la chaîne de sortie

La chaîne de sortie comporte toujours 14 caractères. Si le format indiqué pour générer les résultats ou que le format d'affichage de l'heure d'Analytics comporte moins de 14 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 heure/DateHeure peut utiliser n'importe quel format d'heure 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 est affichée, vous êtes limité aux formats de la table ci-dessous. Vous pouvez utiliser n'importe quelle combinaison des formats d'heure et formats AM/PM. Le format AM/PM est facultatif et il est placé en dernier.

Indiquez format à l'aide de guillemets simples ou doubles. Par exemple : "hh:mm:ss AM"

Formats d'heure

Formats AM/PM

Exemples

hh:mm:ss

aucun

horloge de 24 heures

"hh:mm:ss"

hhmmss

AM, ou PM

horloge de 12 heures

"hhmmss PM"

hh:mm

A, ou P

horloge de 12 heures

"hh:mm A"

hhmm

 

  

hh

 

 

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

Lorsque vous indiquez une valeur littérale d'heure ou de DateHeure pour heure/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 heure : vous pouvez utiliser n'importe quel format d'heure répertorié dans le tableau ci-dessous. Vous devez utiliser un séparateur avant une valeur d'heure autonome pour que la fonction s'exécute correctement. Les séparateurs valides sont la lettre « t » ou la lettre « T ». Vous devez indiquer les heures à 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 (-).

  • 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 ».

    Exemples de formats

    Exemples de valeurs littérales

    thhmmss

    `t235959`

    Thhmm

    `T2359`

    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 NOW( ) plutôt que TIME( ).

Autres fonctions de conversion DateHeure

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.

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