activity-date

iati-activities/iati-activity/activity-date

This is the reference page for the XML element activity-date. See also the relevant overview page: Activity Dates

Definition

The planned and actual start and completion dates of the activity. Start dates may reflect either the commencement of funding, planning or physical activity. End dates should, wherever possible, reflect the ending of physical activity. Dates should be in ISO 8601 date YYYY-MM-DD format, e.g. 2010-10-01.

For the value of the @type attribute, see http://iatistandard.org/codelists/activity_date_type

The text content may contain a general date text (e.g. 2011Q1) for recording less specific dates such as month, quarter, or year.

The text in this element must be of type xsd:string.

Attributes

@type

A machine readable code describing the type of thing being referenced. The value should be available on a related codelist.

This value must be of type xsd:string.

This value must be on the ActivityDateType codelist.

@iso-date

An activity milestone date in ISO 8601 date format, e.g. “2010-12-01”.

This value must be of type xsd:date.

activity-date[@type='start-actual']/@iso-date must be before activity-date[@type='end-actual']/@iso-date

activity-date[@type='start-planned']/@iso-date must be before activity-date[@type='end-planned']/@iso-date

activity-date[@type='start-actual']/@iso-date must be in the past.

activity-date[@type='end-actual']/@iso-date must be in the past.

@xml:lang

ISO 2 letter code specifying the language of text in this element.

This value must be on the Language codelist.

Example Usage

Example of an activity-date with one each of the four possible ActivityDateType codes:

A date in ISO 8601 format (YYYY-MM-DD) is required:

In this example, free text has been included with the end-actual element. This is entirely optional, and best applied when such text can add additional clarification to the activity-date:

  <activity-date iso-date="2012-04-15" type="start-planned" />
  <activity-date iso-date="2012-04-28" type="start-actual" />
  <activity-date iso-date="2015-12-31" type="end-planned" />
  <activity-date iso-date="2015-12-31" type="end-actual">Closing date of project</activity-date>

In some cases, not all ActivityDateType can be declared, depending on the activity-status of the iati-activity

  <activity-date iso-date="2012-04-15" type="start-planned" />
  <activity-date iso-date="2012-04-28" type="start-actual" />
  <activity-date iso-date="2015-12-31" type="end-planned" />

Note: In all cases, a start-actual or end-actual with a date in the future, is not expected.

Developer tools

Find the source of this documentation on github:

Last updated on 2015-10-16