Test /
Ftime
Testing the MarkupExpression ftime
Testing the MarkupExpression ftime
Today is 2026-01-03 Sat in PmWikiland where its is 08:30:31
{(ftime %F -7days)}
{(ftime %F when="2007-08-14 -1days")}
{(ftime %F when="2007-08-14 -1 days")}
{(ftime %F when="2007-08-14 -1 day")}
{(ftime %F "2007-04-11 -4 days")}
{(ftime %F when="2007-01-24 +1 day")}
{(ftime %F when="2007-01-24 +1day")}
{(ftime %F "+1 day")} ?today +1 use quotes
{(ftime %F +1day)} ?today +1
| 2025-12-27 2007-08-13 2007-08-13 2007-08-13 2007-04-07 2007-01-25 2007-01-25 2026-01-04 ?today +1 use quotes 2026-01-04 ?today +1 |
{(ftime when=" ")}
{(ftime %s)}
{(ftime %s " ")}
{(ftime %s when="")}
{(ftime fmt=%F when="2007-08-14 -1days")}
| December 31, 1969, at 11:59 PM 1767429031 -1 -1 2007-08-13 |
{(ftime News-20070501)}
| May 01, 2007, at 12:00 AM |
{(ftime MarchingOrders2007)}
| January 03, 2026, at 08:30 AM |
{(ftime 1177600111)}
| January 03, 2026, at 08:30 AM |
{(ftime %s)}
| 1767429031 |
{(ftime @1177600111)}
| April 26, 2007, at 03:08 PM |
{(ftime fmt="%b %#d %Y" when="second mon of Jan")}
{(ftime fmt="%b %#d %Y" when="second tue of Feb")}
{(ftime fmt="%b %#d %Y" when="second wed of Mar")}
{(ftime fmt="%b %e %Y" when="second thu of Apr")}
{(ftime fmt="%b %e %Y" when="second fri of May")}
{(ftime fmt="%b %e %Y" when="second sat of Jun")}
{(ftime fmt="%b %e %Y" when="third sun of Jul")}
{(ftime fmt="%b %e %Y" when="fourth mon of Aug")}
{(ftime fmt="%b %e %Y" when="first tue of Sep")}
{(ftime fmt="%b %e %Y" when="second wed of Oct")}
{(ftime fmt="%b %e %Y" when="third thu of Nov")}
{(ftime fmt="%b %e %Y" when="first wed of Dec")}
----
{(ftime fmt="%b %e %Y" when="second Monday of January")}
{(ftime fmt="%b %e %Y" when="second Tuesday of February")}
...
{(ftime fmt="%b %e %Y" when="first Wednesday of December")}
| Jan 12 2026 Feb 10 2026 Mar 11 2026 Apr 9 2026 May 8 2026 Jun 13 2026 Jul 19 2026 Aug 24 2026 Sep 1 2026 Oct 14 2026 Nov 19 2026 Dec 2 2026 Jan 12 2026 Feb 10 2026 ... Dec 2 2026 |
All these work on my own server, with or without the changes in DRange() for 2.2.69. --Petko October 19, 2014, at 06:12 AM
Testing relative GNU date input formats
Today is 2026-01-03 Sat
? marks an unsatisfactory result
{(ftime "%Y %b %d %a" "1 mon")}
{(ftime "%Y %b %d %a" "2 tue")}
{(ftime "%Y %b %d %a" "3 wed")}
{(ftime "%Y %b %d %a" "4 thu")} ?
{(ftime "%Y %b %d %a" "1 sat")}
{(ftime "%Y %b %d %a" "2 sat")}
{(ftime "%Y %b %d %a" "3 sat")}
{(ftime "%Y %b %d %a" "4 sat")}
{(ftime "%Y %b %d %a" "tuesday")}
{(ftime "%Y %b %d %a" "last tue")}
{(ftime "%Y %b %d %a" "this tue")}
{(ftime "%Y %b %d %a" "next tue")} ?
{(ftime "%Y %b %d %a" "thursday")}
{(ftime "%Y %b %d %a" "last week")}
{(ftime "%Y %b %d %a" "this week")}
{(ftime "%Y %b %d %a" "next week")}
| 2026 Jan 05 Mon 2026 Jan 13 Tue 2026 Jan 21 Wed 2026 Jan 29 Thu ? 2026 Jan 03 Sat 2026 Jan 10 Sat 2026 Jan 17 Sat 2026 Jan 24 Sat 2026 Jan 06 Tue 2025 Dec 30 Tue 2026 Jan 06 Tue 2026 Jan 06 Tue ? 2026 Jan 08 Thu 2025 Dec 22 Mon 2025 Dec 29 Mon 2026 Jan 05 Mon |
All the above are correct; "4 thu" means "Thursday the fourth week", knowing that "next Thursday" is "this Thursday" or "Thursday the first week". --Petko
{(ftime "%Y %b %d %a" "last month")} ?
{(ftime "%Y %b %d %a" "this month")}
{(ftime "%Y %b %d %a" "next month")}
{(ftime "%Y %b %d %a" "June")} ?
{(ftime "%Y %b %d %a" "last June")} ?
{(ftime "%Y %b %d %a" "this June")} ?
{(ftime "%Y %b %d %a" "next June")} ?
{(ftime "%Y %b %d %a" "last Aug")} ?
{(ftime "%Y %b %d %a" "this Aug")} ?
{(ftime "%Y %b %d %a" "next Aug")} ?
{(ftime "%Y %b %d %a" "October")} ?
{(ftime "%Y %b %d %a" "last Oct")} ?
{(ftime "%Y %b %d %a" "this Oct")} ?
{(ftime "%Y %b %d %a" "next Oct")} ?
{(ftime "%Y %b %d %a" "last year")}
{(ftime "%Y %b %d %a" "this year")}
{(ftime "%Y %b %d %a" "next year")}
| 2025 Dec 03 Wed ? 2026 Jan 03 Sat 2026 Feb 03 Tue 2026 Jun 03 Wed ? 2026 Jan 03 Sat ? 2026 Jan 03 Sat ? 2026 Jan 03 Sat ? 2026 Jan 03 Sat ? 2026 Jan 03 Sat ? 2026 Jan 03 Sat ? 2026 Oct 03 Sat ? 2026 Jan 03 Sat ? 2026 Jan 03 Sat ? 2026 Jan 03 Sat ? 2025 Jan 03 Fri 2026 Jan 03 Sat 2027 Jan 03 Sun |
{(ftime "%Y %b %d %a" "3 wed")}
{(ftime "%Y %b %d %a" "wed 3")} ?
{(ftime "%Y %b %d %a" "3 wed aug")} ?
{(ftime "%Y %b %d %a" "aug 3 wed")} ?
{(ftime "%Y %b %d %a" "aug wed 3")} ?
{(ftime "%Y %b %d %a" "3 wed this aug")} ?
{(ftime "%Y %b %d %a" "this aug 3 wed")} ?
{(ftime "%Y %b %d %a" "3 wed aug this year")} ?
{(ftime "%Y %b %d %a" "aug this year 3 wed")} ?
{(ftime "%Y %b %d %a" "this year aug 3 wed")} ?
{(ftime "%Y %b %d %a" "this year aug wed 3")} ?
| 2026 Jan 21 Wed 2026 Jan 03 Sat ? 2026 Aug 19 Wed ? 2026 Aug 05 Wed ? 2026 Jan 03 Sat ? 2026 Jan 03 Sat ? 2026 Jan 03 Sat ? 2026 Aug 19 Wed ? 2026 Aug 19 Wed ? 2026 Aug 05 Wed ? 2026 Jan 03 Sat ? |
If something is unsatisfactory with relative dates, the reason is the strtotime function in PHP, not PmWiki which uses the date this function recognizes and returns. See also Relative formats on which relative dates are recognized, for example "this/last/next Aug" is not among the ones that are expected to be recognized. --Petko October 19, 2014, at 06:08 AM
{(ftime %o)}
{(ftime "%o")}
{(ftime "%Y %b %d%o %a")}
| rd rd 2026 Jan 03rd Sat |
{(ftime "%L")}
{(ftime "%L" "-4minutes")}
{(ftime "%L" "-4hours")}
{(ftime "%L" "-4days")}
{(ftime "%L" "-4months")}
{(ftime "%L" "-4years")}
{(ftime "%L" "2022-09-25")}
{(ftime "%L" "-9months")}
{(ftime "%L" "-10months")}
{(ftime "%L" "-11months")}
{(ftime "%L" "-12months")}
A stamp in the future is unexpected,\\
we should handle it better:
{(ftime "%L" "+6days")}
{(ftime "%L" "+6months")} (±DST)
| A stamp in the future is unexpected, (±DST) |