==== HMS- ====
----
Subtracts times in hours / minutes / seconds format
----
^ __Input Stack__ ^^ ^ __Output Stack__ ^
| **Rtime-hms1** | **Rtime-hms2** | **→** | **Rtime-diff** |
| //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** | //None// ||
----
The ''HMS-'' command subtracts two values representing hours / minutes / seconds returning a value in the same format. The input is expressed by a real number in the format **HH.MMSS**, where:
* **HH** are the hours;
* **MM** are the minutes;
* **SS** are the seconds.
It is not mandatory that **MM** or **SS** are less than 60. In fact, they can be up to 99: in any case ''HMS-'' will compute the correct result. An useful consequence derives from this property: if **Rtime-hms2** is 0 ''HMS-'' can be used to normalize a time value so that both **MM** and **SS** are less than 60.
----
''HMS-'' is not fully equivalent to its **userRPL** counterpart.
In particular:
* in **userRPL** the time value can express fractions of seconds too; in **newRPL** it is not allowed.
----
**__Input__**
4:
3:
2: 12.5055
1: 4.302
…………………………………………………………………………………………………………
HMS-
\\
**__Output__**
4:
3:
2:
1: 8.2035.
…………………………………………………………………………………………………………
----
{{page>manual:chapter6:system&nofooter&noeditbtn&inline}}