ftime()
Function usage:
ftime([format
[, time]])
Returns a string formatted from a system time time (obtained from
time()) according to
format.
If time is omitted, it defaults to the current time.
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
%% - "
%"
Names and conversions labeled "local" may be affected by the
setting of the LC_TIME locale category.
Additional "%" conversions may be supported by your system, including
3-character conversions starting with "%E" and "%O"; see your system's
strftime() documentation for details.
All other characters in format are copied unmodified to the result.
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
Back to index
Back to tf home page
Copyright © 1998, 1999, 2002, 2003, 2004 Ken Keys