150. JHCreateDigClockProgIst（创建数字时钟指令）
JHZRESULT JHZAPI JHCreateDigClockProgIst(
HANDLE phdl,
unsigned short index,
unsigned short wid,
unsigned short rev,
unsigned long style,
unsigned long format,
unsigned long timeoffset,
const char * pformatstring)
参数：
phdl [IN] 实例句柄，与控制卡对应。
index [IN] 指令在批处理文件中基于1开始的索引。
wid [IN] 分区编号， 有效值为 0x0001-0x0003，或 0xFFFF；为 0xFFFF 时为向所有分区发送同一个节目。
rev [IN] 节目标识，用于单分区多节目。
位 15-8:节目编号,同分区中具有唯一性,值越小播放顺序越靠 前，有效范围 0~63；
位 7-0：保留， 始终为 0。
style
[IN] 节目样式。
位 31-4：保留，始终为 0；
位 3：是否按队列加载， 仅永久节目有效，为 0 表示立即，为 1 表示按队列顺序加载；
位 2：加载时是否擦除分区，为 0 表示不擦除，为 1 表示擦除； 位 1：节目属性，为 0 表示临时节目（即掉电易失），为 1 表示 永久节目（掉电不易失） ；
位 0：保留，始终为 0；
format [IN] 文本显示格式。
位 31-20：保留，始终为 0。
位 19- 16：颜色（注： 0000 表示使用系统当前颜色；1000 为黑色）
位 18：蓝色。
位 17：绿色。
位 16：红色。
位 15- 8：字体 ID；有效值为 0-254；为 0 时使用当前字体 ID。
位 7- 6：水平对齐 HALIGN
00；左对齐。
01：水平居中对齐。
10：右对齐。
位 5- 4：垂直对齐方式
00：上对齐。
01：垂直居中对齐。
10：下对齐。
位 3：保留，始终为 0。
位 2：wordbreak，自动换行， 为 0，不自动换行， 为 1，自动换行； 位 1：单行文本； 0 表示多行文本， 1 表示单行文本。
位 0：高级文本，0 表示普通文本， 1 表示高级文本；保留， 始终为 0。
timeoffset [IN] 时间偏移，单位秒，可用于实现多时区时间显示， 有符号数值。
pformatstring [IN] 指向存储文本格式化字符串的内存空间。文本格式化字符串的
格式如下(注意， 下面描述中注意大小写的形式,若须要显示“%”， 则在 sFORMAT 中需要填补两个百分号，即“%%”； 换行符为 ’\n ’， 即 0x0A；水平制表符 ’\t ’，即 0x09，显示为 4 个 ASCII 空格符)： 年： %yyyy 或%yy，分别用于显示四位年份或两位年份；
月： %M 或%MM；%M 为月份是几位就显示几位， %MM 为不足两位数的月 份，前面补零；
日： %d 或%dd；%d 为日期是几位就显示几位， %dd 为不足两位数的日 期，前面补零；
时： %H，%HH，%h，%hh；H 是 24 小时制， h 是 12 小时制；%H 和%h 为时钟是几位就显示几位，%HH 和%hh 为不足两位数的时钟，前 面补零；
分： %m 或%mm；%m 为分钟是几位就显示几位， %mm 为不足两位数的分 钟，前面补零；
秒： %s 或%ss；%s 为秒钟是几位就显示几位， %ss 为不足两位数的秒 钟，前面补零；
星期： %w 或%W；%w 为英文星期缩写； %W 为中文星期数； %w：Sun；Mon；Tue；Wed；Thu；Fri；Sat；
%W：星期日； 星期一；星期二； 星期三； 星期四； 星期五；星 期六；
上/下午： %t 或%T；%t 为英文，AM 或 PM；%T 为中文，上午或 下午；
一个文本格式化字符串可以为“%yyyy 年%MM 月%dd 日 %HH 时%mm 分%ss 秒 %W”，年、月、日、时、分、秒、星期都是可选的， 例如， 如果不需要在显示屏上显示年份，文本格式化字符串改为“%MM 月%dd 日 %HH 时%mm 分%ss 秒 %W”。
注： FORMAT 属性说明， 主要注意两类，单行文本和多行文本
1. 单行文本时：
忽略 wordbreak 自动换行设置， 无论是自动换行或是手动在命令中添加换行符 ’\n ’，均忽略，不作换行处理，
2. 多行文本时：
根据设置不作限制， 自动换行和手动换行可同时支持；
但是若文本显示所需区域超过当前限制区域， 建议做如下处理：
1. 若为单行文本， 建议不要设置水平居中；其他可任意搭配；
2. 若为多行文本， 若使用了自动换行， 建议不要使用垂直居中对齐；若无自动换行，建议 不要使用任何居中对齐方式；
使用时若遇到上面情况， 可参照上面说明使用，否则为了整体显示效果，系统会自行裁剪部 分数据；
返回值：
JR_OK 成功
JR_INVALID_PARAMETER 参数错误
IR_INVALID_OBJECT 无效的对象
IR_NOT_ENOUGH_CORE 内存不足
功能描述:
在批处理文件中索引为 index 的位置上添加创建数字时钟指令。将要创建的高级时 钟在分区编号为 wid 的显示区域内显示。一个显示屏可以分为若干个区域，每个区域以 一个分区编号来标记。创建高级时钟需要用户指定时钟的显示格式，用户也可以使用 JHCreateSimpleDigClockProgIst（创建简易时钟指令）创建默认格式显示的时钟。