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

Syntaxe

STODT(DateHeure_sérielle <;date_début>)

Paramètres

Nom	Type	Description
DateHeure_sérielle	numérique	Le champ, l'expression, ou la valeur littérale à convertir. Des valeurs de DateHeure sérielle avec les portions correspondant à la date et à l'heure séparées par une virgule de décimale sont requises. Par exemple, 42003,75000
date_début optionnel	DateHeure	La date de début à partir de laquelle les dates sérielles sont calculées. Si ce paramètre est ignoré, la date de début par défaut du 01 janvier 1900 est utilisée.

Nom

Type

Description

DateHeure_sérielle

numérique

Le champ, l'expression, ou la valeur littérale à convertir.

Des valeurs de DateHeure sérielle avec les portions correspondant à la date et à l'heure séparées par une virgule de décimale sont requises. Par exemple, 42003,75000

date_début

optionnel

DateHeure

La date de début à partir de laquelle les dates sérielles sont calculées. Si ce paramètre est ignoré, la date de début par défaut du 01 janvier 1900 est utilisée.

Sortie

DateHeure. La valeur de DateHeure est générée à l'aide des formats d'affichage de date et d'heure Analytics actuels.

Exemples

Exemples basiques

Dates de début non ajustées

Renvoie `20141231t060000` affiché au format 31 déc 2014 06:00:00 AM en supposant que les formats d'affichage actuels de la date et de l'heure dans Analytics soient JJ MMM AAAA et hh:mm:ss PM :

STODT(42003,25000)

Renvoie `20141231t191530` affiché au format 31 déc 2014 07:15:30 AM en supposant que les formats d'affichage actuels de la date et de l'heure dans Analytics soient JJ MMM AAAA et hh:mm:ss PM :

STODT(42003,802431)

Dates de début ajustées

Renvoie `20181231t120000` affiché au format 31 déc 2018 12:00:00 AM en supposant que les formats d'affichage actuels de la date et de l'heure dans Analytics soient JJ MMM AAAA et hh:mm:ss PM :

STODT(42003,50000; `19040101`)

Champs comme valeurs d'entrée

Renvoie la DateHeure équivalente pour chaque valeur de DateHeure sérielle du champ Reçu_DateHeure :

STODT(Reçu_DateHeure)

Exemples avancés

Ajustement d'une date de début antérieure au 01-01-1900

Utilisez une date arithmétique pour remplacer la date de début par une valeur antérieure à la date minimale d'Analytics du 1er janvier 1900 :

Convertissez la DateHeure sérielle à l'aide de la date de début par défaut.
Soustrayez le nombre de jours s'écoulant entre la date de début réelle et le 01-01-1900.

Pour utiliser 01-01-1899 comme date de début (évaluée sur `20131231t180000`) :

STODT(42003,75000) - 365

Remarques

Fonctionnement

La fonction STODT( ) vous permet de convertir des DateHeures sérielles en DateHeures ordinaires. Les DateHeures sérielles d'Analytics représentent le nombre de jours qui se sont écoulés depuis le 01 janvier 1900, et après la virgule de décimale, représentent une portion fractionnelle de 24 heures, où 24 heures équivalent à 1.

DateHeure sérielle	Équivalent en DateHeures ordinaires
1,25	02 janvier 1900 06:00:00 AM
365,75000	31 décembre 1900 06:00:00 PM
42003,79167	31 décembre 2014 07:00:00 PM
42003,802431	31 décembre 2014 07:15:30 PM
42003,00000	31 décembre 2014 12:00:00 AM
42003,50000	31 décembre 2014 12:00:00 PM
0,0	non valide

Pour plus d'informations sur les DateHeures sérielles, consultez la section DateHeures sérielles.

Comparaisons entre les dates sérielles Analytics et les dates sérielles Excel

Les dates sérielles d'Analytics sont similaires aux dates sérielles de Microsoft Excel. Vous devez avoir conscience d'un point clé de similitude et d'un point clé de différence. Les deux points ne sont pas liés.

Points communs

Analytics et Excel traitent tous les deux l'année 1900 comme une année bissextile, avec 366 jours. Bien que 1900 n'ait pas été en réalité une année bissextile, Excel l'a traitée ainsi afin de maintenir la compatibilité avec Lotus 1-2-3.

Différences

Les dates sérielles d'Analytics sont calculées à partir des dates sérielles d'Excel par une journée. Dans Excel, le 01 janvier 1900 a une date sérielle de '1'. Dans Analytics, le 01 janvier 1900 n'est pas compté, et le 02 janvier 1900 a une date sérielle de '1'.

date_début

Certains fichiers de données source peuvent utiliser une date de début autre que le 01 janvier 1900. date_début vous permet de faire correspondre la date de départ dans un fichier de données source. La date de début est la date à partir de laquelle les DateHeures sérielles sont calculées.

Date de début dans le fichier de données source	Indiquez :	Détails
01 janvier 1900	STODT(champ_dateheure)	ll n'est pas nécessaire d'indiquer une date_début, car 01 janvier 1900 est la date de début par défaut.
01 janvier 1901	STODT(champ_dateheure; `19010101`)	Vous spécifiez une date_début de `19010101` pour faire correspondre la date de début du 01 janvier 1901 utilisée dans le fichier de données source.
01 janvier 1899	STODT(champ_dateheure) - 365	Vous ne pouvez pas indiquer une date_début antérieure au 01 janvier 1900. Si un fichier de données source utilise une date de début antérieure au 01 janvier 1900, vous pouvez créer une expression DateHeure qui soustrait un nombre approprié de jours des résultats de sortie de la fonction STODT( ).

Autres fonctions de conversion DateHeure

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

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

[ Retour au début ]

Guide de création de scripts ACL 14.1