函数
<cwchar>

wcsftime

size_t wcsftime (wchar_t* ptr, size_t maxsize, const wchar_t* format,                 const struct tm* timeptr);
将时间格式化为宽字符串
format的内容复制到ptr中,并按照timeptr指定的格式扩展其格式标记,限制为maxsize个字符。

这是strftime<ctime>)的宽字符等效函数。

参数

ptr
指向用于存放结果C宽字符串的目标数组的指针。
maxsize
要复制到ptr的最大宽字符数。
format
C宽字符串,包含一个格式字符串,其规格遵循strftime中的format(有关详细信息,请参阅strftime)。
timeptr
指向tm结构的指针,该结构包含一个已分解为各组成部分的日历时间(请参阅struct tm)。

返回值

如果生成的C宽字符串(包括终止的空宽字符)小于maxsize个宽字符,则返回复制到ptr的总字符数(不包括终止的空宽字符)。
否则,返回零,并且数组的内容不确定。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
/* wcsftime example */
#include <wchar.h>
#include <time.h>

int main ()
{
  time_t rawtime;
  struct tm * timeinfo;
  wchar_t buffer [80];

  time ( &rawtime );
  timeinfo = localtime ( &rawtime );

  wcsftime (buffer,80,L"Now it's %I:%M%p.",timeinfo);
  wprintf (L"%ls\n",buffer);

  return 0;
}

示例输出

Now it's 04:33PM.


另见