DATASTAGE日期和时间函数

DATASTAGE日期和时间函数_官方文档译文

原文链接：https://www.ibm.com/docs/en/iis/11.5?topic=functions-date-time

你可以使用日期和时间函数在Transformer阶段执行关于日期和时间的各种操作。

这些函数中，用于指定日期、时间或时间戳的参数采用特定格式的字符串：

对于日期，格式为 %yyyy-%mm-%dd
对于时间，格式为 %hh:%nn:%ss。若扩展到包含微秒，则格式为 %hh:%nn:%ss.x，其中 x 表示秒的小数位数。
对于时间戳，格式为日期格式后跟时间格式。

带有星期几的参数的函数采用字符串来指定星期几。星期以三个字母的缩写或全名指定。例如，字符串 “thu” 和 “thursday” 都是有效的。

以下是表达式编辑器中“日期与时间”类别中的一些函数。方括号表示参数是可选的。示例展示了该函数在Transformer阶段的派生字段中的使用。

CurrentDate

返回作业运行的日期。

输入：无
输出：日期 (date)
示例：使用此函数在Transformer阶段的输出数据中添加一个包含日期的新列。

CurrentDate()

CurrentTime

返回作业运行的时间。

输入：无
输出：时间 (time)
示例：使用此函数在Transformer阶段的输出数据中添加一个包含时间的新列。

CurrentTime()

CurrentTimeMS

返回作业运行的时间，包括微秒。

输入：无
输出：时间 (time)
示例：使用此函数在Transformer阶段的输出数据中添加一个包含时间的新列。必须将列元数据中的“Extended”字段设置为“Microseconds”以包含完整的时间。

CurrentTimeMS()

CurrentTimestamp

返回作业运行的日期和时间戳。

输入：无
输出：时间戳 (timestamp)
示例：使用此函数在Transformer阶段的输出数据中添加一个包含时间戳的新列。

CurrentTimestamp()

CurrentTimestampMS

返回作业运行的日期和时间戳，包括微秒。

输入：无
输出：时间戳 (timestamp)
示例：使用此函数在Transformer阶段的输出数据中添加一个包含时间戳的新列。必须将列元数据中的“Extended”字段设置为“Microseconds”以包含完整的时间戳。

CurrentTimestampMS()

DateFromDaysSince

通过将整数添加到基准日期来返回日期字符串。整数可以为负以返回早于基准日期的日期。此函数在IBM® InfoSphere® Information Server，版本11.3中已弃用。请使用DateFromDaysSince2函数。

输入： number (int32), [baseline_date_string (string)]
输出：日期 (date)
示例：如果 mylink.myintcol 包含整数18250，mylink.mydatecol 包含日期1958–08–18，则以下三个函数是等效的，并返回日期2008–08–05：

DateFromDaysSince(18250, "1958-08-18")
DateFromDaysSince(mylink.myintcol, "1958-08-18")
DateFromDaysSince(mylink.myintcol, mylink.mydatecol)

如果 mylink.mynegintcol 包含整数-1，mylink.mydatecol 包含日期1958–08–18，则以下三个函数是等效的，并返回日期1958–08–17：

DateFromDaysSince(-1, "1958-08-18")
DateFromDaysSince(mylink.mynegintcol, "1958-08–18")
DateFromDaysSince(mylink.mynegintcol, mylink.mydatecol)

DateFromDaysSince2

通过将整数添加到基准日期来返回日期对象。整数可以为负以返回早于基准日期的日期。

输入： number (int32), [baseline_date_object (date)]
输出：日期 (date)
示例：如果 mylink.myintcol 包含整数18250，mylink.mydatecol 包含日期1958–08–18，则以下三个函数是等效的，并返回日期2008–08–05：

DateFromDaysSince2(18250, "1958-08-18")
DateFromDaysSince2(mylink.myintcol, "1958-08–18")
DateFromDaysSince2(mylink.myintcol, mylink.mydatecol)

如果 mylink.mynegintcol 包含整数-1，mylink.mydatecol 包含日期1958–08–18，则以下三个函数是等效的，并返回日期1958–08–17：

DateFromDaysSince2(-1, "1958-08–18")
DateFromDaysSince2(mylink.mynegintcol, "1958-08–18")
DateFromDaysSince2(mylink.mynegintcol, mylink.mydatecol)

DateFromComponents

根据给定的年、月和日，返回一个日期，这些年、月和日作为三个单独的值给出。

输入： years (int32), months (int32), dayofmonth (int32)
输出：日期 (date)
示例：如果 mylink.yearcol 包含值2010，mylink.monthcol 包含值12，mylink.dayofmonthcol 包含值2，则以下两个函数是等效的，并返回日期2010–12–02。

DateFromComponents(2010, 12, 2)
DateFromComponents(mylink.yearcol, mylink.monthcol, mylink.dayofmonthcol)

DateFromJulianDay

根据给定的儒略日返回日期。

输入： julianday (uint32)
输出：日期 (date)
示例：如果 mylink.myjulcol 包含值2454614，则以下两个函数是等效的，并返回日期2008–05–27。

DateFromJulianDay(2454614)
DateFromJulianDay(mylink.myjulcol)

DateOffsetByComponents

返回给定的日期，应用来自给定年份偏移、月份偏移和月份日期偏移的偏移量，这三个值分别作为输入。偏移值可以是正数、零或负数。

输入： basedate (date)，year_offset (int32)，month_offset (int32)，dayofmonth_offset (int32)
输出： date (date)
示例：
如果 mylink.basedate 包含 2011-08-18，而 mylink.yearos 包含值 2，mylink.monthos 包含值 0，mylink.dayofmonthosol 包含值 0，那么以下两个函数是等效的，都返回日期 2013–08–18。

DateOffsetByComponents("2011-08-18", 2, 0, 0)
DateOffsetByComponents(mylink.basedate, mylink.yearos, mylink.monthos, mylink.dayofmonthos)

如果 mylink.basedate 包含 2011-08-18，而 mylink.yearos 包含值 -2，mylink.monthos 包含值 0，mylink.dayofmonthosol 包含值 0，那么以下两个函数是等效的，都返回日期 2009–08–18。

DateOffsetByComponents("2011-08-18", -2, 0, 0)
DateOffsetByComponents(mylink.basedate, mylink.yearos, mylink.monthos, mylink.dayofmonthos)

DaysSinceFromDate

返回从源日期到给定日期的天数。在IBM InfoSphere Information Server 11.3中，此函数已被弃用，请使用DaysSinceFromDate2函数。

输入： given_date (date)，source_date_string (string)
输出： days_since (int32)
示例：
如果 mylink.mysourcedate 包含日期 1958–08–18，而 mylink.mygivendate 包含日期 2008–08–18，那么以下两个函数是等效的，都返回整数值 18263。

DaysSinceFromDate(mylink.mygivendate, mylink.mysourcedate)
DaysSinceFromDate("2008-08-18", "1958-08-18")

DaysSinceFromDate2

返回从源日期到给定日期的天数。

输入： given_date (date)，source_date_object (date)
输出： days_since (int32)
示例：
如果 mylink.mysourcedate 包含日期 1958–08–18，而 mylink.mygivendate 包含日期 2008–08–18，那么以下两个函数是等效的，都返回整数值 18263。

DaysSinceFromDate2(mylink.mygivendate, mylink.mysourcedate)
DaysSinceFromDate2("2008-08-18", "1958-08-18")

DaysInMonth

返回给定基准日期的月份中的天数。

输入： basedate (date)
输出： daysinmonth (int32)
示例：
如果 mylink.mysourcedate 包含日期 1958–08–18，那么以下两个函数是等效的，都返回整数值 31。

DaysInMonth(mylink.mysourcedate)
DaysInMonth("1958-08-18")

DaysInYear

返回给定基准日期的年份中的天数。

输入： basedate (date)
输出： daysinyearh (int32)
示例：
如果 mylink.mysourcedate 包含日期 2012–08–18，那么以下两个函数是等效的，都返回整数值 366。

DaysInYear(mylink.mysourcedate)
DaysInYear("2012-08-18")

如果 mylink.mysourcedate 包含日期 2011–08–18，那么以下两个函数是等效的，都返回整数值 365。

DaysInYear(mylink.mysourcedate)
DaysInYear("2011-08-18")

DateOffsetByDays

返回给定日期偏移给定天数后的日期。偏移值可以是正数、零或负数。

输入： basedate (date)，dayoffset (int32)
输出： date (date)
示例：
如果 mylink.basedate 包含 2011-08-18，而 mylink.dayoffset 包含值 2，那么以下两个函数是等效的，都返回日期 2011–08–20。

DateOffsetByDays("2011-08-18", 2)
DateOffsetByDays(mylink.basedate, mylink.dayoffset)

如果 mylink.basedate 包含 2011-08-18，而 mylink.dayoffset 包含值 -31，那么以下两个函数是等效的，都返回日期 2011–07–18。

DateOffsetByDays("2011-08-18", -31)
DateOffsetByDays(mylink.basedate, mylink.dayoffset)

HoursFromTime

返回时间的小时部分。

输入： time (time)
输出： hours (int8)
示例：
如果 mylink.mytime 包含时间 22:30:00，那么以下两个函数是等效的，都返回整数值 22。

HoursFromTime(mylink.mytime)
HoursFromTime("22:30:00")

JulianDayFromDate

从给定日期返回儒略日数。

输入： date (date)
输出： julianday (int32)
示例：
如果 mylink.mydate 包含日期 2008–05–27，那么以下两个函数是等效的，都返回值 2454614。

JulianDayFromDate("2008–05–27")
JulianDayFromDate(mylink.mydate)

MicroSecondsFromTime

返回时间的微秒部分。

输入： time (time)
输出： microseconds (int32)
示例：
如果 mylink.mytime 包含时间 22:30:00.32，那么以下函数返回值 320000：

MicroSecondsFromTime(mylink.mytime)

当然，以下是使用Markdown格式的翻译：

MidnightSecondsFromTime

返回从午夜到给定时间的秒数。

输入：时间（time）
输出：秒数（int8）
示例：如果mylink.mytime包含时间00:30:52，则以下两个函数等效，返回值为1852：
```
MidnightSecondsFromTime("00:30:52")
MidnightSecondsFromTime(mylink.mytime)
```

MinutesFromTime

返回时间的分钟部分。

输入：时间（time）
输出：分钟（int8）
示例：如果mylink.mytime包含时间22:30:52，则以下两个函数等效，返回值为30：
```
MinutesFromTime("22:30:52")
MinutesFromTime(mylink.mytime)
```

MonthDayFromDate

从给定日期返回月份中的日期。

输入：日期（date）
输出：日期（int8）
示例：如果mylink.mydate包含日期2008-08-18，则以下两个函数等效，返回值为18：
```
MonthDayFromDate("2008-08-18")
MonthDayFromDate(mylink.mydate)
```

MonthFromDate

从给定日期返回月份编号。

输入：日期（date）
输出：月份编号（int8）
示例：如果mylink.mydate包含日期2008-08-18，则以下两个函数等效，返回值为8：
```
MonthFromDate("2008-08-18")
MonthFromDate(mylink.mydate)
```

NextWeekdayFromDate

返回源日期之后最接近的指定星期几的日期。星期几用全名或缩写指定。

输入：源日期（date），星期几（string）
输出：日期（date）
示例：如果mylink.mysourcedate包含日期2008-08-18，星期四指定为Thursday，则以下两个函数等效，返回值为2008-08-21：
```
NextWeekdayFromDate("2008-08-18", "thursday")
NextWeekdayFromDate(mylink.mysourcedate, "thu")
```

NthWeekdayFromDate

返回源日期之后指定周数偏移的星期几的日期。星期几用全名或缩写指定，偏移值可以为正、负或零。

输入：基准日期（date），星期几（string），周偏移（int32）
输出：日期（date）
示例：如果mylink.mydate包含日期2009-08-18，星期四指定为thursday，偏移为1，则以下两个函数等效，返回值为2009-08-20：
```
NthWeekdayFromDate("2009-08-18", "thursday", 1)
NthWeekdayFromDate(mylink.mydate, "thu", 1)
```
返回两周前的星期四的日期。如果mylink.mydate包含日期2009-08-18，星期四指定为thursday，偏移为-2，则以下两个函数等效，返回值为2009-08-06：
```
NthWeekdayFromDate("2009-08-18", "thursday", -2)
NthWeekdayFromDate(mylink.mydate, "thu", -2)
```

