» Startseite » Haupt-Referenz » Funktions-Referenz » alignTime()

alignTime()

Syntax:

Parameter:

Beschreibung:

Sind beide Parameter skalar, dann wird aus beiden Werten mitels time() eine Zeit berechnet. Anschließend werden beide Werte direkt verknüpft. Das Ergebnis ist ebenfalls numerisch.

Ist eines der beiden Parameter skalar und der andere eine Liste oder Map, dann wird der skalare Wert mit jedem Element der Liste bzw. Map, auch rekursiv, verknüpft. Das Funktionsergebnis ist dann eine Liste bzw. Map.

Sind beide Parameter eine Liste, dann werden die einzelnen Elemente verknüpft. Hieraus ergibt sich automatisch die Rekursion. Die Anzahl der Elemente in der Ergebnisliste entspricht die der kleineren Liste, d.h. die überzähligen Elemente der längeren Liste werden ignoriert. Das Funktionsergebnis ist dann eine Liste.

Sind beide Parameter eine Map, dann werden die einzelnen Elemente mit dem selben Schlüssel verknüpft. Hieraus ergibt sich automatisch die Rekursion. Elemente, die sich nur in einer Map befinden, werden ignoriert. Das Funktionsergebnis ist dann eine Map.

In allen anderen Fällen werden keine Berechnungen durchgeführt und das Funktionsergebnis ist NONE.

Die skalare Berechnung:

Für jedes Skalar-Paar aus min_time und max_time wird der best gerundete Zeitpunkt aus dem Intervall [min_time .. max_time] berechnet.

Liegt zwischen min_time und max_time eine Tagesgrenze, dann wird alignDate() zur Berechnung verwendet und die eigentliche Zeitangabe ist dann 0 Uhr.

Anderenfalls erfolgt die Berechnung auf Basis der Tageszeit, wobei Stunden- vor Minuten- vor Sekundengrenzen bevorzugt werden.

Bei den Stunden werden die Vielfachen der folgenden Werte bevorzugt verwendet (absteigende Priorität): 12,6,3,2
Bei den Minuen und Sekunden sind es die Werte: 30,15,10,5,2

Siehe auch:
 alignDate()   alignInterval()   alignNumber() 

Weitere ähnliche Funktionen: