From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id 6HvCBlmIimTiCQAASxT56A (envelope-from ) for ; Thu, 15 Jun 2023 05:41:13 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id UIB5BlmIimQ4CwAAauVa8A (envelope-from ) for ; Thu, 15 Jun 2023 05:41:13 +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 7B0F922177 for ; Thu, 15 Jun 2023 05:41:12 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1q9dqS-0007gj-Vp; Wed, 14 Jun 2023 23:40:25 -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 1q9dqQ-0007Xf-KY for emacs-orgmode@gnu.org; Wed, 14 Jun 2023 23:40:22 -0400 Received: from mail-bn7nam10acsn20806.outbound.protection.outlook.com ([2a01:111:f400:7e8a::806] helo=NAM10-BN7-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 1q9dqO-0004Ez-CA for emacs-orgmode@gnu.org; Wed, 14 Jun 2023 23:40:22 -0400 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=L0rmRmPkWVg4vjyH18U2vKMirICqO9VkFxy7wBIolDrcqC/rKcv9Kud8bTwGbZrQK0+g2Ug4L/aawKa4JceOsyrn0duqkJoAw4KU6a8Y7WPjcePnYKLI8YP2/GXQgZtoznr+jVBHtMQ95hXjO83S/V92wK9Sqp4kZD9l1zMbuFlzrLXzUApeotBoSqKqsThVrgJfzan38b0KTkA2IlgYfO4MalwkbtqwwcpruVOqvL1wv5UfwvSpLiG4CyEhM6SQzpj50nAzlW0mqLGuGJIKFZHKWxYmGFEiLUKdCLHW+pM5T2XBgYgfhxuHMGXhj/tWkYeqj8gQS7oayOV7FVCv8A== 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=QxJu6b7XA+XpKmtRY8ob/M1gKinRX3IVhHAsRCrpaAw=; b=cZHjPt9YsmWAaaHhLTMSxVhTxI+FzgMNqcFdAK/itM/adg5aAcPCCpt8hPHAtLQUTaOt8Jy+pa8JqEoI9Ns96fKKmpWUrQXrwEM8gQWt/xnFSkbS6QKXgrSG1PXZcnr4aqvkihG3REWEGHH/7Cj+en0gyrwTjg6BNbxBPsAsrrEMvnvya2Ii6o3p3GtHYMvCLqUnrR1FTzwZWpoBx8hAOSf5NO5yFNnhkBNdgtBXfkx4DEvubxn3FwJE1a4uCoUWW2b0k+mwWKtnGFwQMj65qO9KguyTAoHOBdq1CjDGuPBVvsl4EofuYuFqkCt6PmGXUYUx0OpcRSIDSmELDPCtCA== 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=QxJu6b7XA+XpKmtRY8ob/M1gKinRX3IVhHAsRCrpaAw=; b=DZUc/c9Xhz8C0fCoxeJTzZUkCea89w9eZKQ6NGTXd7Kk+OSk86XFknve8qeHUfmOUC9tNjOuI5zKKU37KQlwZZ1fHztCWpgURADJAjKQNb4J3BUH3YiO3oT+p0APTaC1MotC2KbvSj6AdoVXoA2QA9fla4z+rNESjBWFBL5Bout4NloBLTKkFXdfqX53sEw/9Sj1FkbP5ER/B05hrodoPrcc2kCT2/cnLhU3fwBarmme3v0jozNErcCOFukLlq27pxHTU+pU7soo0xW2L/q60gt9KxbMO7TPrq3RVnkOp3F3fP/W6eLttJPCcXlPKpV35oVKFYL8eoj3YQp7R+CbMA== Received: from SJ0PR03MB5455.namprd03.prod.outlook.com (2603:10b6:a03:27b::11) by SN7PR03MB7155.namprd03.prod.outlook.com (2603:10b6:806:359::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6477.37; Thu, 15 Jun 2023 03:35:15 +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; Thu, 15 Jun 2023 03:35:15 +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> <87a5x6tjr3.fsf@localhost> <87legplzck.fsf@localhost> <87fs6vwvfs.fsf@localhost> <87zg528fzv.fsf@localhost> Date: Wed, 14 Jun 2023 20:35:12 -0700 In-Reply-To: <87zg528fzv.fsf@localhost> (Ihor Radchenko's message of "Wed, 14 Jun 2023 11:01:24 +0000") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) Content-Type: multipart/mixed; boundary="=-=-=" X-TMN: [TIG5RNfjqOr+A//iXxEG+XP6NIjjjIc4828yfZfBLKZgtJZRwE31e7O7uba2ay9T] X-ClientProxiedBy: PH0PR07CA0098.namprd07.prod.outlook.com (2603:10b6:510:4::13) To SJ0PR03MB5455.namprd03.prod.outlook.com (2603:10b6:a03:27b::11) X-Microsoft-Original-Message-ID: <87ilbpo0sv.fsf@penguin> MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 2 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: SJ0PR03MB5455:EE_|SN7PR03MB7155:EE_ X-MS-Office365-Filtering-Correlation-Id: 36bfb46c-a516-4d68-a59c-08db6d51884f X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: YUr5BNnZZgofRM9S7cgz76dCG53Fw/sz9P2wEppuwj8nhHL0AapUV3N2xLsA0KVs5+PXoyACG+zrNAxAb7cNIsTsPAOaFctqsto3BRhRv107CBX6Jl9T6d4jjhPwa4uZkKMELK5JLb38vN/Pas76MuKRxNEEaGHeEYTlPP/qR2XtauUytr4A49p21NjTH2e0fcvBGmPP/UkHXLmPkrHLwZnL1UNPBMDPcRlGe5Gk/8POWiahHhn4JfFJFp7PDhJhF26fTB1+pIjamfbmQLBie/TQpg+EB/FatTID8lsyFeqUVjIYGQKhrm+xBX1hsH7aJvFeuM6HsDxCMygbphYx8/u6yNYZlj+yZThwXczM1NVD4l7WHxDE5ujr7VpGMiiBnY8hIjxKakyS4z6IB9dPJfu7fUvi0AI7boux8m8XkPQmgO6InuPpQVndldcmNCPGfubb/7Pz8cGNi1tzhnlIpXdGyCayRmitVi1DSe2W9CaGpZpLooa5aBrCLJDI8wUBQ/sS4fRmLGIQcFbEE1NqodCv6H0H69vmUbw5ehD6A9u0g3t05fP5NjXNyv4Okuh1qrnygZnWvoKH0O844nSqHShJR2J4u/2XWNlyUaV5KHyS5NubHtYGjRM+Zo8WoVKS X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?S3GsH4hD6+80/kkUDJBAiH2fJc8FPHS4EdoFv+pNyCMTIODuwyThOc+dxAX7?= =?us-ascii?Q?CjB8dWEDD4Jf27qGmeHSKDRlM3VQehn9G5EQ3rNfJ9Vly5HueV7h/ryXuLfw?= =?us-ascii?Q?zK1aW7NbRdIk7nTxFWOO7h8iLUGdqmXOeVMWCIenp03GFQYEEpGfJuwMzzPm?= =?us-ascii?Q?VqboB1FDmj7ZX9p1K0ZywA8xGh2MGEH3RfJp/LcBTNAXrMC1oBbe8Si+jBGA?= =?us-ascii?Q?iBHlHv6siCmvsdHrPoMU2CunuBvu7TgkeGRkGISP/Y7bg1J1uYmnAQG/B5z/?= =?us-ascii?Q?/l6ZGtdMYMWrBt9FXSCkHHmpLF0LWVMM8HkmhRqZn+a/MMn9rJJP8csOJK9j?= =?us-ascii?Q?pCPHS+d5TLQyCYNPlYOfmhXhht/v+gjHlIguEaj1BpaW6sMlC5mxA7OKJZlQ?= =?us-ascii?Q?ONfFTiO0o4QVb9YkctWM8p5qh9H6MehOctEEiIL2JzJJMrrYtVO9kQh5rhXq?= =?us-ascii?Q?lc/OkPwcyoA6GE5OEaMWb4Mn/ndfNcgkoZcdxvWWdhy6NhgoGmdQIOu4S4wX?= =?us-ascii?Q?vwqZ1K5f7F01W2Na2s+I2+M8lNeJJQn/UmcqeWZHEA5DozH+cx9j9oxMDwlw?= =?us-ascii?Q?SB1Ls4ICMntABhgksPAKI6KwRAYW7URDJcbRZfUOdhuRJjESNV7RUXAjDenp?= =?us-ascii?Q?QAAyGsT9fFMwSza+tl2djQ8mmxppLf4VOsz1hNqEY7UCOm5C4jxKJSpE1vUk?= =?us-ascii?Q?aEEJmXZMs2ZXMeOvciG5dEC1OveIsun5JUSXiVvT3W98xwWp9OrLN4wQG/cv?= =?us-ascii?Q?QPnJ49N4r8KUxbsqhyxUIgTaRAKA8NAaUboiD1gOyJn+jm9k6rwrOdfK7Egj?= =?us-ascii?Q?gjbaPeEEfF0GlZ/sV8ZznaC1cHGT721RIE+MNbX+L1g/FnvRS39Z3qGnvKC+?= =?us-ascii?Q?Q1f/VzIg/m9W4IKTohSoNXNUYuvHMme0xIMW3ZbgyDf/bFQHuVbNdsGVMq5s?= =?us-ascii?Q?SI+joO+eCPpLLnofJYLIeTL0axBrTlJA4tbwWtdTucQXO9iHGU220ndmEf78?= =?us-ascii?Q?0EAzSSS5pCrPnHaa50xLsREKk+PIknSHcaXhlOt5UutnkvyUdERmxuI+sdy3?= =?us-ascii?Q?y/d31oU3Y5rKMj3/WzJmkEWhwVI/8RacckZXKBOMh+QngCoN+icNbjivBZHv?= =?us-ascii?Q?WMrq0bX+phQUgdbysFI3B1e7LzNGnvsEk8yfA6m7gzE4S0CaVV6fxKqnolIx?= =?us-ascii?Q?vzDWZwxNhS2kofnwsZQqXvyc+GroxdyRKiOTXI4X8uYP0NKjoKSb7P6GodEq?= =?us-ascii?Q?qk2R9cI2QjzwWPzjQXt+0/s4xndqK246//NX/a0ZZAlCXxzKsLh1I84iwZoV?= =?us-ascii?Q?ztWXbZq0bXx6J9D2Px4+tmIr?= X-OriginatorOrg: outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 36bfb46c-a516-4d68-a59c-08db6d51884f X-MS-Exchange-CrossTenant-AuthSource: SJ0PR03MB5455.namprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 15 Jun 2023 03:35:15.5717 (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: SN7PR03MB7155 Received-SPF: pass client-ip=2a01:111:f400:7e8a::806; envelope-from=outlook_98C99531806B1C22@outlook.com; helo=NAM10-BN7-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=1686800472; a=rsa-sha256; cv=pass; b=ZhKp1Ia40MVWr/iKOzNlNj7XIPt9ZZZGVIpHkaY4f4Hfg0UKWaDJ7ecg3kUWrct8pCGTJY Vq1JnBT5MyqWGOYF3IQO7UR1USCG5CKnWwZ9H2ZDNl9tx8ZJisyQblHHwNg/M8ipqQimz6 6Qj2Dkc1P5Ix3WOLIXgxVnO9PNlJFNgcE80UjUDqJ80lkdMPQZuKpULheuSFp+qulffw8c Z7VR4RBXrc7yhlDSy9DAmT0Y6XeYvrZRmLP176dfDYhb3QepFuLT5NZhtARt1WPy4wHfi6 aabFxPCnFnvoqk3kG5D75hpoiRoQbq2RR0OSPAZiN2DVCIUnboLy2SveL+SZgA== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=pass header.d=outlook.com header.s=selector1 header.b="DZUc/c9X"; 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=1686800472; 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=QxJu6b7XA+XpKmtRY8ob/M1gKinRX3IVhHAsRCrpaAw=; b=ZJRCl9x+nCa1ZmJX9Rq9BACY5+LzVlE947mxasSkSiH6gT2RE+zzHIJ/W75zUyB11SksPJ IlLshW/FuLX398An2bGkx2MrjnGxuPwmCK77TtMuCbFb+IImzb0AtnySEaNsyXKVeaSYNY PFtdM7w4u3bmIg0eqAVz64AxTCWl9XSXmH/4EcdqOY7zF54LelVrlbajUEnOnOEZjLT2BV nf/VxdNZx2wdz3gp93tZhN5HoKwiq2/NMWpDVwhfFA3g2g7VKkjVo9U5NWUWGoffb3w+ga b3NPIFScJrrWX1/G05OccDR+AGWladm6w0j3VQjOdiyrGo/ETMyq5b0ZuYQFIQ== Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=outlook.com header.s=selector1 header.b="DZUc/c9X"; 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: -11.07 X-Spam-Score: -11.07 X-Migadu-Queue-Id: 7B0F922177 X-TUID: GQ1rjbMXDvSN --=-=-= Content-Type: text/plain Ihor Radchenko writes: > David Masterson writes: >> To assist project planning, TODO items can be labeled with a date >> -and/or a time. The specially formatted string carrying the date and >> +and/or a time for purposes like a timestamp on an event, a deadline >> +for a task, or clocking time on a task as described in later sections >> +of this chapter. The specially formatted string carrying the date and >> time information is called a /timestamp/ in Org mode. > > IMHO, this is just creating confusion. > Remember that this manual/guide is going to be read by people who are > not yet familiar with Org mode terminology. What is "timestamp on an > event"? What if you put a timestamp on a non-event? What is "clocking > time"? Ok. I did use "like". ;-) I don't want to get too in the weeds (because I don't know it all), so how about: ... purposes like when an event happens, a deadline for a task, or tracking time spent on a task ... >> 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. >> + There can be multiple timestamps in an event. > > Why event? What about tasks? Can just use more general "heading" or "entry". Good point. The paragraph already used 'item' -- would that be better? New patch file attached: Change log: ================ Doc change to explain timestamps better doc/org-guide.org (Dates and Times): purpose of timestamp + examples doc/org-manual.org (Dates and Times): purpose of timestamp + examples ================ --=-=-= Content-Type: text/x-diff Content-Disposition: attachment; filename=patch4.diff Content-Description: Change for org-guide and org-manual diff --git a/doc/org-guide.org b/doc/org-guide.org index 95828e4c0..e033ac0d9 100644 --- a/doc/org-guide.org +++ b/doc/org-guide.org @@ -1080,7 +1080,9 @@ Tags and Properties]]. :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 +and/or a time purposes like when an event happens, a deadline for a +task, or tracking time spent on a task as described in later sections +of this chapter. The specially formatted string carrying the date and time information is called a /timestamp/ in Org mode. ** Timestamps @@ -1099,20 +1101,24 @@ the agenda (see [[*The Weekly/Daily Agenda]]). We distinguish: 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. + There can be multiple timestamps in an item. #+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> + ,* 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 Wednesday: #+begin_example ,* Pick up Sam at school @@ -1121,8 +1127,6 @@ the agenda (see [[*The Weekly/Daily Agenda]]). We distinguish: - Diary-style expression entries :: - #+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 +1136,28 @@ the agenda (see [[*The Weekly/Daily Agenda]]). We distinguish: <%%(diary-float t 4 2)> #+end_example +- Time range + + Time range is a timestamp having 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. 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. The first example + specifies just the dates of the range while the second example + specifies a time range for each date. #+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..71f52fac6 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -5978,14 +5978,15 @@ 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. +and/or a time for purposes like when an event happens, a deadline for +a task, or tracking time spent on a task as described in later +sections of 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 +5994,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: +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 [[*The Weekly/Daily Agenda]]). We distinguish: - Plain timestamp; Event; Appointment :: @@ -6011,13 +6011,16 @@ agenda]]). We distinguish: 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. + a plain timestamp is shown exactly on that date. There can be multiple timestamps in an item. #+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 :: @@ -6053,24 +6056,31 @@ agenda]]). We distinguish: <%%(diary-float t 4 2)> #+end_example +- Time range :: +#+cindex time range + +Time range is a timestamp having two time units connected by =-= + +#+begin_example +,* Discussion on climate change + <2006-11-02 Thu 10:00-12:00> +#+end_example + - Time/Date range :: - #+cindex: timerange + #+cindex: time range #+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: + dates that are displayed and fall in the range. The first example + specifies just the dates of the range while the second example + specifies a time range for each date. #+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> + ,** This weeks committee meetings + <2004-08-23 Mon 10:00-11:00>--<2004-08-26 Thu 10:00-11:00> #+end_example - Inactive timestamp :: --=-=-= Content-Type: text/plain -- David Masterson --=-=-=--