Fonction PYDATETIME( )

Renvoie une valeur DateHeure calculée par une fonction dans un script Python externe. Le traitement des données dans Python est externe à Analytics.

Syntaxe

PYDATETIME("fichier py;fonction py" <; champ|valeur <;...n>>)

Paramètres

Nom	Type	Description
fichier py;fonction py	caractère	Le nom du script Python à exécuter suivi d'une virgule, puis le nom de la fonction renvoyant la valeur : "monScript;maFonction" Lorsque vous indiquez le script Python, ignorez l'extension du fichier. La fonction que vous appelez peut appeler d'autres fonctions dans le script ou à l'intérieur d'autres scripts ; toutefois, tous les scripts qui s'exécutent doivent être placés à l'intérieur d'un dossier dans la variable d'environnement système PYTHONPATH avant l'exécution. Pour plus d'informations, consultez la rubrique Configuration de Python pour être utilisé avec Analytics. Remarque Votre fonction py doit renvoyer un objet DateHeure Python.
champ \|valeur <;...n> optionnel	caractère numérique DateHeure logique	Cette liste de champs, d'expressions ou de valeurs littérales à utiliser comme arguments pour la fonction Python. Les valeurs sont transmises dans la fonction que vous appelez dans l'ordre dans lequel vous les spécifiez. Vous pouvez inclure autant d'arguments que nécessaires pour répondre à la définition de la fonction dans le script Python. Remarque La fonction ALLTRIM() sert à supprimer les espaces de début ou de fin de l'entrée de caractères : ALLTRIM(str). Pour plus d'informations, consultez la rubrique Fonction ALLTRIM( ).

Nom

Type

Description

fichier py;fonction py

caractère

Le nom du script Python à exécuter suivi d'une virgule, puis le nom de la fonction renvoyant la valeur :

"monScript;maFonction"

Lorsque vous indiquez le script Python, ignorez l'extension du fichier. La fonction que vous appelez peut appeler d'autres fonctions dans le script ou à l'intérieur d'autres scripts ; toutefois, tous les scripts qui s'exécutent doivent être placés à l'intérieur d'un dossier dans la variable d'environnement système PYTHONPATH avant l'exécution.

Pour plus d'informations, consultez la rubrique Configuration de Python pour être utilisé avec Analytics.

Remarque

Votre fonction py doit renvoyer un objet DateHeure Python.

champ |valeur <;...n>

optionnel

caractère

numérique

DateHeure

logique

Cette liste de champs, d'expressions ou de valeurs littérales à utiliser comme arguments pour la fonction Python. Les valeurs sont transmises dans la fonction que vous appelez dans l'ordre dans lequel vous les spécifiez.

Vous pouvez inclure autant d'arguments que nécessaires pour répondre à la définition de la fonction dans le script Python.

Remarque

La fonction ALLTRIM() sert à supprimer les espaces de début ou de fin de l'entrée de caractères : ALLTRIM(str). Pour plus d'informations, consultez la rubrique Fonction ALLTRIM( ).

Sortie

DateHeure.

Exemples

Exemples de base

Renvoie `20170101t0500` :

PYDATETIME("hello, combine_date_time"; `20170101`; `t0500`)

Le script Python externe accepte un argument date et un argument heure, puis renvoie un objet DateHeure combiné :

# hello.py content
from datetime import datetime

def combine_date_time(d,t):
    return datetime.combine(d,t)

Exemples avancés

Ajout d'une heure à une DateHeure

Renvoie `20160101t2230` :

PYDATETIME("hello,add_time"; `20160101 150000`; `t073000`)

Script Python externe acceptant une DateHeure et une heure, puis qui ajoute l'heure à la DateHeure : 2016-01-01 15:00:00 + 7 heures, 30 minutes, 00 seconde = 2016-01-01 22:30:00.

# hello.py content
from datetime import timedelta
from datetime import datetime
from datetime import time
def add_time(start, time_to_add):
    return start + timedelta(hours=time_to_add.hour, minutes=time_to_add.minute, seconds=time_to_add.second)