更新日期：2024年09月11日
rdatestr() 函数将内部的 DATE 转换为字符串。
语法
mint rdatestr(jdate, outbuf)
int4 jdate;
char *outbuf;
jdate
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 849 -
要格式化的日期的内部表示。
outbuf
指向接收 jdate 值的字符串的缓冲区的指针。
用法
对于缺省的语言环境 US English，
rdatestr() 获取确定如何以下列优先顺序解释该字符
串的格式：
DBDATE 环境变量指定的格式（如果设置 DBDATE 的话）。
GL_DATE 环境变量指定的格式（如果设置 GL_DATE 的话）。
缺省的日期样式：mm/dd/yyyy。
当您使用非缺省的语言环境，
且未设置 DBDATE or GL_DATE 环境变量，
则 rdatestr()
使用客户机语言环境定义的日期终端用户格式。
返回代码
0
转换成功。
<0
转换失败。
-1210
不会将内部的日期转换为字符串格式。
-1212
数据转换格式必须包含月份、日期或年份组件。DBDATE 指定数据转换格式。
示例
demo 目录在 rtoday.ec 文件中包含此样例程序。
/*
* rtoday.ec *
The following program obtains today's date from the system.
It then converts it to ASCII for displaying the result.
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 850 -
*/
#include
main()
{
mint errnum;
char today_date[20];
int4 i_date;
printf("RTODAY Sample ESQL Program running.\n\n");
/* Get today's date in the internal format */
rtoday(&i_date);
/* Convert date from internal format into a mm/dd/yyyy string */
if ((errnum = rdatestr(i_date, today_date)) == 0)
printf("\n\tToday's date is %s.\n", today_date);
else
printf("\n\tError %d in converting date to mm/dd/yyyy\n", errnum);
printf("\nRTODAY Sample Program over.\n\n");
}
输出
RTODAY Sample ESQL Program running.
Today's date is 10/26/2007.
RTODAY Sample Program over.
使用本功能，您可以对SQL 编辑器内容进行模板替换，首先您需要定义模板
内容，您可以通过菜单工具替换模板管理，来设置您的SQL 模板。
图8-46 模板管理菜单
GBase 8a MPP Cluster 管理工具手册
- 188 -
南大通用数据技术股份有限公司
点击“替换模板管理（R）
”菜单将弹出模板配置对话框，您可以添加、删除模
板，如下图所示：
图8-47 模板管理对话框
添加完模板后，然后在SQL 编辑器中输入模板关键字后按“空格”键，将在
SQL 编辑器中替换成模板内容，如下图所示：
GBase 8a MPP Cluster 管理工具手册
南大通用数据技术股份有限公司
- 189 -
图8-48 模板替换前
图8-49 模板替换后
GBase 8a MPP Cluster 管理工具手册
- 190 -
南大通用数据技术股份有限公司
9 模板资源管理器
GBase 8a MPP Cluster 管理器提供了“模板资源管理器”视图，在此视图
中包含了GCluster
SQL语句语法的模板，包括数据定义语句、数据操纵语句及
其它一些实用的语句，并提供了SQL 示例。管理员可以参考这些SQL 模板编写
SQL 脚本，也可以根据实际需求自定义新建自己的SQL 模板。如下图所示：
图9-1 模板资源管理器
打开模板将在SQL 编辑器中显示模板的内容，您可以参考模板的内容编辑
自己的SQL 语句。如下图所示：
GBase 8a MPP Cluster 管理工具手册
南大通用数据技术股份有限公司
- 191 -
图 9-2 打开SQL 模板