From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id yKYnGR9phWSrUAAASxT56A (envelope-from ) for ; Sun, 11 Jun 2023 08:26:39 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id WC89GB9phWQPDgAAG6o9tA (envelope-from ) for ; Sun, 11 Jun 2023 08:26:39 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id BBC34103E9 for ; Sun, 11 Jun 2023 08:26:38 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1q8EW0-0007WN-KQ; Sun, 11 Jun 2023 02:25:28 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1q8EVy-0007Tt-KB for emacs-orgmode@gnu.org; Sun, 11 Jun 2023 02:25:26 -0400 Received: from mail-dm6nam12acsn20807.outbound.protection.outlook.com ([2a01:111:f400:fe59::807] helo=NAM12-DM6-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1q8EVu-0002Eb-Rc for emacs-orgmode@gnu.org; Sun, 11 Jun 2023 02:25:26 -0400 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ReQl41bjCUgaWNsF46olqB64/dwA6Nc4G44b9a1AjcOMIQGOXfEcBxKFhzhE93Cc8jaGgN2NgzUctiTaK9XWmU+Z8mAxi8zRo91PVGXGXsdgUKo7X2nvqhcUdQSbGQrK4a8VNyd7pBWuK6eGc22SCEkZZvcaeSGggczE4i0ZYASizBgi8mIztOWnqVnXuVttZtlXA0orW9LFNGQ0EXXQ2OEVy5JXSMjupb5/hK1g3nCY60GU2uT4/zVXdNBQeV/S32tyqPIcmOJS7LF43FSZXqjKacMLFLKztJGmdUeLW9Z/KJ070Wxbw/qvN4LJP4L6GxyRHHhoksOXx1F1e3FS7g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=xGIPkj1VepBB/FGFL2S4miapZVcxmZMOt2E9xCF54SI=; b=VTYq+9Eg+HKEDlfHFu7wcjf1z1GCqLCUiiUOtmBZIwpxIYoDf9nQVzoBFR7Bi4oVJNatxUUZ1oZ0Be7eCWcFzKIYhVZAv6wOy+q/WswuKAT5JhKkMFc7ryRdajJfGkIFb938+8QE/na4HjYh8Gjo96L9S4yUQ3Yp3IMFJojL+AkS94eoWgV2dq3gnEKOWQ1x3AyRhIMYSu0phDJCmT0JL1r9b9Z7jPR54AGMMiGgN8ZahIKMPkhNnfeld3M6yDsn/pmMi9Kimx580SNujkQmqgsQ7p/kcG86yaOrWFx04KtSM9XzdmApFEsZJdxVx7jPimY76ed9bkXt7tae8q4NHw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none; dkim=none; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=outlook.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=xGIPkj1VepBB/FGFL2S4miapZVcxmZMOt2E9xCF54SI=; b=iQJxS8WJ6Sra+s6j/3NJUip++WOQ2X2rJs+CiiSTzRdHWkBej2zdbnTqqxF5czF+eOyxw+v63bSq2zI1VZZHE0mDOsFmcTRcO/Crj3XkUbH3/H1o0GD5hlAif072caxDyYNzwRV0sZvF7C8Q3j5lCZXhpJ+ovTAn3iN/NYNwrtUIUvF7P/O4nuepU6j0P416+3NHLSW9d1+CBPQPaR4Wj7LfXfaDzpwZK/vuGuy+PLyrSvSTHbwaXtjd3P4+GRBMVQN4BrYF2NvkbibojOCglu7ytcjo5nsVUxZ+62LY6dbwEiRNFDGcU/KxFG9sbTe63iLj/bJbWUi0pbRwO8FDqw== Received: from SJ0PR03MB5455.namprd03.prod.outlook.com (2603:10b6:a03:27b::11) by CH2PR03MB5157.namprd03.prod.outlook.com (2603:10b6:610:9b::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6455.44; Sun, 11 Jun 2023 06:20:18 +0000 Received: from SJ0PR03MB5455.namprd03.prod.outlook.com ([fe80::34a9:d9f6:b659:70d0]) by SJ0PR03MB5455.namprd03.prod.outlook.com ([fe80::34a9:d9f6:b659:70d0%6]) with mapi id 15.20.6477.028; Sun, 11 Jun 2023 06:20:18 +0000 From: David Masterson To: Ihor Radchenko Cc: emacs-orgmode@gnu.org Subject: Re: Is this proper time format? References: <87r0qplm9y.fsf@localhost> <87ilc1ktrx.fsf@localhost> <875y7y2qga.fsf@localhost> <87h6rh140j.fsf@localhost> <87v8fvtz1u.fsf@localhost> Date: Sat, 10 Jun 2023 23:20:15 -0700 In-Reply-To: <87v8fvtz1u.fsf@localhost> (Ihor Radchenko's message of "Sat, 10 Jun 2023 10:02:53 +0000") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) Content-Type: multipart/mixed; boundary="=-=-=" X-TMN: [863grTshQg+PluXDKjv6733eNDipu3QETK1JphorQ05JsRG4BTHTSq6RnrjxJ7Bj] X-ClientProxiedBy: PH0PR07CA0064.namprd07.prod.outlook.com (2603:10b6:510:f::9) To SJ0PR03MB5455.namprd03.prod.outlook.com (2603:10b6:a03:27b::11) X-Microsoft-Original-Message-ID: <87zg56plk0.fsf@penguin> MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 2 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: SJ0PR03MB5455:EE_|CH2PR03MB5157:EE_ X-MS-Office365-Filtering-Correlation-Id: 657922df-040c-4b38-076b-08db6a43ed5a X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: QeBlwLYFHq+QLvusI0uEselsQM1Ys27H+UqI9Wg2BpRmPaGNZzIS7sL95r1VLs+1h1mYv6e1kS6nM58bw82EcMclepj/CVr4GlQ7NMZzIkPNiYDWqHJUpcax9UuJ2DiXkIV9RraCX4zpNp+hLHuVgIsm4YhQmjGfkYb+Xoi9RvxWtiULRflJX2peGz7AxA6j3af4iso1O9flIrsBYTC/Y5ZUXYHhU3d7msS66D/FcT3yLmaSIuG3wPOr8R+CVEw3DIDjc8Rtuavsj6ONX6ktTiLRYuKgLvK/3c0JCiIxSQY+md9KvuTmgsfRQuFtXJEAv/doZ330wRminz9du2203wHuDVFA3tbTw+4AG2pfe2vuOl6AquZfpUbUDh2VyXn+nOOGdGl4yHAEHYXuw3lhLYVLBOepMpjt/mi1b8Xr1v+tZsc5E/YVnfCaZuTnXnRA8yF+Kq3IcvrTGBaR92ZI+H1UkyxbhQlvpNR9sbu1Qhf+drFeggJ/mz4lXUZdffZpK+zwJMEJuiEtTXSKWq9qHGkhX5md32KGhS9lRdBLXTlgCpLDQ0M0SgZ0JpHQEJUmS9MGjzVp8gkd9sgplLoNsKpXoKj0GY/r49Y8Rz1KBfuMz+920OCB+96T89P26W3WKd831nCZpPlGiyyf23/xVA== X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?qvhLrO0AeNJKk9T4h8OnmPcrs6ipZHgSvfA93l2XgYxbxn0Mu5tz82ArWYN0?= =?us-ascii?Q?jkUQMFHUQPRmvMiE17qti7nCfDDRmmub/hh3K25cbUXhX8cfZtgfQ9OjygnL?= =?us-ascii?Q?0yZLWMhcF3X2VsoJpe2XGjb2LuDv3VqNx+yTXJL36NFVvz2bWj5jE4oD/uMe?= =?us-ascii?Q?u0dEDGBhQdliCRskV6/D3QcdaF7eETsBw5qckdDcr5PMBfJZItrEzKQxQ0C8?= =?us-ascii?Q?G2OAaoSvRwQexl3CBSn+X/+dEPyv0ujkbbol7VA8plnsdstF/FxLDZ+6L6sQ?= =?us-ascii?Q?1MR5vXYAh+mk3sjZH2nMHmNmHxA8K+aGVpjd3tOMqQHx8HTBp77i+mXekKPH?= =?us-ascii?Q?76BVU4rVe//dkrDTN5FAc7RZLgNaRi6zfqxQ3oS/3QJzF6L6D4NardfjFlQ1?= =?us-ascii?Q?j96r4l6W8maGg0az8Mx0xXq0jEi1yCD7g03z8kF8zXpg/eWx/w2awBb0Qhev?= =?us-ascii?Q?hlF8g6agh27gNCrAoleKcNEy6ev3nzBBcW5fwVE8A8ZhsZa3tZusZ3NODD4J?= =?us-ascii?Q?NhbhD1hmAW4C6WXOZZdsjFO3Po4OKbJXw++khZcNurAOLvwwHkUsGJmX+nTr?= =?us-ascii?Q?d2VG/gFkMIKLm08lPovi0/MkcCExLZRBX8yiY2BPlPMGXxJT35LnMNyfNjRV?= =?us-ascii?Q?HbmIZ7dXdExsQOJu3c/2g9Tl2XHxU23wYc53sEavrL8UgrOS3GkloOobWQ2u?= =?us-ascii?Q?k3zt0CJNn6MiE1zYO4FCYxWxytTr6X6H5Qe90m22XN2I4KpwfyNa3+XYpXBr?= =?us-ascii?Q?1xoo1RrUM65NPw/hNVD7j+POYjmaJkKv5aaK0PwoAXqUygr6MkFvlosv/9Xz?= =?us-ascii?Q?uqlJkZ1+X8yopnz3Bc6dWDtcO0HE7ZYfvOZEX98hGZyeTnkZ42NE6sYLUE5d?= =?us-ascii?Q?2y5PIlnJeegGjD1jWidIO6IUHzqpJvkPkQheGv4rRrDcb/bfAVIJcE7Lr//a?= =?us-ascii?Q?87CBrq7zxsQ/CQjU4cDQhkAGFVr19LYQEkvzXDxh14+lMElYbfhkmg3Il+ci?= =?us-ascii?Q?9cK8Szqj4nJBiq1z687mdQgBz8KevvmvaLcEErlTDOy38sy9b+eOt5E3H0e6?= =?us-ascii?Q?bgCUFo5MNlHMYYxXz/+aBpKtB3XvJh625rRnUFj2PI5YJZ68llT69zmg0bwr?= =?us-ascii?Q?8/QKvoPzFx9jYbQ6E7+J2Vt/kH36ZDiNShMONBOhH9FOPeVkFhBOfZlsOan9?= =?us-ascii?Q?uqwxl0KCpDGe/ckrGAnKk/+8iFn+mscSLnNT3wRXKw7zphgp4cv4g0DeooEl?= =?us-ascii?Q?zJLij/hHewpJatK8yBegCjNCximOfAeh/POHXrr20eJnlU4ueDg7ClTaVkMW?= =?us-ascii?Q?FuRMQEDKlqIDkIMxHz7sFv/u?= X-OriginatorOrg: outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 657922df-040c-4b38-076b-08db6a43ed5a X-MS-Exchange-CrossTenant-AuthSource: SJ0PR03MB5455.namprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 11 Jun 2023 06:20:18.4356 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH2PR03MB5157 Received-SPF: pass client-ip=2a01:111:f400:fe59::807; envelope-from=outlook_98C99531806B1C22@outlook.com; helo=NAM12-DM6-obe.outbound.protection.outlook.com X-Spam_score_int: 6 X-Spam_score: 0.6 X-Spam_bar: / X-Spam_report: (0.6 / 5.0 requ) BAYES_00=-1.9, DKIM_ADSP_CUSTOM_MED=0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_EF=-0.1, FORGED_GMAIL_RCVD=1, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, NML_ADSP_CUSTOM_MED=0.9, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: emacs-orgmode-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN ARC-Seal: i=2; s=key1; d=yhetil.org; t=1686464798; a=rsa-sha256; cv=pass; b=LrjZ3gqQ3oOgJskdOS30hOxbkTOp2ufwNjo+Ix+W99iUzoQq0ni/6TNtebX77wMdCE3tYa FT0a/CqiP1hKDksIDNgqL/9AoWkgR/YXTPKmMngpd6TkQhThXLo03pDpuBxqvFrTjtJodi bsounIZbc8Pf+spQZZN+0ufqf1Gynf3Ox975n1GUlyO5VjoXtU//TXNcVo/Xrve0Rw5uKT 5P1mtP5imWGEQIGw0DCmXxLQigvZ4qdO4xYrNdyABd7zbpqSWK8/1U7DyRRFHqYMbkCeug DpTfkWaQ1g3mzBBlJWb4qih3tNTnqmGIzG/bOt0TsHGMFPltbOw1L0EhHue67w== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=pass header.d=outlook.com header.s=selector1 header.b=iQJxS8WJ; dmarc=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=gmail.com (policy=none); arc=pass ("microsoft.com:s=arcselector9901:i=1"); spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1686464798; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=xGIPkj1VepBB/FGFL2S4miapZVcxmZMOt2E9xCF54SI=; b=O49b71SlyRv8u9o9GepjE4eRCMFPcapwVnXjeYsuJM5YzkJwIy5YGPRNBGU65xSd3cRPxV KUA64EvfZ7phd5xx/MRnVU3aeZ27DBWcAodDr5/mkx4Bp2U3QRYIIoidZRh4dfDoHyE0gd 3t5Sb4rIAkgTwsI0b8XUT1e6THISVT6lfrhirrbn82Rfr0f1etFUTeFGY2bQiWtGuA5rKh xslGvCPwBYgk5yJ1V4HT/nbcTE2E/CEcxmoRqHQ1AmCBw5ROc+QNbnYzRkc3N+QI+dkJEV Uu2+2lmDQ1ICUugJwRULptJJzl58qlz4HpT29l+p5o/DZW0w1mS6O0r8EkmSkw== Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=outlook.com header.s=selector1 header.b=iQJxS8WJ; dmarc=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=gmail.com (policy=none); arc=pass ("microsoft.com:s=arcselector9901:i=1"); spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Scanner: scn0.migadu.com X-Migadu-Spam-Score: -10.85 X-Spam-Score: -10.85 X-Migadu-Queue-Id: BBC34103E9 X-TUID: UYYAb3huU5uZ --=-=-= Content-Type: text/plain Ihor Radchenko writes: > David Masterson writes: > >>>> Maybe I'm not explicit enough. In section 8.1 of the Org 9.6 manual is >>>> a subsection "Time/Date Range" that *implies* times are supported in >>>> ranges by the use of words "time" and "timestamp" when, above, you're >>>> saying they are undefined (unsupported?) for now. I'm merely saying >>>> adjust the manual to remove the implication. >>> >>> Please check the manual from main branch of Org. It has more text: >> >> I disagree. I cloned Org from Savannah and made the attached patch >> file from the main branch. First time for me attaching a file to a >> message. Does it work for you? > > Yes. Though it would be better to attach the diff with proper (.diff or > .patch) extension. I've updated my patch file taking into account what you mentioned and what I tested. Does this look all right? --=-=-= Content-Type: text/x-diff Content-Disposition: attachment; filename=patch_file.diff Content-Description: Patch of Org-Guide and Org-Manual diff --git a/doc/org-guide.org b/doc/org-guide.org index 95828e4c0..12a1f0126 100644 --- a/doc/org-guide.org +++ b/doc/org-guide.org @@ -1079,40 +1079,51 @@ Tags and Properties]]. :DESCRIPTION: Making items useful for planning. :END: -To assist project planning, TODO items can be labeled with a date -and/or a time. The specially formatted string carrying the date and -time information is called a /timestamp/ in Org mode. +To assist project planning, TODO items can be labeled with dates +and/or times for purposes described in this chapter. The specially +formatted string carrying the date and time information is called a +/timestamp/ in Org mode. ** Timestamps :PROPERTIES: :DESCRIPTION: Assigning a time to a tree entry. :END: +#+cindex: timestamps +#+cindex: ranges, time +#+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>=. -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 [[*The Weekly/Daily Agenda]]). We distinguish: +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>=. 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/times in the agenda (see [[*The Weekly/Daily Agenda]]). We +distinguish: - Plain timestamp; Event; Appointment :: A simple timestamp just assigns a date/time to an item. This is - just like writing down an appointment or event in a paper agenda. + just like writing down an appointment or event in a paper + agenda. There can be multiple timestamps in an event. #+begin_example ,* 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 10:00-12:00> + ,* My days off + <2006-11-03 Fri> + <2006-11-06 Mon> #+end_example - Timestamp with repeater interval :: A timestamp may contain a /repeater interval/, indicating that it - applies not only on the given date, but again and again after - a certain interval of N days (d), weeks (w), months (m), or years - (y). The following shows up in the agenda every Wednesday: + applies not only on the given date, but again and again after a + certain interval of N hours (h), days (d), weeks (w), months (m), or + years (y). The following shows up in the agenda every week at the + given day of the week and time: #+begin_example ,* Pick up Sam at school @@ -1123,6 +1134,7 @@ the agenda (see [[*The Weekly/Daily Agenda]]). We distinguish: #+cindex: diary style timestamps #+cindex: sexp timestamps + For more complex date specifications, Org mode supports using the special expression diary entries implemented in the Emacs Calendar package. For example, with optional time: @@ -1132,13 +1144,24 @@ the agenda (see [[*The Weekly/Daily Agenda]]). We distinguish: <%%(diary-float t 4 2)> #+end_example +- Time range :: + + Time range 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 + - Time/Date range :: - Two timestamps connected by =--= denote a range. + Two timestamps connected by =--= denote a range. The first example specifies just the dates of the range while the second specifies particular times during the dates. #+begin_example ,** Meeting in Amsterdam <2004-08-23 Mon>--<2004-08-26 Thu> + ,** This weeks committee meetings + <2004-08-23 Mon 10:00-11:00>--<2004-08-26 Thu 10:00-11:00> #+end_example - Inactive timestamp :: diff --git a/doc/org-manual.org b/doc/org-manual.org index c11694849..d56563955 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -5978,14 +5978,14 @@ or a dynamic block. #+cindex: dates #+cindex: times #+cindex: timestamp -#+cindex: date stamp -To assist project planning, TODO items can be labeled with a date -and/or a time. The specially formatted string carrying the date and -time information is called a /timestamp/ in Org mode. This may be -a little confusing because timestamp is often used as indicating when -something was created or last changed. However, in Org mode this term -is used in a much wider sense. +To assist project planning, TODO items can be labeled with dates +and/or times for purposes described in this chapter. The specially +formatted string carrying the date and time information is called a +/timestamp/ in Org mode. This may be a little confusing because +timestamp is often used as indicating when something was created or +last changed. However, in Org mode this term is used in a much wider +sense. ** Timestamps :PROPERTIES: @@ -5993,16 +5993,15 @@ is used in a much wider sense. :END: #+cindex: timestamps #+cindex: ranges, time -#+cindex: date stamps #+cindex: deadlines #+cindex: scheduling 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: +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/times in the agenda (see +[[*Weekly/daily agenda]]). We distinguish: - Plain timestamp; Event; Appointment :: @@ -6010,14 +6009,18 @@ agenda]]). We distinguish: #+cindex: appointment A simple timestamp just assigns a date/time to an item. This is just like writing down an appointment or event in a paper agenda. - In the agenda display, the headline of an entry associated with - a plain timestamp is shown exactly on that date. + In the agenda display, the headline of an entry associated with a + plain timestamp is shown exactly on that date/time. There can be + multiple timestamps in an event. #+begin_example ,* Meet Peter at the movies <2006-11-01 Wed 19:15> ,* Discussion on climate change - <2006-11-02 Thu> + <2006-11-02 Thu 10:00-12:00> + ,* My days off + <2006-11-03 Fri> + <2006-11-06 Mon> #+end_example - Timestamp with repeater interval :: @@ -6026,7 +6029,7 @@ agenda]]). We distinguish: A timestamp may contain a /repeater interval/, indicating that it applies not only on the given date, but again and again after a certain interval of N hours (h), days (d), weeks (w), months (m), - or years (y). The following shows up in the agenda every Wednesday: + or years (y). The following shows up in the agenda every week at the given day of the week and time: #+begin_example ,* Pick up Sam at school @@ -6053,24 +6056,27 @@ agenda]]). We distinguish: <%%(diary-float t 4 2)> #+end_example -- Time/Date range :: +- Time range :: - #+cindex: timerange - #+cindex: date range - 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: + #+cindex: time range + + Time range is a timestamp consisting of two time units connected by =-= #+begin_example - ,** Meeting in Amsterdam - <2004-08-23 Mon>--<2004-08-26 Thu> + ,* Discussion on climate change + <2006-11-02 Thu 10:00-12:00> #+end_example - Timerange is a timestamp consisting of two time units connected by =-= +- Time/Date range :: + + #+cindex: time range + #+cindex: date range + + Two timestamps connected by =--= denote a range. The first example specifies just the dates of the range while the second specifies particular times during the dates. #+begin_example - ,* Discussion on climate change - <2006-11-02 Thu 10:00-12:00> + ,** Meeting in Amsterdam + <2004-08-23 Mon>--<2004-08-26 Thu> #+end_example - Inactive timestamp :: --=-=-= Content-Type: text/plain -- David Masterson --=-=-=--