Key:date

From OpenStreetMap Wiki
Jump to navigation Jump to search
date
Description
Date when related event happened (memorials), or is a clock showing the current date in addition to showing time. Show/edit corresponding data item.
Group: properties
Used on these elements
may be used on nodesmay be used on waysmay be used on areas (and multipolygon relations)use on relations unspecified
Useful combination
See also
Status: in use

The key date has two different uses:

  • 1. Date when the related event happened historic=* (Status: in use)
  • 2. Does a clock amenity=clock also show the current date? (Status: "approved" ).

Many current uses should be using another tag from the list below (status February 2026). It's suggested to deprecate this key and replace it with two others, see community:135862.

Formatting historic=*

Dates use the ISO 8601 system, which is based on the Gregorian calendar.

Caution: ISO8601 uses the format yyyy-mm-dd, not the common North American model of mm-dd-yyyy

Examples:
2010
where the year is known, but no more
0897 (for 897 AD)
1848-07
where the year and month are known
2010-03-31
for where the full date is known, using the format yyyy-mm-dd


For centuries, use the C-notation.

Example:
date=C18
date in the 18th century (years 1701 to 1800)


To indicate a time period, use ".." between the beginning and the end.

Example:
2010..2012
years 2010 to 2012


To indicate several, separate dates, use ";" between the dates.

Examples:
2001;2026
year 2001 and year 2026
2010-01-01;2011-12-31
for 1 January 2010 and 31 December 2011

Formatting amenity=clock

See also

  • survey:date=* - Date of last time the feature was surveyed
  • check_date=* - Date when the feature was last surveyed
  • start_date=* - Date when feature opened, the construction of the feature finished, or the feature was first at location
  • construction_date=* - Date when the construction of the feature finished
  • year_of_construction=* - Year when the construction of the feature finished, year range when the construction took place
  • artwork:creation_year=* - Date when an artwork was created
  • source:date=*

Possible tagging mistakes

This tag was also heavily used for other, unknown reasons (for example date=2014 added to most minor roads in one rectangle in Mexico)

Some uses by mappers included specifying date when feature was mapped. See survey:date=* or check_date=* instead.


  • date=28/09/2015🔎 ‒ if date key is to be used, it should be 2015-09-28
If you know places with this tag, verify if it could be tagged with another tag.
Automated edits are strongly discouraged unless you really know what you are doing!
  • date=2020/08/25🔎 ‒ if date key is to be used, it should be 2020-08-25
If you know places with this tag, verify if it could be tagged with another tag.
Automated edits are strongly discouraged unless you really know what you are doing!
  • date=20110710🔎 ‒ if date key is to be used, it should be 2011-07-10
If you know places with this tag, verify if it could be tagged with another tag.
Automated edits are strongly discouraged unless you really know what you are doing!
  • date=20120721🔎 ‒ if date key is to be used, it should be 2012-07-21
If you know places with this tag, verify if it could be tagged with another tag.
Automated edits are strongly discouraged unless you really know what you are doing!
  • date=2014/02/22🔎 ‒ if date key is to be used, it should be 2014-02-22
If you know places with this tag, verify if it could be tagged with another tag.
Automated edits are strongly discouraged unless you really know what you are doing!