ftime()

Function usage:

ftime([format [, time]])

Returns a string formatted from an absolute system time time (obtained from time() or mktime()) according to format. If time is omitted, it defaults to the current time. If time is out of range, ftime() returns an empty string and prints an error message. If format is omitted, it defaults to %time_format. If format is "@", a raw system time (e.g., seconds since 1970-01-01 00:00:00 UTC) will be displayed. Otherwise, each "%" in format describes a conversion:

%@

raw system time, in seconds, to the nearest microsecond (nonstandard)

%.

microseconds since last whole second (nonstandard)

%a

abbreviated weekday name

%A

full weekday name

%b

abbreviated month name

%B

full month name

%c

local time and date representation

%d

day of month (01-31)

%F

ISO 8601 date format (equivalent to "%Y-%m-%d")

%H

hour on 24-hour clock (00-23)

%I

hour on 12-hour clock (01-12)

%j

day of year (001-366)

%m

month (01-12)

%M

minute (00-59)

%p

local equivalent of "AM" or "PM"

%s

raw system time, rounded down to the nearest whole second (nonstandard)

%S

second (00-61)

%T

ISO 8601 time format (equivalent to "%H:%M:%S")

%U

week number of year, Sunday is first day of week (00-53)

%w

weekeday (0-6, Sunday is 0)

%W

week number of year, Monday is first day of week (00-53)

%x

local date representation

%X

local time representation

%y

year without century (00-99)

%Y

year with century

%Z

time zone name, if any

%%

"%"

The formats "%@" and "%s.%." do not give the same results if time is negative.

Example:
command: /expr ftime("Today is %a %b %d", time())
output: Today is Thu Jul 02

See: functions, time(), locale, %TZ, %time_format, %clock_format.