PreviousWeekdayFromDate

返回源日期之前最近的指定星期几的日期。星期几用全名或缩写指定。

输入：源日期（date），星期几（string）
输出：日期（date）
示例：如果mylink.mysourcedate包含日期2008-08-18，星期四指定为thursday，则以下两个函数等效，返回值为2008-08-14：
```
PreviousWeekdayFromDate("2008-08-18", "thursday")
PreviousWeekdayFromDate(mylink.mysourcedate, "thu")
```

SecondsFromTime

返回时间的秒部分。

输入：时间（time）
输出：秒数（dfloat）
示例：如果mylink.mytime包含时间22:30:52，则以下两个函数等效，返回值为52：
```
SecondsFromTime("22:30:52")
SecondsFromTime(mylink.mytime)
```

SecondsSinceFromTimestamp

返回两个时间戳字符串之间的秒数。此函数已弃用，请使用SecondsSinceFromTimestamp2函数。

输入：时间戳（timestamp），基础时间戳字符串（string）
输出：秒数（dfloat）
示例：如果mylink.mytimestamp包含时间戳2008-08-18 22:30:52，而mylink.mytimestamp_base包含时间戳2008-08-19 22:30:52，则以下两个函数等效，返回值为-86400：
```
SecondsSinceFromTimestamp("2008-08-18 22:30:52", "2008-08-19 22:30:52")
SecondsSinceFromTimestamp(mylink.mytimestamp, mylink.mytimestamp_base)
```

SecondsSinceFromTimestamp2

返回两个时间戳对象之间的秒数。

输入：时间戳（timestamp），基础时间戳对象（timestamp）
输出：秒数（dfloat）
示例：如果mylink.mytimestamp包含时间戳2008-08-18 22:30:52，而mylink.mytimestamp_base包含时间戳2008-08-19 22:30:52，则以下两个函数等效，返回值为-86400：
```
SecondsSinceFromTimestamp2("2008-08-18 22:30:52", "2008-08-19 22:30:52")
SecondsSinceFromTimestamp2(mylink.mytimestamp, mylink.mytimestamp_base)
```

TimeDate

返回系统时间和日期的格式化字符串。

输入：无
输出：系统时间和日期（string）
示例：如果任务在2008年6月20日下午4:21运行，则以下函数返回字符串“16:

21:48 20 Jun 2008”。

TimeDate()

TimeFromComponents

从给定的小时、分钟、秒和微秒返回时间，这些值分别作为四个独立的值给出。

输入：小时（int32），分钟（int32），秒（int32），微秒（int32）
输出：时间（date）
示例：如果mylink.hourcol包含值10，mylink.mincol包含值12，mylink.seccol包含值2，mylink.mseccol包含0，则以下两个函数等效，返回时间10:12:02.0：
```
TimeFromComponents(10, 12, 2, 0)
TimeFromComponents(mylink.hourcol, mylink.mincol, mylink.seccol, mylink.mseccol)
```

TimeFromMidnightSeconds

返回给定秒数自午夜以来的时间。

输入：秒数（dfloat）
输出：时间（time）
示例：如果mylink.mymidnightseconds包含值240，则以下两个函数等效，返回值00:04:00：
```
TimeFromMidnightSeconds("240")
TimeFromMidnightSeconds(mylink.mymidnightseconds)
```

TimeOffsetByComponents

从基准时间开始，使用小时偏移、分钟偏移和秒偏移各自作为独立的值，返回带有偏移的时间。

输入：基准时间（time），小时偏移（int32），分钟偏移（int32），秒偏移（dfloat）
输出：时间（time）
示例：如果mylink.basetime包含14:05:29，mylink.houros包含值2，mylink.minos包含值0，mylink.secos包含值20，则以下两个函数等效，返回时间16:05:49。
```
TimeOffsetByComponents("14:05:29", 2, 0, 20)
TimeOffsetByComponents(mylink.basetime, mylink.houros, mylink.minos, mylink.secos)
```

