Ftime

Testing the MarkupExpression ftime

Testing the MarkupExpression ftime

Today is 2024-10-05 Sat in PmWikiland where its is 18:07:19

 {(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
 2024-09-28
 2007-08-13
 2007-08-13
 2007-08-13
 2007-04-07

 2007-01-25
 2007-01-25
 2024-10-06 ?today +1 use quotes
 2024-10-06 ?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
 1728151639
 -1
 -1
 2007-08-13
 {(ftime News-20070501)}
 May 01, 2007, at 12:00 AM
 {(ftime MarchingOrders2007)}
 October 05, 2024, at 06:07 PM
 {(ftime 1177600111)}
 October 05, 2024, at 06:07 PM
 {(ftime %s)}
 1728151639
 {(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 08 2024
 Feb 13 2024
 Mar 13 2024
 Apr 11 2024
 May 10 2024
 Jun  8 2024
 Jul 21 2024
 Aug 26 2024
 Sep  3 2024
 Oct  9 2024
 Nov 21 2024
 Dec  4 2024

 Jan  8 2024
 Feb 13 2024

...

 Dec  4 2024

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 2024-10-05 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")}
 2024 Oct 07 Mon
 2024 Oct 15 Tue
 2024 Oct 23 Wed
 2024 Oct 31 Thu ?

 2024 Oct 05 Sat
 2024 Oct 12 Sat
 2024 Oct 19 Sat
 2024 Oct 26 Sat 

 2024 Oct 08 Tue
 2024 Oct 01 Tue
 2024 Oct 08 Tue
 2024 Oct 08 Tue ?
 2024 Oct 10 Thu

 2024 Sep 23 Mon
 2024 Sep 30 Mon
 2024 Oct 07 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")}
 2024 Sep 05 Thu ?
 2024 Oct 05 Sat
 2024 Nov 05 Tue

 2024 Jun 05 Wed ?
 2024 Oct 05 Sat ?
 2024 Oct 05 Sat ?
 2024 Oct 05 Sat ?
 2024 Oct 05 Sat ?
 2024 Oct 05 Sat ?
 2024 Oct 05 Sat ?
 2024 Oct 05 Sat ?
 2024 Oct 05 Sat ?
 2024 Oct 05 Sat ?
 2024 Oct 05 Sat ?

 2023 Oct 05 Thu
 2024 Oct 05 Sat
 2025 Oct 05 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")} ?
 2024 Oct 23 Wed
 2024 Oct 05 Sat ?
 2024 Aug 21 Wed ?
 2024 Aug 07 Wed ?
 2024 Oct 05 Sat ?

 2024 Oct 05 Sat ?
 2024 Oct 05 Sat ?
 2024 Aug 21 Wed ?
 2024 Aug 21 Wed ?
 2024 Aug 07 Wed ?
 2024 Oct 05 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

added Version 2.3.0 (2022-01-15)
 {(ftime %o)}
 {(ftime "%o")}
 {(ftime "%Y %b %d%o %a")}
 th
 th
 2024 Oct 05th Sat
added Version 2.3.12 (2022-09-25)
 {(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,
we should handle it better:

 
  (±DST)
 0: 00.00 00.00 config start
 1: 00.02 00.02 config end
 2: 00.23 00.22 MarkupToHTML begin
 3: 00.23 00.22 MarkupToHTML begin
 4: 00.24 00.22 MarkupToHTML end
 5: 00.24 00.22 MarkupToHTML begin
 6: 00.24 00.23 MarkupToHTML end
 7: 00.24 00.23 MarkupToHTML begin
 8: 00.24 00.23 MarkupToHTML end
 9: 00.24 00.23 MarkupToHTML begin
10: 00.24 00.23 MarkupToHTML end
11: 00.24 00.23 MarkupToHTML begin
12: 00.24 00.23 MarkupToHTML end
13: 00.24 00.23 MarkupToHTML begin
14: 00.24 00.23 MarkupToHTML end
15: 00.24 00.23 MarkupToHTML begin
16: 00.24 00.23 MarkupToHTML end
17: 00.24 00.23 MarkupToHTML begin
18: 00.24 00.23 MarkupToHTML end
19: 00.24 00.23 MarkupToHTML begin
20: 00.25 00.24 MarkupToHTML end
21: 00.25 00.24 MarkupToHTML begin
22: 00.25 00.24 MarkupToHTML end
23: 00.25 00.24 MarkupToHTML begin
24: 00.26 00.25 MarkupToHTML end
25: 00.26 00.25 MarkupToHTML begin
26: 00.26 00.25 MarkupToHTML end
27: 00.26 00.25 MarkupToHTML begin
28: 00.26 00.25 MarkupToHTML end
29: 00.27 00.26 ReadApprovedUrls SiteAdmin.ApprovedUrls begin
30: 00.28 00.26 ReadApprovedUrls SiteAdmin.ApprovedUrls end
31: 00.30 00.28 MarkupToHTML end
32: 00.30 00.29 MarkupToHTML begin
33: 00.31 00.30 MarkupToHTML end
34: 00.31 00.30 MarkupToHTML begin
35: 00.32 00.30 MarkupToHTML end
36: 00.32 00.30 now
Peak memory: 3,780,968 bytes