Ftime
Testing the MarkupExpression ftime
Testing the MarkupExpression ftime
Today is 2026-01-29 Thu in PmWikiland where its is 13:34:36
{(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
| 2026-01-22 2007-08-13 2007-08-13 2007-08-13 2007-04-07 2007-01-25 2007-01-25 2026-01-30 ?today +1 use quotes 2026-01-30 ?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 1769693676 -1 -1 2007-08-13 |
{(ftime News-20070501)}
| May 01, 2007, at 12:00 AM |
{(ftime MarchingOrders2007)}
| January 29, 2026, at 01:34 PM |
{(ftime 1177600111)}
| January 29, 2026, at 01:34 PM |
{(ftime %s)}
| 1769693676 |
{(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-29 Thu
{(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 Feb 02 Mon 2026 Feb 10 Tue 2026 Feb 18 Wed 2026 Feb 19 Thu ? 2026 Jan 31 Sat 2026 Feb 07 Sat 2026 Feb 14 Sat 2026 Feb 21 Sat 2026 Feb 03 Tue 2026 Jan 27 Tue 2026 Feb 03 Tue 2026 Feb 03 Tue ? 2026 Jan 29 Thu 2026 Jan 19 Mon 2026 Jan 26 Mon 2026 Feb 02 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 29 Mon ? 2026 Jan 29 Thu 2026 Mar 01 Sun 2026 Jun 29 Mon ? 2026 Jan 29 Thu ? 2026 Jan 29 Thu ? 2026 Jan 29 Thu ? 2026 Jan 29 Thu ? 2026 Jan 29 Thu ? 2026 Jan 29 Thu ? 2026 Oct 29 Thu ? 2026 Jan 29 Thu ? 2026 Jan 29 Thu ? 2026 Jan 29 Thu ? 2025 Jan 29 Wed 2026 Jan 29 Thu 2027 Jan 29 Fri |
{(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 Feb 18 Wed 2026 Jan 29 Thu ? 2026 Sep 16 Wed ? 2026 Aug 05 Wed ? 2026 Jan 29 Thu ? 2026 Jan 29 Thu ? 2026 Jan 29 Thu ? 2026 Sep 16 Wed ? 2026 Sep 16 Wed ? 2026 Aug 05 Wed ? 2026 Jan 29 Thu ? |
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")}
| th th 2026 Jan 29th Thu |
{(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) |