TimeOffsetBySeconds

从基准时间开始，使用秒偏移，返回带有偏移的时间。

输入：基准时间（time），秒偏移（dfloat）
输出：时间（time）
示例：如果mylink.basetime包含14:05:29.30，mylink.secos包含值2.5，则以下两个函数等效，返回时间14:05:31.80。
```
TimeOffsetByComponents("14:05:29.30", 2.5)
TimeOffsetByComponents(mylink.basetime, mylink.secos)
```

TimestampFromDateTime

从给定的日期和时间返回时间戳。

输入：日期（date），时间（time）
输出：时间戳（timestamp）
示例：如果mylink.mydate包含日期2008-08-18，而mylink.mytime包含时间22:30:52，则以下两个函数等效，返回时间戳2008-08-18 22:30:52：
```
TimestampFromDateTime("2008-08-18", "22:30:52")
TimestampFromDateTime(mylink.mydate, mylink.mytime)
```

TimestampFromSecondsSince

从基准时间戳字符串和秒数返回时间戳。此函数已弃用，请使用TimestampFromSecondsSince2函数。

输入：秒数（dfloat），[基准时间戳字符串（string）]
输出：时间戳（timestamp）
示例：如果mylink.myseconds包含值2563，而mylink.timestamp_base包含时间戳2008-08-18 22:30:52，则以下两个函数等效，返回时间戳2008-08-18 23:13:35：
```
TimestampFromSecondsSince("2563", "2008-08-18 22:30:52")
TimestampFromSecondsSince(mylink.myseconds, mylink.timestamp_base)
```

TimestampFromSecondsSince2

从基准时间戳对象和秒数返回时间戳。

输入：秒数（dfloat），[基准时间戳对象（timestamp）]
输出：时间戳（timestamp）
示例：如果mylink.myseconds包含值2563，而mylink.timestamp_base包含时间戳2008-08-18 22:30:52，则以下两个函数等效，返回时间戳2008-08-18 23:13:35：
```
TimestampFromSecondsSince2("2563", "2008-08-18 22:30:52")
TimestampFromSecondsSince2(mylink.myseconds, mylink.timestamp_base)
```

TimestampFromTimet

从给定的UNIX time_t字符串值返回时间戳。

输入：timet_string（int32）
输出：时间戳（timestamp）
示例：如果mylink.mytimet包含值1234567890，则以下两个函数等效，返回时间戳2009-02-13 23:31:30：
```
TimestampFromTimet("1234567890")
TimestampFromTimet(mylink.mytimet)
```

SecondsSinceFromTimestamp

返回两个时间戳字符串之间的秒数。在IBM InfoSphere Information Server 11.3版本中，此函数已弃用。请使用SecondsSinceFromTimestamp2函数。

输入：时间戳（timestamp），基础时间戳字符串（string）
输出：秒数（dfloat）
示例：如果mylink.mytimestamp包含时间戳2008–08–18 22:30:52，而mylink.mytimestamp_base包含时间戳2008–08–19 22:30:52，则以下两个函数等效，返回值为-86400：

    SecondsSinceFromTimestamp("2008–08–18 22:30:52", "2008–08–19 22:30:52")SecondsSinceFromTimestamp(mylink.mytimestamp, mylink.mytimestamp_base)

SecondsSinceFromTimestamp2

返回两个时间戳对象之间的秒数。

输入：时间戳（timestamp），基础时间戳对象（timestamp）
输出：秒数（dfloat）
示例：如果mylink.mytimestamp包含时间戳2008–08–18 22:30:52，而mylink.mytimestamp_base包含时间戳2008–08–19 22:30:52，则以下两个函数等效，返回值为-86400：

    SecondsSinceFromTimestamp2("2008–08–18 22:30:52", "2008–08–19 22:30:52")SecondsSinceFromTimestamp2(mylink.mytimestamp, mylink.mytimestamp_base)

TimeDate

返回系统时间和日期的格式化字符串。

输入：无
输出：系统时间和日期（string）
示例：如果任务在2008年6月20日下午4:21运行，则以下函数返回字符串“16:21:48 20 Jun 2008”。

    TimeDate()

