以字符串(LPTSTR格式)获取人机界面的当前时间。此函数仅对保存在LS2048(6个字)中的时间有效。
函数名称
DWORD WINAPI EasyGetGPTimeString (LPCSTR sNodeName,LPCSTR sFormat,LPSTR osTime);
参数
sNodeName:站名称固定为#WinGP。
pFormat:将字符串获取为时间格式的字符串。会用“特殊项目”替换百分号(%)后面的格式代码。
其他字符不会转换并原样显示。
osTime:时间获取为文本。
数据丢失
不遵照上述指示操作可能导致设备损坏。 |
返回值(NULL)
正常结束: 0
重大错误:错误代码
百分号(%)后面的格式代码会被替代,具体如下表所示。其他字符不会转换并原样显示。例如,如果时钟是2006/1/2 12:34:56,且您定义了%Y_%M %S,那么字符串就变成:
格式代码 |
文件夹 |
---|---|
%a |
日期 - 缩写(*2) |
%A |
日期(*2) |
%b |
月 - 缩写(*2) |
%B |
月(*2) |
%c |
与场所有关的日期和时间 |
%#c |
与地点有关的日期和时间(长日期形式) |
%d |
十进制值日期(01至31)(*1) |
%H |
24小时时钟(00至23)(*1) |
%I |
12小时时钟(01至 12)(*1) |
%j |
十进制格式的一年中的某天(001至366)(*1) |
%m |
十进制值月(01至12)(*1) |
%M |
十进制值(01至59)(*1) |
%p |
当地的AM/PM(*2) |
%S |
十进制值(01至59)(*1) |
%U |
十进制格式的一年中的某周。一年的第一个星期天是第一周。(00至53) (*1) |
%w |
十进制值日期。星期天是0(0至6)(*1) |
%W |
十进制格式的一年中的某周。一年的第一个星期一是第一周。(00至53) (*1) |
%x |
当地的日期 |
%#x |
当地的日期(长日期格式) |
%X |
当地的时间(*2) |
%y |
两位十进制格式的年份(00至99)(*1) |
%y |
4位十进制格式的年份(*1) |
%z、%Z |
时区或时区缩写。当时区未知时,不输入字符(*2) |
%% |
百分号(*2) |
*1 通过在 d、H、I、j、m、M、S、U、 w、W、y或Y前加一个井号(#)可不显示数值前面的零。例如,如果值是05,格式代码是%#d,那么就显示为5。