You are viewing VERSION 2.01 of IATI Standard Reference View another version

activity-date

iati-activities/iati-activity/activity-date

This is the reference page for the XML element activity-date.

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.

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

Rules

This element must occur at least once (within each parent element).

6.11.1: The activity must have a planned start date or an actual start date.

Attributes

@type

An IATI code defining the type of activity date being reported.

This attribute is required.

This value must be of type xsd:string.

This value must be on the ActivityDateType codelist.

@iso-date

This attribute is required.

This value must be of type xsd:date.

11.1.2: The planned start date of the activity must be before the planned end date.

11.1.3: The actual start date of the activity must be before the actual end date.

11.1.4: The actual start date of the activity must not be in the future.

11.1.5: The actual end date of the activity must not be in the future.

Example Usage

Example activity-date for an``iati-activity``.

The @type attribute declares a valid code (1) from the ActivityDateType codelist.

An example date is declared in the @iso-date attribute.

Example date format conforms to the xsd:date standard - for most cases YYYY-MM-DD is sufficient.

<activity-date iso-date="2012-04-28" type="1" />

The activity-date element can be repeated in any iati-activity.

In this example four activity-date are declared.

  <activity-date iso-date="2012-04-15" type="1">
   <narrative>Planned start date of the activity</narrative>
   <narrative xml:lang="fr">Date prévue de début de l'activité</narrative>   
  </activity-date> 
  <activity-date iso-date="2012-04-28" type="2" />
  <activity-date iso-date="2015-12-31" type="3" />

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

Note: All instances of the ActivityDateType code 2 & 4 (actual dates) are not expected to be in the future.

Changelog

2.01

Freetext is no longer allowed with this element. It should now be declared with the new child narrative element.

The ActivityDateType codelist was changed to numeric codes

Developer tools

Find the source of this documentation on github:

Subelements