38.9.4.11 将时间读取为STRING

以字符串(LPTSTR格式)获取人机界面的当前时间。此函数仅对保存在LS2048(6个字)中的时间有效。

函数名称

DWORD WINAPI EasyGetGPTimeString (LPCSTR sNodeName,LPCSTR sFormat,LPSTR osTime);

参数

sNodeName:站名称固定为#WinGP。

pFormat:将字符串获取为时间格式的字符串。会用“特殊项目”替换百分号(%)后面的格式代码。
其他字符不会转换并原样显示。

osTime:时间获取为文本。

数据丢失

  • 如果没有足够的空间容纳获取的文本长度+1(Null),将发生意外的存储器空间错误。确认留出了足以保存字符串长度+1(用于NULL字符)的存储空间。如果没有留出足够的空间,则可能会发生意外的数据丢失,操作可能不能正常进行。

不遵照上述指示操作可能导致设备损坏。

返回值(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。

*2 在a, A, b, B, p, X, z或Z的前面加井号(例如%#a)时,井号被忽略。