C++ <cwchar> - wcsftime() Function

The C++ <cwchar> wcsftime() function converts the date and time information described in timeptr to a null-terminated wide character string str according to format string format, with a limit of maxsize characters.

Syntax

size_t wcsftime (wchar_t* str, 
                 size_t maxsize, 
                 const wchar_t* format,
                 const struct tm* timeptr );

Parameters

Return Value

Returns the total number of wide characters copied to str (not including the terminating null wide character) on success. If maxsize is reached before the entire string could be stored, 0 is returned and the contents of the array pointed by str are undefined.

Example:

The example below shows the usage of wcsftime() function.

#include <cwchar>
#include <ctime>

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

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

  wcsftime (buffer,80, L"Current Date: %A, %F %I:%M %p", timeinfo);
  wprintf(L"%ls", buffer);

  return 0;
}

The output of the above code will be similar to:

Current Date: Saturday, 2022-02-12 10:29 AM