TimeFromComponents

从给定的小时、分钟、秒和微秒返回时间，这些值分别作为四个独立的值给出。

输入：小时（int32），分钟（int32），秒（int32），微秒（int32）
输出：时间（date）
示例：如果mylink.hourcol包含值10，mylink.mincol包含值12，mylink.seccol包含值2，mylink.mseccol包含0，则以下两个函数等效，返回时间10:12:02.0：

    TimeFromComponents(10, 12, 2, 0)TimeFromComponents(mylink.hourcol, mylink.mincol, mylink.seccol, mylink.mseccol)

TimeFromMidnightSeconds

返回给定秒数自午夜以来的时间。

输入：秒数（dfloat）
输出：时间（time）
示例：如果mylink.mymidnightseconds包含值240，则以下两个函数等效，返回值00:04:00：

    TimeFromMidnightSeconds("240")TimeFromMidnightSeconds(mylink.mymidnightseconds)

TimeOffsetByComponents

从基准时间开始，使用小时偏移、分钟偏移和秒偏移各自作为独立的值，返回带有偏移的时间。

输入：基准时间（time），小时偏移（int32），分钟偏移（int32），秒偏移（dfloat）
输出：时间（time）
示例：如果mylink.basetime包含14:05:29，mylink.houros包含值2，mylink.minos包含值0，mylink.secos包含值20，则以下两个函数等效，返回时间16:05:49。

    TimeOffsetByComponents("14:05:29", 2, 0, 20)TimeOffsetByComponents(mylink.basetime, mylink.houros, mylink.minos, mylink.secos)

TimeOffsetBySeconds

从基准时间开始，使用秒偏移，返回带有偏移的时间。

输入：基准时间（time），秒偏移（dfloat）
输出：时间（time）
示例：如果mylink.basetime包含14:05:29.30，mylink.secos包含值2.5，则以下两个函数等效，返回时间14:05:31.80。

    TimeOffsetByComponents("14:05:29.30", 2.5)TimeOffsetByComponents(mylink.basetime, mylink.secos)

TimestampFromDateTime

从给定的日期和时间返回时间戳。

输入：日期（date），时间（time）
输出：时间戳（timestamp）
示例：如果mylink.mydate包含日期2008–08–18，而mylink.mytime包含时间22:30:52，则以下两个函数等效，返回时间戳2008–08–18 22:30:52：

    TimestampFromDateTime("2008–08–18", "22:30:52")TimestampFromDateTime(mylink.mydate, mylink.mytime)

TimestampFromSecondsSince

返回两个时间戳字符串之间的秒数。此函数已弃用，请使用TimestampFromSecondsSince2函数。

输入：秒数（dfloat），[基准时间戳字符串（string）]
输出：时间戳（timestamp）
示例：如果mylink.myseconds包含值2563，而mylink.timestamp_base包含时间戳2008–08–18 22:30:52，则以下两个函数等效，返回时间戳2008–08–18 23:13:35：

    TimestampFromSecondsSince("2563", "2008–08–18 22:30:52")TimestampFromSecondsSince(mylink.myseconds, mylink.timestamp_base)

TimestampFromSecondsSince2

返回两个时间戳对象之间的秒数。

输入：秒数（dfloat），[基准时间戳对象（timestamp）]
输出：时间戳（timestamp）
示例：如果mylink.myseconds

包含值2563，而mylink.timestamp_base包含时间戳2008–08–18 22:30:52，则以下两个函数等效，返回时间戳2008–08–18 23:13:35：

    TimestampFromSecondsSince2("2563", "2008–08–18 22:30:52")TimestampFromSecondsSince2(mylink.myseconds, mylink.timestamp_base)

TimestampFromTimet

从给定的UNIX time_t字符串值返回时间戳。

输入：timet_string（int32）
输出：时间戳（timestamp）
示例：如果mylink.mytimet包含值1234567890，则以下两个函数等效，返回时间戳2009–02–13 23:31:30：

    TimestampFromTimet("1234567890")TimestampFromTimet(mylink.mytimet)

TimestampFromTime2

