ctime, ctime_s
Defined in header
<time.h>
|
||
(1) | ||
char
*
ctime
(
const
time_t
*
timer
)
;
|
(until C23) | |
[
[
deprecated
]
]
char
*
ctime
(
const
time_t
*
timer
)
;
|
(since C23) | |
errno_t ctime_s
(
char
*
buf, rsize_t bufsz,
const
time_t
*
timer
)
;
|
(2) | (since C11) |
-
-
buf
ortimer
is a null pointer -
bufsz
is less than 26 or greater than RSIZE_MAX
-
-
As with all bounds-checked functions,
ctime_s
is only guaranteed to be available if __STDC_LIB_EXT1__ is defined by the implementation and if the user defines __STDC_WANT_LIB_EXT1__ to the integer constant 1 before including <time.h> .
The resulting string has the following format:
Www Mmm dd hh:mm:ss yyyy\n
-
Www
- the day of the week (one ofMon
,Tue
,Wed
,Thu
,Fri
,Sat
,Sun
). -
Mmm
- the month (one ofJan
,Feb
,Mar
,Apr
,May
,Jun
,Jul
,Aug
,Sep
,Oct
,Nov
,Dec
). -
dd
- the day of the month -
hh
- hours -
mm
- minutes -
ss
- seconds -
yyyy
- years
The function does not support localization.
Parameters
timer | - | pointer to a time_t object specifying the time to print |
buf | - |
pointer to the first element of a char array of size at least
bufsz
|
bufsz | - |
max number of bytes to output, typically the size of the buffer pointed to by
buf
|
Return value
ctime
, and may be overwritten on each invocation of any of those functions.
buf
), or non-zero on failure (in which case, the terminating null character is always written to
buf
[
0
]
unless
buf
is a null pointer or
bufsz
is zero or greater than
RSIZE_MAX
.
Notes
ctime
returns a pointer to static data and is not thread-safe. In addition, it modifies the static
tm
object which may be shared with
gmtime
and
localtime
. POSIX marks this function obsolete and recommends
strftime
instead. The C standard also recommends
strftime
instead of
ctime
and
ctime_s
because
strftime
is more flexible and locale-sensitive.
The behavior of
ctime
is undefined for the values of
time_t
that result in the string longer than 25 characters (e.g. year 10000).
Example
Possible output:
Tue May 26 21:51:03 2015 Tue May 26 21:51:03 2015
References
- C17 standard (ISO/IEC 9899:2018):
-
- 7.27.3.2 The ctime function (p: 287-288)
-
- K.3.8.2.2 The ctime_s function (p: 454)
- C11 standard (ISO/IEC 9899:2011):
-
- 7.27.3.2 The ctime function (p: 393)
-
- K.3.8.2.2 The ctime_s function (p: 626)
- C99 standard (ISO/IEC 9899:1999):
-
- 7.23.3.2 The ctime function (p: 342)
- C89/C90 standard (ISO/IEC 9899:1990):
-
- 4.12.3.2 The ctime function
See also
(deprecated in C23)
(C11)
|
converts a
tm
object to a textual representation
(function) |
converts a
tm
object to custom textual representation
(function) |
|
C++ documentation
for
ctime
|