Format time with an arbitrary formatting string. Other formatters in this module are implemented using timeF.

Timezone offset on the format -HHMM.

>>> t
2018-02-14 16:20:45.5 CST
>>> tzF t
"-0600"

Timezone name.

>>> tzNameF t
"CST"

As dateTimeFmt locale (e.g. %a %b %e %H:%M:%S %Z %Y).

>>> dateTimeF t
"Wed Feb 14 16:20:45 CST 2018"

Same as %H:%M.

>>> hmF t
"16:20"

Same as %H:%M:%S.

>>> hmsF t
"16:20:45"

As timeFmt locale (e.g. %H:%M:%S).

>>> hmsLF t
"16:20:45"

As time12Fmt locale (e.g. %I:%M:%S %p).

>>> hmsPLF t
"04:20:45 PM"

Day half from (amPm locale), converted to lowercase, am, pm.

>>> dayHalfF t
"pm"

Day half from (amPm locale), AM, PM.

>>> dayHalfUF t
"PM"

Hour, 24-hour, leading 0 as needed, 00 - 23.

>>> hour24F t
"16"
>>> hour24F midnight
"00"

Hour, 12-hour, leading 0 as needed, 01 - 12.

>>> hour12F t
"04"
>>> hour12F midnight
"12"

Hour, 24-hour, leading space as needed, 0 - 23.

>>> hour24SF t
"16"
>>> hour24SF midnight
" 0"

Hour, 12-hour, leading space as needed, 1 - 12.

>>> hour12SF t
" 4"
>>> hour12SF midnight
"12"

Minute, 00 - 59.

>>> minuteF t
"20"

Second, without decimal part, 00 - 60.

>>> secondF t
"45"

Picosecond, including trailing zeros, 000000000000 - 999999999999.

>>> picosecondF t
"500000000000"

Decimal point of the second. Up to 12 digits, without trailing zeros. For a whole number of seconds, this produces an empty string.

>>> subsecondF t
".5"

Number of whole seconds since the Unix epoch. For times before the Unix epoch, this is a negative number. Note that in %s.%q and %s%Q the decimals are positive, not negative. For example, 0.9 seconds before the Unix epoch is formatted as -1.1 with %s%Q.

>>> epochF t
"1518646845"

Same as %m/%d/%y.

>>> dateSlashF t
"02/14/18"

Same as %Y-%m-%d.

>>> dateDashF t
"2018-02-14"

As dateFmt locale (e.g. %m/%d/%y).

>>> dateSlashLF t
"02/14/18"

Year.

>>> yearF t
"2018"

Last two digits of year, 00 - 99.

>>> yyF t
"18"

Century (being the first two digits of the year), 00 - 99.

>>> centuryF t
"20"

Month name, long form (fst from months locale), January - December.

>>> monthNameF t
"February"

Month name, short form (snd from months locale), Jan - Dec.

>>> monthNameShortF t
"Feb"

Month of year, leading 0 as needed, 01 - 12.

>>> monthF t
"02"

Day of month, leading 0 as needed, 01 - 31.

>>> dayOfMonthF t
"14"

Day of month, 1st, 2nd, 25th, etc.

>>> dayOfMonthOrdF t
"14th"

Day of month, leading space as needed, 1 - 31.

Day of year for Ordinal Date format, 001 - 366.

>>> dayF t
"045"

Year for Week Date format e.g. 2013.

>>> weekYearF t
"2018"

Last two digits of year for Week Date format, 00 - 99.

>>> weekYYF t
"18"

Century (first two digits of year) for Week Date format, 00 - 99.

>>> weekCenturyF t
"20"

Week for Week Date format, 01 - 53.

>>> weekF t
"07"

Day for Week Date format, 1 - 7.

>>> dayOfWeekF t
"3"

Day of week, short form (snd from wDays locale), Sun - Sat.

>>> dayNameShortF t
"Wed"

Day of week, long form (fst from wDays locale), Sunday - Saturday.

>>> dayNameF t
"Wednesday"

Week number of year, where weeks start on Sunday (as sundayStartWeek), 00 - 53.

>>> weekFromZeroF t
"06"

Day of week number, 0 (= Sunday) - 6 (= Saturday).

>>> dayOfWeekFromZeroF t
"3"

Week number of year, where weeks start on Monday (as mondayStartWeek), 00 - 53.

>>> weekOfYearMonF t
"07"

Display a time span as one time relative to another. Input is assumed to be seconds. Typical inputs are NominalDiffTime and DiffTime.

>>> diffF False 100
"a minute"
>>> diffF True 100
"in a minute"

Display the absolute value time span in years.

>>> epochF t    -- time passed since Jan 1, 1970
"1518646845"
>>> yearsF 3 1518646845
"48.156"

Display the absolute value time span in days.

>>> daysF 3 1518646845
"17576.931"

Display the absolute value time span in hours.

>>> hoursF 3 3600
"1.000"

Display the absolute value time span in minutes.

>>> minutesF 3 150
"2.500"

Display the absolute value time span in seconds.

>>> secondsF 3 100
"100.000"