.Dt WCSFTIME 3
.Os
.Sh NAME
-.Nm wcsftime
+.Nm wcsftime ,
+.Nm wcsftime_l
.Nd "convert date and time to a wide-character string"
.Sh LIBRARY
.Lb libc
.In wchar.h
.Ft size_t
.Fo wcsftime
-.Fa "wchar_t * restrict wcs" "size_t maxsize"
-.Fa "const wchar_t * restrict format" "const struct tm * restrict timeptr"
+.Fa "wchar_t *restrict wcs"
+.Fa "size_t maxsize"
+.Fa "const wchar_t *restrict format"
+.Fa "const struct tm *restrict timeptr"
+.Fc
+.In wchar.h
+.In xlocale.h
+.Ft size_t
+.Fo wcsftime_l
+.Fa "wchar_t *restrict wcs"
+.Fa "size_t maxsize"
+.Fa "const wchar_t *restrict format"
+.Fa "const struct tm *restrict timeptr"
+.Fa "locale_t loc"
.Fc
.Sh DESCRIPTION
The
.Fn wcsftime
function is equivalent to the
.Fn strftime
-function except for the types of its arguments.
+function, except for the types of its arguments.
Refer to
.Xr strftime 3
for a detailed description.
+.Pp
+While the
+.Fn wcsftime
+function uses the current locale, the
+.Fn wcsftime_l
+function may be passed a locale directly. See
+.Xr xlocale 3
+for more information.
.Sh COMPATIBILITY
Some early implementations of
.Fn wcsftime
had a
.Fa format
argument with type
-.Vt "const char *"
+.Vt "const char *" ,
instead of
.Vt "const wchar_t *" .
.Sh SEE ALSO
-.Xr strftime 3
+.Xr strftime 3 ,
+.Xr xlocale 3
.Sh STANDARDS
The
.Fn wcsftime