playbook/skills/tsl-api-reference/references/codegen/dotnet/base/datetime.md

基础函数 / 日期时间

endOfTheHalfYear(end_t)

声明：function

返回Endt所在半年的截止日期（半年的最后一天）

参数	类型	说明
end_t	tdatetime	日期

返回：tdatetime

示例

end_t := 40540; // 40540表示2010年12月28日
return endOfTheHalfYear (end_t);
// 输出：40543  ；40543表示2010年12月31号

endOfTheQuarter(end_t)

声明：function

返回Endt所在季度的截止日期（季度的最后一天）

参数	类型	说明
end_t	tdatetime	日期

返回：tdatetime

示例

end_t := 40540; // 40540表示2010年12月28日
return endOfTheQuarter (end_t);
// 输出：40543  ；40543表示2010年12月31号

excelDateToInt(r_date)

声明：function

将日期型报告期转化成整数型报告期

参数	类型	说明
r_date	tdatetime	日期型报告期

返回：integer

示例

r_date := 20101231;
return excelDateToInt(r_date);
// 输出：20101231

excelIntToDate(r_date)

声明：function

将报告期类型日期转化成实数型

参数	类型	说明
r_date	integer	整型类的报告期日期

返回：tdatetime

示例

// 报告期为2010年年报
r_date := 20101231;
return excelIntToDate(r_date);
// 输出：40543

excelRDate(r_date)

声明：function

将整数报告期转换成Excel的字符串日期类型

参数	类型	说明
r_date	integer	报告期，一般用整型日期表示

返回：string

示例

r_date := 20101231;
return excelRDate(r_date);
// 输出：2010-12-31

formatStrToDateTime2(s, format_str)

声明：function

格式化字符串->日期时间(包含毫秒)

参数	类型	说明
s	string	字符串类型，时间字符串
format_str	string	字符串类型，格式字符串

返回：datetime

示例

// 字符串2021-8-12 10:31:24:199 转换为日期时间格式(包含毫秒)
s := "2021.01.04T23:00:00.000";
format_str := "yyyy.mm.ddThh:nn:ss.zzz";
return formatStrToDateTime2(s, format_str); // 输出：44200.9583333333

incHalfYear(a_value, number)

声明：function

求Avalue的日期开始往后推移Number个半年的日期

参数	类型	说明
a_value	tdatetime	实数表示的日期
number	integer	向后推移的整数，负数表示向前推移

返回：tdatetime

示例

avalue := 40179; // 40179表示2010年1月1号
number := 2;
return incHalfYear(a_value, number);
// 输出：40544  ；40544表示2011年1月1号

incQuarter(avalue, number)

声明：function

求Avalue的日期开始往后推移Number个季度的日期

参数	类型	说明
avalue	tdatetime	实数表示的日期
number	integer	向后推移的整数。负数表示向前推移。

返回：tdatetime

示例

avalue := 40179; // 40179表示2010年1月1号
number := 2;
return incQuarter(a_value, number);
// 输出：40360  ；40360表示2010年7月1号

startOfTheHalfYear(end_t)

声明：function

返回Endt所在半年的开始日期（半年的第一天）

参数	类型	说明
end_t	tdatetime	日期

返回：tdatetime

示例

end_t := 40599; // 40559表示2011年1月16号
return startOfTheHalfYear(end_t);
// 输出：40544  ；40544表示2011年1月1号

startOfTheQuarter(end_t)

声明：function

返回Endt所在季度的开始日期（季度的第一天）

参数	类型	说明
end_t	tdatetime	日期

返回：tdatetime

示例

end_t := 40540; // 40540表示2010年12月28日
return startOfTheQuarter (end_t);
// 输出：40452  ；40452表示2010年10月1号

strToDateExt(s, str_format)

声明：function

将字符串类型的日期按照不同的格式转换成实数型的日期

参数	类型	说明
s	string	字符串类型的日期，包含3中形式，见下表。
str_format	integer	标准化的日期格式，对应的S分别用0、1、2表示

返回：tdatetime

示例

s := '16/1/2011';
str_format := 0;
return strToDateExt(s, str_format);
// 输出：40559

strtodatetime2(s)

声明：function

字符串->日期时间(包含毫秒)

参数	类型	说明
s	string	S的格式必须为：yyyy-m-d h:m:s:z    其中日期和时间需要用空格隔开，时间分隔必须用:    如"2021-8-12 10:31:24:199"

返回：tdatetime

示例

// 字符串2021-8-12 10:31:24:199 转换为日期时间格式(包含毫秒)
s := "2021-8-12 10:31:24:199";
return strtodatetime2(s); // 输出：44420.4384745255