period-start ============ ``iati-activities/iati-activity/planned-disbursement/period-start`` This is the reference page for the XML element ``period-start``. .. index:: single: period-start Definition ~~~~~~~~~~ The exact date of the planned disbursement OR the starting date of the period in which this specific disbursement will be made. Rules ~~~~~ This element must occur once and only once (within each parent element). Attributes ~~~~~~~~~~ .. _iati-activities/iati-activity/planned-disbursement/period-start/.iso-date: @iso-date This attribute is required. This value must be of type xsd:date. ``period-start/@iso-date`` must be before or the same as ``period-end/@iso-date`` Usage in practice ~~~~~~~~~~~~~~~~~ The ``period start`` should define when the actual transfer of funds will take place, if a specific date is known. If the specific payment date is not known, the period in which the transfer is due to take place should be described by using both ``period-start`` and ``period-end`` dates. The timeframe between ``period-start`` and ``period-end`` should not normally exceed 3 calendar months. Example Usage ~~~~~~~~~~~~~ Example usage of ``period-start`` of ``planned-disbursement`` for an ``iati-activity``. | An example date is declared in the ``@iso-date`` attribute. | This example date format conform to the *xsd:date* standard - for most cases *YYYY-MM-DD* is sufficient. .. literalinclude:: ../../../activity-standard-example-annotated.xml :language: xml :start-after: :end-before: Changelog ~~~~~~~~~ 2.02 ^^^^ The definition of this element was amended for clarity. Developer tools ~~~~~~~~~~~~~~~ Find the source of this documentation on github: * `Schema `_ * `Extra Documentation `_