从给定的时间和时间戳对象返回时间戳。时间对象中的值覆盖时间戳对象中的时间值，只使用时间戳中的日期部分。

输入：时间（time），时间戳（timestamp）
输出：时间戳（timestamp）
示例：如果mylink.mytime包含时间12:03:22，而mylink.mytimestamp包含时间戳2008–08–18 22:30:52，则以下两个函数等效，返回时间戳2008–08–18 12:03:22：

    TimestampFromTime2("12:03:22", "2008–08–18 22:30:52")TimestampFromTime2(mylink.mytime, mylink.mytimestamp)

TimestampOffsetByComponents

从基准时间戳开始，使用年偏移、月偏移、日偏移、小时偏移、分钟偏移和秒偏移各自作为独立的值，返回带有偏移的时间戳。秒偏移可以包括微秒。

输入：基准时间戳（timestamp），年偏移（int32），月偏移（int32），日偏移（int32），小时偏移（int32），分钟偏移（int32），秒偏移（dfloat）
输出：时间戳（timestamp）
示例：如果mylink.basetimestamp包含2009-08-18 14:05:29，而mylink.yearos包含值0，mylink.monthos包含值2，mylink.dayos包含值-4，mylink.houros包含值2，mylink.minos包含值0，mylink.secos包含值20，则以下两个函数等效，返回时间戳2009-10-14 16:05:49。

    TimestampOffsetByComponents("2009-08-18 14:05:29", 0, 2, -4, 2, 0, 20)TimestampOffsetByComponents(mylink.basetimestamp, mylink.houros, mylink.minos, mylink.secos)

TimestampOffsetBySeconds

从基准时间戳开始，使用秒偏移，返回带有偏移的时间戳。秒偏移可以包括微秒。

输入：基准时间戳（timestamp），秒偏移（dfloat）
输出：时间戳（timestamp）
示例：如果mylink.basetimestamp包含2009-08-18 14:05:29，而mylink.secos包含值32760，则以下两个函数等效，返回时间戳2009-08-18 23:11:29：

    TimestampOffsetBySeconds("2009-08-18 14:05:29", 32760)TimestampOffsetBySeconds(mylink.basetimestamp, mylink.secos)

TimetFromTimestamp

从给定的时间戳返回UNIX time_t值。

输入：时间戳（timestamp）
输出：timet（int32）
示例：如果mylink.mytimestamp包含值2009–02–13 23:31:30，则以下两个函数等效，返回值1234567890：

    TimetFromTimestamp("2009–02–13 23:31:30")TimetFromTimestamp(mylink.mytimestamp)

WeekdayFromDate

从给定的日期返回一周的第几天。origin_day可选指定被视为一周第一天的天，并默认为星期日。

输入：日期（date），[origin_day（int8）]
输出：天数（int8）
示例：如果mylink.mydate包含日期2008-08-18，则以下两个函数等效，返回值1：

    WeekdayFromDate("2008-08-18")WeekdayFromDate(mylink.mydate)

如果`mylink.mydate`包含日期`2008-08-18`，而`mylink.origin_day`包含`"saturday"`，则以下两个函数等效，返回值`2`：

    WeekdayFromDate("2008-08-18", "saturday")WeekdayFromDate(mylink.mydate, mylink.origin_day)

YeardayFromDate

从给定的日期返回一年中的天数。

输入：日期（date）
输出：天数（int16）
示例：如果mylink.mydate包含日期2008-08-18，则以下两个函数等效，返回值231：

    YeardayFromDate("2008-08-18")YeardayFromDate(mylink.mydate)

YearFromDate

从给定的日期返回年份。

输入：日期（date）
输出：年份（int16）
示例：如果mylink.mydate包含日期2008-08-18，则以下两个函数等效，返回值2008：

    YearFromDate("2008-08-18")YearFromDate(mylink.mydate)

YearweekFromDate

从给定日期返回一年中的周数。

输入：日期（date）
输出：周数（int16）
示例：如果mylink.mydate包含日期2008-08-18，则以下两个函数等效，返回值为33：

    YearweekFromDate("2008-08-18")YearweekFromDate(mylink.mydate)