* Timestamp and timestamp range definitions
@ 2023-02-13 7:21 Ilya Chernyshov
2023-02-15 15:10 ` Ihor Radchenko
0 siblings, 1 reply; 4+ messages in thread
From: Ilya Chernyshov @ 2023-02-13 7:21 UTC (permalink / raw)
To: emacs-orgmode
Hello
What's a type of timestamp <2022-10-15 Sat 10:00-13:00>?
From org-manual:
the definition for a timestamp is:
A timestamp is a specification of a date (possibly with a time or
a range of times) in a
special format, either '<2003-09-16 Tue>' or '<2003-09-16 Tue
09:39>'
or ‘<2003-09-16 Tue 12:00-12:30>'
Also, the definition for timestamp range is:
Two timestamps connected by '--' denote a range. The headline is
shown on
the first and last day of the range, and on any dates that are
displayed and fall
in the range. Here is an example:
,* Meeting in Amsterdam
<2004-08-23 Mon>--<2004-08-26 Thu>
But, according to tests in test-org-element.el such a timestamp is
considered a timerange [added in commit cb32494e2]:
(should
(eq 'active-range
(org-test-with-temp-text "<2012-03-29 Thu 7:30-16:40>"
(org-element-property :type (org-element-context)))))
So, we either should change the behavior of
(org-element-timestamp-parser) or update the definitions of
timestamp
and timestamp range in org-manual. What do you think?
--
Best,
Ilya
^ permalink raw reply [flat|nested] 4+ messages in thread* Re: Timestamp and timestamp range definitions 2023-02-13 7:21 Timestamp and timestamp range definitions Ilya Chernyshov @ 2023-02-15 15:10 ` Ihor Radchenko 2023-02-16 18:55 ` Ilya Chernyshov 0 siblings, 1 reply; 4+ messages in thread From: Ihor Radchenko @ 2023-02-15 15:10 UTC (permalink / raw) To: Ilya Chernyshov; +Cc: emacs-orgmode Ilya Chernyshov <ichernyshovvv@gmail.com> writes: > So, we either should change the behavior of > (org-element-timestamp-parser) or update the definitions of > timestamp > and timestamp range in org-manual. What do you think? Updating the manual will make more sense. Would you mind writing a patch? -- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at <https://orgmode.org/>. Support Org development at <https://liberapay.com/org-mode>, or support my work at <https://liberapay.com/yantar92> ^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: Timestamp and timestamp range definitions 2023-02-15 15:10 ` Ihor Radchenko @ 2023-02-16 18:55 ` Ilya Chernyshov 2023-02-17 11:10 ` Ihor Radchenko 0 siblings, 1 reply; 4+ messages in thread From: Ilya Chernyshov @ 2023-02-16 18:55 UTC (permalink / raw) To: Ihor Radchenko; +Cc: emacs-orgmode [-- Attachment #1: Type: text/plain, Size: 139 bytes --] Ihor Radchenko <yantar92@posteo.net> writes: > Updating the manual will make more sense. Would you mind writing > a patch? Of course. [-- Warning: decoded text below may be mangled, UTF-8 assumed --] [-- Attachment #2: 0001-org-manual.org-Update-timestamp-and-timerange-defini.patch --] [-- Type: text/x-patch, Size: 2629 bytes --] From da84673301de7e9453cb359536235d8ce56399f1 Mon Sep 17 00:00:00 2001 From: Ilya Chernyshov <ichernyshovvv@gmail.com> Date: Fri, 17 Feb 2023 01:23:27 +0700 Subject: [PATCH] org-manual.org: Update timestamp and timerange definitions * doc/org-manual.org (Timestamps): Document that time specification of the form <2023-02-17 Fri 10:00-12:00> is not a timestamp, but a timerange. --- doc/org-manual.org | 27 +++++++++++++++++---------- 1 file changed, 17 insertions(+), 10 deletions(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index 2d38cf76c..5b6633417 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -5915,12 +5915,12 @@ ** Timestamps #+cindex: deadlines #+cindex: scheduling -A timestamp is a specification of a date (possibly with a time or -a range of times) in a special format, either =<2003-09-16 Tue>= or -=<2003-09-16 Tue 09:39>= or =<2003-09-16 Tue 12:00-12:30>=[fn:19]. -A timestamp can appear anywhere in the headline or body of an Org tree -entry. Its presence causes entries to be shown on specific dates in -the agenda (see [[*Weekly/daily agenda]]). We distinguish: +A timestamp is a specification of a date (possibly with a time) in a +special format, either =<2003-09-16 Tue>= or +=<2003-09-16 Tue 09:39>=[fn:19]. A timestamp can appear anywhere in +the headline or body of an Org tree entry. Its presence causes +entries to be shown on specific dates in the agenda (see [[*Weekly/daily +agenda]]). We distinguish: - Plain timestamp; Event; Appointment :: @@ -5935,7 +5935,7 @@ ** Timestamps ,* Meet Peter at the movies <2006-11-01 Wed 19:15> ,* Discussion on climate change - <2006-11-02 Thu 20:00-22:00> + <2006-11-02 Thu> #+end_example - Timestamp with repeater interval :: @@ -5974,15 +5974,22 @@ ** Timestamps #+cindex: timerange #+cindex: date range - Two timestamps connected by =--= denote a range. The headline is - shown on the first and last day of the range, and on any dates that - are displayed and fall in the range. Here is an example: + Two timestamps connected by =--= denote a range. In the agenda, the + headline is shown on the first and last day of the range, and on any + dates that are displayed and fall in the range. Here is an example: #+begin_example ,** Meeting in Amsterdam <2004-08-23 Mon>--<2004-08-26 Thu> #+end_example + Timerange is a timestamp consisting of two time units connected by =-= + + #+begin_example + ,* Discussion on climate change + <2006-11-02 Thu 10:00-12:00> + #+end_example + - Inactive timestamp :: #+cindex: timestamp, inactive -- 2.39.0 [-- Attachment #3: Type: text/plain, Size: 16 bytes --] -- Best, Ilya ^ permalink raw reply related [flat|nested] 4+ messages in thread
* Re: Timestamp and timestamp range definitions 2023-02-16 18:55 ` Ilya Chernyshov @ 2023-02-17 11:10 ` Ihor Radchenko 0 siblings, 0 replies; 4+ messages in thread From: Ihor Radchenko @ 2023-02-17 11:10 UTC (permalink / raw) To: Ilya Chernyshov; +Cc: emacs-orgmode Ilya Chernyshov <ichernyshovvv@gmail.com> writes: > Subject: [PATCH] org-manual.org: Update timestamp and timerange definitions > Thanks! Applied, onto main. https://git.savannah.gnu.org/cgit/emacs/org-mode.git/commit/?id=715f74db3 -- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at <https://orgmode.org/>. Support Org development at <https://liberapay.com/org-mode>, or support my work at <https://liberapay.com/yantar92> ^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2023-02-17 11:11 UTC | newest] Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2023-02-13 7:21 Timestamp and timestamp range definitions Ilya Chernyshov 2023-02-15 15:10 ` Ihor Radchenko 2023-02-16 18:55 ` Ilya Chernyshov 2023-02-17 11:10 ` Ihor Radchenko
Code repositories for project(s) associated with this public inbox https://git.savannah.gnu.org/cgit/emacs/org-mode.git This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).