PYDATETIME( ) 函数

返回由外部 Python 脚本中的函数计算的日期时间值。Python 中的数据处理存在于 Analytics 的外部。

语法

PYDATETIME("Python 文件,Python 函数" <, 域|值 <,...n>>)

参数

名称 类型 描述
Python 文件,Python 函数

字符

要运行的 Python 脚本的名称,后面依次跟一个逗号和返回值的函数的名称:

"myScript,myFunction"

指定 Python 脚本时,请省略文件扩展名。您所调用的函数可以调用该脚本或其他脚本内的其他函数,但所有脚本在运行之前都必须被放入 PYTHONPATH 系统环境变量中的文件夹内。

要了解更多信息,请参考配置 Python 以便与 Analytics 一起使用

说明

您的 PyFunction 必须返回一个 Python 日期时间对象。

域|值 <,...n>

可选

字符

数值

日期时间

逻辑

这一包含域、表达式或字面量值的列表用作 Python 函数的参数。这些值被按照您指定它们的顺序传递给您调用的函数。

您可以根据需要包括任意数量的参数,以满足 Python 脚本中的函数定义的需要。

说明

请使用 ALLTRIM() 函数删除字符输入内容中的任何前导或结尾空格:ALLTRIM(str)。要了解更多信息,请参考ALLTRIM( ) 函数

输出

日期时间。

示例

基本示例

返回 `20170101t0500`:

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

接受一个日期参数和一个时间参数,并且返回一个组合日期时间对象的外部 Python 脚本:

# hello.py 内容
from datetime import datetime

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

高级示例

向日期时间添加时间

返回 `20160101t2230`:

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

外部 Python 脚本,它接受一个日期时间和一个时间,并且将该时间添加至日期时间:2016-01-01 15:00:00 + 7 小时 30 分钟 00 秒 = 2016-01-01 22:30:00。

# hello.py 内容
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)
ACL 脚本指南 14.1