This is the official manual for the latest Org-mode release.
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>’1 or ‘<2003-09-16 Tue 09:39>’ or ‘<2003-09-16 Tue 12:00-12:30>’2. 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:
* Meet Peter at the movies <2006-11-01 Wed 19:15> * Discussion on climate change <2006-11-02 Thu 20:00-22:00>
* Pick up Sam at school <2007-05-16 Wed 12:30 +1w>
* 22:00-23:00 The nerd meeting on every 2nd Thursday of the month <%%(diary-float t 4 2)>
** Meeting in Amsterdam <2004-08-23 Mon>--<2004-08-26 Thu>
* Gillian comes late for the fifth time [2006-11-01 Wed]
[1] In this simplest form, the day name is optional when you type the date yourself. However, any dates inserted or modified by Org will add that day name, for reading convenience.
[2] This is inspired by the standard ISO 8601 date/time format. To use an alternative format, see Custom time format.
[3] When working with the standard diary sexp functions, you
need to be very careful with the order of the arguments. That order depend
evilly on the variable calendar-date-style
(or, for older Emacs
versions, european-calendar-style
). For example, to specify a date
December 12, 2005, the call might look like (diary-date 12 1 2005)
or
(diary-date 1 12 2005)
or (diary-date 2005 12 1)
, depending on
the settings. This has been the source of much confusion. Org mode users
can resort to special versions of these functions like org-date
or
org-anniversary
. These work just like the corresponding diary-
functions, but with stable ISO order of arguments (year, month, day) wherever
applicable, independent of the value of calendar-date-style
.