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

Syntaxe

CTOT(chaîne/chiffre)

Paramètres

Nom Type Description
chaîne/chiffre

caractère

numérique

 Le champ, l'expression, ou la valeur littérale à convertir en heure, ou à partir desquels extraire l'heure.

Sortie

DateHeure. La valeur de type heure est générée à l'aide du format d'affichage de l'heure Analytics actuel.

Exemples

Exemples basiques

Valeur d'entrée littérale de type caractère

Renvoie `t235959` affiché sous la forme 23:59:59 en supposant que le format d'affichage actuel de l'heure dans Analytics soit hh:mm:ss: :

CTOT("t235959")
CTOT("23:59:59")
CTOT("20141231 235959")

Valeur d'entrée littérale numérique

Renvoie `t235959` affiché sous la forme 23:59:59 en supposant que le format d'affichage actuel de l'heure dans Analytics soit hh:mm:ss: :

CTOT(,235959)
CTOT(0,235959)
CTOT(20141231,235959)

Valeur d'entrée de champ de type caractère

Renvoie chaque valeur du champ de type caractère Heure_connexion sous la forme d'une heure, à l'aide du format d'affichage de l'heure d'Analytics actuel :

CTOT(Heure_connexion)

Valeur d'entrée de champ numérique

Renvoie chaque valeur du champ numérique Paiement_dateheure sous forme d'heure, sans partie date, à l'aide du format d'affichage de l'heure d'Analytics actuel :

CTOT(Paiement_dateheure)

Exemples avancés

Comparaison d'un champ Caractère ou Numérique avec une heure

Utilisez la fonction CTOT( ) pour comparer une heure avec des champs de type caractère ou numérique, contenant des valeurs représentant des heures.

Le filtre ci-après compare deux valeurs :

  • le champ numérique Heure_connexion stockant des heures sous forme de données numériques
  • la valeur heure littérale 09:30:00
SET FILTER TO CTOT(Heure_connexion) > `t093000`

Remarques

Formats DateHeure requis

Les champs de caractères et les champs numériques contenant des valeurs d'heure ou de DateHeure doivent correspondre aux formats de la table ci-dessous.

Les valeurs d'heure peuvent utiliser n'importe quelle combinaison de format de séparateur et heure. Il doit y avoir un séparateur avant la valeur d'heure, ou des deux-points entre les composants de l'heure, pour que la fonction s'exécute correctement.

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.

Utilisez la fonction CTOD( ) si vous souhaitez convertir une valeur de type date au format Caractère ou Numérique en date, ou extraire la date d'une valeur de type DateHeure au format Caractère ou Numérique et la renvoyer sous forme de date.

Utilisez la fonction CTODT( ) si vous souhaitez convertir une valeur de type DateHeure au format Caractère ou Numérique en DateHeure.

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

 

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

 

 

hh

Autres fonctions de conversion DateHeure

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

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