manual:chapter6:system:cmd_dateadd [newRPL User Manual]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
==== DATE+ ====
<callout type="primary" color="" icon="fa fa-book" title="Synopsis">
----
Add / subtract a number of days to a date
</callout>

<callout color="green" icon="fa fa-indent" title="Stack Diagram">
----
^  __Input Stack__  ^^  ^  __Output Stack__  ^
|  **R<sub>date</sub>**  |  **I<sub>days</sub>**  |  **→**  |  **R<sub>newdate</sub>**  |
|  //Level 2//  |  //Level 1//  |  //→//  |  //Level 1//  |

{{page>manual:chapter6:aux:legend&nofooter&noeditbtn&inline}}

| **Keyword type**  | [[manual:chapter5:basics#commands|Command]]  ||
| **Parallel list processing capabilities**  | [[manual:chapter5:listproc#group-6two-arguments-one-result-commands|Group 6]]  | //Two arguments, one result commands//  |
| **Affected by flags**  | [[manual:appendix:flags#flag-42|-42]]  | //Date format//  |














</callout>

<callout color="orangered" icon="fa fa-comment" title="Description">
----
The ''DATE+'' command returns a past or future date given a start date and a number of days; if this number is negative, ''DATE+'' calculates a past date. The date is expressed by a real number and its format depends on the state of flag [[manual:appendix:flags#flag-42|-42]]:

  * if the flag [[manual:appendix:flags#flag-42|-42]] is set the date is expressed as **DD.MMYYYY**;
  * if the flag [[manual:appendix:flags#flag-42|-42]] is cleared the date is expressed as **MM.DDYYYY**.

where:

  * **DD** is the day;
  * **MM** is the month;
  * **YYYY** is the year.

The range of allowable dates is **October 15, 1582** to **December 31, 9999**.
</callout>

<callout type="success" icon="true" title="Compatibility">
----
''DATE+'' is fully equivalent to its **userRPL** counterpart.
</callout>

<callout type="info" icon="true" title="Usage">
----
**__Input__**
<code>
4:                                      
3:                                      
2:                             10.081984
1:                                  -256
…………………………………………………………………………………………………………
-42 SF DATE+                            
</code>
\\
**__Output__**
<code>
4:                                      
3:                                      
2:                                      
1:                             28.111983
…………………………………………………………………………………………………………
                                        
</code>
</callout>

<callout color="darkgray" icon="fa fa-hand-o-right" title="Related Commands">
----
{{page>manual:chapter6:system&nofooter&noeditbtn&inline}}
</callout>