38.9.4.11 Read IPC Time as STRING
Function to acquire the current time as a string (LPTSTR format)
from the defined station. This function is valid only with the time
stored in LS2048 (6 words).
Function Name
DWORD WINAPI
EasyGetGPTimeString(LPCSTR sNodeName, LPCSTR sFormat, LPSTR
osTime);
Argument
sNodeName: The
station name is fixed as #WinGP.
pFormat: Retrieves
string as a time formatted string. Formatting codes following the
percent sign (%) are replaced with "Special Item."
Other characters are not converted and display as is.
osTime: Retrieves
time as a string (but when not enough space to receive string
length + 1 (Null) or more, an unexpected memory space damage will
occur. Make sure you reserve enough memory space to receive string
length + 1 (for the NULL character). If you don't reserve enough
space, you could experience unexpected data loss and operations may
not work properly.)
Return value (NULL)
Normal End: 0
Problem: Error code
Special Item
Formatting codes following the percent sign (%) are replaced as
shown in the following table. Other characters are not converted
and display as is. For example, if the clock is 2006/1/2 12:34:56
and you define %Y_%M %S, the string becomes:
|
Formatting Code
|
Folder
|
|
%a
|
Day - abbreviated (*2)
|
|
%A
|
Day (*2)
|
|
%b
|
Month - abbreviated (*2)
|
|
%B
|
Month (*2)
|
|
%c
|
Locale-related date and time
|
|
%#c
|
Locale-related date and time (long form)
|
|
%d
|
Day as decimal value (01 to 31) (*1)
|
|
%H
|
24 Hour Clock (00 to 23) (*1)
|
|
%I
|
12 Hour Clock (01 to 12) (*1)
|
|
%j
|
Day of year as decimal value (001 to 366)
(*1)
|
|
%m
|
Month as decimal value (01 to 12)
(*1)
|
|
%M
|
As decimal value (00 to 59) (*1)
|
|
%p
|
AM/PM for locale (*2)
|
|
%S
|
As decimal value (00 to 59) (*1)
|
|
%U
|
Week of year as decimal value. The first Sunday
of the year is the first week. (00 to 53) (*1)
|
|
%w
|
Day as decimal value. Sunday is 0 (0 to 6)
(*1)
|
|
%W
|
Week of year as decimal value. The first Monday
of the year is the first week. (00 to 53) (*1)
|
|
%x
|
Date of current locale
|
|
%#x
|
Date of current locale (long form)
|
|
%X
|
Time of current locale (*2)
|
|
%y
|
2-digit Year as decimal value (00 to 99)
(*1)
|
|
%y
|
4-digit Year as decimal value (*1)
|
|
%z, %Z
|
Time zone or time-zone abbreviation. When time
zone is unknown, character is not entered (*2)
|
|
%%
|
Percentage symbol (*2)
|
|
