function parses the string in the buffer
according to the string pointed to by
and fills in the elements of the structure pointed to by
The resulting values will be relative to the local time zone.
Thus, it can be considered the reverse operation of
function does the same as
but takes an explicit locale rather than using the current locale.
string consists of zero or more conversion specifications and
All ordinary characters are matched exactly with the buffer, where
white space in the format string will match any amount of white space
in the buffer.
All conversion specifications are identical to those described in
Two-digit year values, including formats
are now interpreted as beginning at 1969 per POSIX requirements.
Years 69-00 are interpreted in the 20th century (1969-2000), years
01-68 in the 21st century (2001-2068).
format specifiers accept any value within the range 00 to 53.
string does not contain enough conversion specifications to completely
specify the resulting
.Vt struct tm ,
the unspecified members of
are left untouched.
For example, if
will be modified.
If time relative to today is desired, initialize the
structure with todays date before passing it to
format specifiers may incorrectly scan one too many digits
if the intended values comprise only a single digit
and that digit is followed immediately by another digit.
Both specifiers accept zero-padded values,
even though they are both defined as taking unpadded values.
format specifier has no effect unless it is parsed
will produce undefined results.
Note that 12AM
is taken as midnight
is taken as noon.
format specifier only accepts time zone abbreviations of the local time zone,
or the value "GMT".
This limitation is because of ambiguity due to of the over loading of time
One such example is
which is both Eastern Standard Time and Eastern Australia Summer Time.
function does not correctly handle multibyte characters in the