# 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