asterisk https status

strftime Asterisk func

strftime Asterisk func

STRFTIME

Formats the datetime

Synopsis

STRFTIME([<epoch>][,[<timezone>][,<format>]])

Description

Formats the time specified by <epoch>, localized to <timezone>. The format comes directly from the underlying C function strftime(3). If <epoch> is not specified, defaults to the current time. <timezone> likewise defaults to the timezone on the host computer. A list of possible timezones may be obtained from the directory listing in /usr/share/zoneinfo. The default format is %c.

Format String Description Example
%a The abbreviated weekday name according to the current locale. Sun
%A The full weekday name according to the current locale. Sunday
%b The abbreviated month name according to the current locale. Jul
%B The full month name according to the current locale. July
%c The preferred date and time representation for the current locale. Sun Jul 22 14:57:30 2007
%C The century number (year/100) as a 2-digit integer. 20
%d The day of the month as a decimal number (range 01 to 31). 22
%D Equivalent to %m/%d/%y. (Yecch - for Americans only. Americans should note that in other countries %d/%m/%y is rather common. This means that in international context this format is ambiguous and should not be used.) 07/22/07
%e Like %d, the day of the month as a decimal number, but a leading zero is replaced by a space. 22
%F Equivalent to %Y-%m-%d (the ISO 8601 date format). 2007-07-22
%G The ISO 8601 year with century as a decimal number. The 4-digit year corresponding to the ISO week number (see %V). This has the same format and value as %y, except that if the ISO week number belongs to the previous or next year, that year is used instead. 2007
%g Like %G, but without century, i.e., with a 2-digit year (00-99). 07
%h Equivalent to %b. Jul
%H The hour as a decimal number using a 24-hour clock (range 00 to 23). 14
%I The hour as a decimal number using a 12-hour clock (range 01 to 12). 02
%j The day of the year as a decimal number (range 001 to 366). 203
%k The hour (24-hour clock) as a decimal number (range 0 to 23); single digits are preceded by a blank. (See also %H.) 14
%l The hour (12-hour clock) as a decimal number (range 1 to 12); single digits are preceded by a blank. (See also %I.) 2
%m The month as a decimal number (range 01 to 12). 07
%M The minute as a decimal number (range 00 to 59). 57
%n A newline character.
%p Either ‘AM’ or ‘PM’ according to the given time value, or the corresponding strings for the current locale. Noon is treated as ‘pm’ and midnight as ‘am’. PM
%P Like %p but in lowercase: ‘am’ or ‘pm’ or a corresponding string for the current locale. pm
%r The time in a.m. or p.m. notation. In the POSIX locale this is equivalent to ‘%I:%M:%S %p’. 02:57:30 PM
%R The time in 24-hour notation (%H:%M). For a version including the seconds, see %T below. 14:57
%s The number of seconds since the Epoch, i.e., since 1970-01-01 00:00:00 UTC. 1185130650
%S The second as a decimal number (range 00 to 60). (The range is up to 60 to allow for occasional leap seconds.) 30
%t A tab character.
%T The time in 24-hour notation (%H:%M:%S). 14:57:30
%u The day of the week as a decimal, range 1 to 7, Monday being 1. See also %w. 7
%U The week number of the current year as a decimal number, range 00 to 53, starting with the first Sunday as the first day of week 01. See also %V and %W. 29
%V The ISO 8601:1988 week number of the current year as a decimal number, range 01 to 53, where week 1 is the first week that has at least 4 days in the current year, and with Monday as the first day of the week. See also %U and %W. 29
%w The day of the week as a decimal, range 0 to 6, Sunday being 0. See also %u. 0
%W The week number of the current year as a decimal number, range 00 to 53, starting with the first Monday as the first day of week 01. 29
%x The preferred date representation for the current locale without the time. 07/22/07
%X The preferred time representation for the current locale without the date. 14:57:30
%y The year as a decimal number without a century (range 00 to 99). 07
%Y The year as a decimal number including the century. 2007
%z The time-zone as hour offset from GMT. Required to emit RFC 822-conformant dates (using “%a, %d %b %Y %H:%M:%S %z”). -0400
%Z The time zone or name or abbreviation. EDT
%% A literal ‘%’ character. %