Zeit & Zeitreihe: Unterschied zwischen den Versionen

Aus Asprova Hilfe
Wechseln zu: Navigation, Suche
K (GK verschob die Seite Zeitfolgen-Zeit nach Zeit & Zeitreihe)
(Überarbeitung und Ergänzung um neue Funktionen)
Zeile 1: Zeile 1:
{{DISPLAYTITLE:Zeitfolgen-Zeit}}
+
{{DISPLAYTITLE:Zeit & Zeitreihe}}
 
<div align="right">Hilfe Nummer: 741530</div>
 
<div align="right">Hilfe Nummer: 741530</div>
<div align="right">[[Interne Funktionen|Interne Funktionen]]</div>
+
<div align="right">[[Interne Funktionen]]</div>
<div align="right">[[Formeleditor|Formeldialog]]</div>
+
<div align="right">[[Formeleditor]]</div>
 
<hr>
 
<hr>
Interne Funktionen, bezogen auf Zeit
 
  
 +
Asprova stellt Ihnen die folgenden Funktionen zur Arbeit mit Zeiten und Zeitreihen zur Verfügung.
  
Now()
+
== Now( ) ==
 
+
{| class="wikitable"
Parameter
+
|-
 
+
!Parameter
 
+
| ||''keiner''
{|
+
|-
 +
!Rückgabewert
 +
|colspan="2"|Die aktuelle Systemzeit.
 
|-
 
|-
|   ||Keine||  || 
+
!Beispiel
 +
|<code>Now()</code>||2020/06/27 10:30:00
 
|-
 
|-
 
|}
 
|}
  
Rückgabewert
+
== Periodenbeginn & -ende ==
 +
Bei allen folgenden Formeln zum Periodenbeginn ist die Uhrzeit des Rückgabewerts die [Tagestrennzeit] des Projekts. Bei den Formeln zum Periodenende ist die Uhrzeit des Rückgabewerts eine Sekunde vor der [Tagestrennzeit] des Projekts.
  
 
+
{| class="wikitable"
{|
+
|-
 +
|+ Beispiele
 +
|-
 +
|colspan="2"|''Angenommen wird die [Tagestrennzeit] 08:00:00.''
 +
|-
 +
|<code>StartOfNextDay(#2020/4/2#,1)</code>||2020/04/03 08:00:00
 
|-
 
|-
|   ||Gibt das aktuelle Datum des Computers aus.|| 
+
|<code>EndOfNextDay(#2020/4/2#,1)</code>||2020/04/04 07:59:59
 
|-
 
|-
 
|}
 
|}
  
Beispiel
+
Für alle folgenden Beispiele wird die [Tagestrennzeit] 00:00:00 angenommen.
  
 
+
=== StartOfNextDay( time, day ) ===
{|
+
{| class="wikitable"
 +
|-
 +
!rowspan="2"|Parameter
 +
|''time''||colspan="2"|Basiszeit
 +
|-
 +
|''day''||colspan="2"|Integer, Versatztage
 +
|-
 +
!Rückgabewert
 +
|colspan="3"|Beginn des Tages ''day'' Tage nach dem Tag in dem ''time'' liegt.
 +
|-
 +
!rowspan="3"|Beispiele
 +
|<code>StartOfNextDay(#2020/4/2#,1)</code>||2020/04/03 00:00:00||Beginn des nächsten Tages
 +
|-
 +
|<code>StartOfNextDay(#2020/4/2#,0)</code>||2020/04/02 00:00:00||Beginn des Tages
 
|-
 
|-
|   ||Now() -> #2017/06/27 10:30:00#||  
+
|<code>StartOfNextDay(#2020/4/2#,-1)</code>||2020/04/01 00:00:00||Beginn des vorherigen Tages
 
|-
 
|-
 
|}
 
|}
  
 
+
=== StartOfNextWeek( time, week ) ===
StartOfNextDay( Zeit, Tag )
+
{| class="wikitable"
 
 
Parameter
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||Zeit||Basiszeit|| 
+
!rowspan="2"|Parameter
 +
|''time''||colspan="2"|Basiszeit
 
|-
 
|-
||   ||Tag||Ganze Zahl Hinzugefügte Tage
+
|''week''||colspan="2"|Integer, Versatzwochen
 
|-
 
|-
|}
+
!Rückgabewert
 
+
|colspan="3"|Beginn der Woche (Montag) ''week'' Wochen nach der Woche in der ''time'' liegt.
Rückgabewert
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||Gibt die Startzeit (nach Hinzufügen der Tage), basierend auf der Zeit, aus.||  
+
!rowspan="3"|Beispiele
 +
|<code>StartOfNextWeek(#2020/4/2#,1)</code>||2020/04/06 00:00:00||Beginn der nächsten Woche
 
|-
 
|-
|}
+
|<code>StartOfNextWeek(#2020/4/2#,0)</code>||2020/03/30 00:00:00||Beginn der Woche
 
 
Beispiel
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||StartOfNextDay(#2017/4/2#,1) -> #2017/4/3 00:00:00#  Startzeit am nächsten Tag.<br />StartOfNextDay(#2017/4/2#,0) -> #2017/4/2 00:00:00#  Startzeit von Heute.<br />StartOfNextDay(#2017/4/2#,-1) -> #2017/4/1 00:00:00#  Startzeit von Gestern.<br /><br />Wenn die "Tagestrennzeit" (in den Projekteinstellungen) auf 08:00:00 gestellt ist, ist die Startzeit gleich der "Tagestrennzeit".<br />StartOfNextDay(#2017/4/2#,1) -> #2017/4/3 08:00:00#||  
+
|<code>StartOfNextWeek(#2020/4/2#,-1)</code>||2020/03/23 00:00:00||Beginn der vorherigen Woche
 
|-
 
|-
 
|}
 
|}
  
 
+
=== StartOfNextMonth( time, month ) ===
StartOfNextWeek( time, week )
+
{| class="wikitable"
 
 
Parameter
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||Zeit||Basiszeit|| 
+
!rowspan="2"|Parameter
 +
|''time''||colspan="2"|Basiszeit
 
|-
 
|-
||   ||Woche||Ganze Zahl. Hinzugfügte Woche.
+
|''month''||colspan="2"|Integer, Versatzmonate
 
|-
 
|-
|}
+
!Rückgabewert
 
+
|colspan="3"|Beginn des Monats ''month'' Monate nach dem Monat in dem ''time'' liegt.
Rückgabewert
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||Gibt die Startzeit (Montag) (nach Hinzufügen der Wochen), basierend auf der Zeit, aus.||  
+
!rowspan="3"|Beispiele
 +
|<code>StartOfNextMonth(#2020/4/2#,1)</code>||2020/05/01 00:00:00||Beginn des nächsten Monats
 
|-
 
|-
|}
+
|<code>StartOfNextMonth(#2020/4/2#,0)</code>||2020/04/01 00:00:00||Beginn des Monats
 
 
Beispiel
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||StartOfNextWeek(#2017/4/2#,1) -> #2017/4/4 00:00:00#  Startzeit der Woche.<br />StartOfNextWeek(#2017/4/2#,0) -> #2017/3/28 00:00:00#  Startzeit dieser Woche.<br />StartOfNextWeek(#2017/4/2#,-1) -> #2017/3/21 00:00:00#  Startzeit der letzten Woche.<br /><br />Wenn die "Tragestrennzeit" (in den Projekteinstellungen) 08:00:00 ist, ist die Startzeit gleich die "Tagestrennzeit":<br />StartOfNextWeek(#2017/4/2#,1) -> #2017/4/4 08:00:00#||  
+
|<code>StartOfNextMonth(#2020/4/2#,-1)</code>||2020/03/01 00:00:00||Beginn des vorherigen Monats
 
|-
 
|-
 
|}
 
|}
  
 
+
=== EndOfNextDay( time, day ) ===
StartOfNextMonth( Zeit, Monat )
+
{| class="wikitable"
 
 
Parameter
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||Zeit||Basiszeit|| 
+
!rowspan="2"|Parameter
 +
|''time''||colspan="2"|Basiszeit
 
|-
 
|-
||   ||Monat||Ganze Zahl Hinzugefügte Monate
+
|''day''||colspan="2"|Integer, Versatztage
 
|-
 
|-
|}
+
!Rückgabewert
 
+
|colspan="3"|Ende des Tages ''day'' Tage nach dem Tag in dem ''time'' liegt.
Rückgabewert
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||Gibt die Startzeit (Sonntag) (nach Hinzufügen der Monate), basierend auf der Zeit, aus.||  
+
!rowspan="3"|Beispiele
 +
|<code>EndOfNextDay(#2020/4/2#,1)</code>||2020/04/03 23:59:59||Ende des nächsten Tages
 
|-
 
|-
|}
+
|<code>EndOfNextDay(#2020/4/2#,0)</code>||2020/04/02 23:59:59||Ende des Tages
 
 
Beispiel
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||StartOfNextMonth(#2017/4/10#,1) -> #2017/5/1 00:00:00#  Startzeit des nächsten Monats.<br />StartOfNextMonth(#2017/4/10#,0) -> #2017/4/1 00:00:00#  Startzeit diesen Monats.<br />StartOfNextMonth(#2017/4/10#,-1) -> #2017/3/1 00:00:00#  Startzeit letzten Monats.<br /><br />Wenn die "Tragestrennzeit" (in den Projekteinstellungen) 08:00:00 ist, ist die Startzeit gleich die "Tagestrennzeit".<br />StartOfNextMonth(#2017/4/10#,1) -> #2017/5/1 08:00:00#||  
+
|<code>EndOfNextDay(#2020/4/2#,-1)</code>||2020/04/01 23:59:59||Ende des vorherigen Tages
 
|-
 
|-
 
|}
 
|}
  
 
+
=== EndOfNextWeek( time, week ) ===
EndOfNextDay( Zeit, Tag )
+
{| class="wikitable"
 
 
Parameter
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||Zeit||Basiszeit|| 
+
!rowspan="2"|Parameter
 +
|''time''||colspan="2"|Basiszeit
 
|-
 
|-
||   ||Tag||Ganze Zahl. Hinzugfügte Tage.
+
|''week''||colspan="2"|Integer, Versatzwochen
 
|-
 
|-
|}
+
!Rückgabewert
 
+
|colspan="3"|Ende der Woche (Montag) ''week'' Wochen nach der Woche in der ''time'' liegt.
Rückgabewert
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||Gibt die Endzeit (nach hinzugefügten Tagen), basierend auf der Zeit, aus.||  
+
!rowspan="3"|Beispiele
 +
|<code>EndOfNextWeek(#2020/4/2#,1)</code>||2020/04/12 23:59:59||Ende der nächsten Woche
 
|-
 
|-
|}
+
|<code>EndOfNextWeek(#2020/4/2#,0)</code>||2020/03/05 23:59:59||Ende der Woche
 
 
Beispiel
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||EndOfNextDay(#2017/4/2#,1) -> #2017/4/3 23:59:59#  Endzeit am nächsten Tag.<br />EndOfNextDay(#2017/4/2#,0) -> #2017/4/2 23:59:59#  Endzeit von Heute.<br />EndOfNextDay(#2017/4/2#,-1) -> #2017/4/1 23:59:59#  Endzeit von Gestern.<br /><br />Wenn die "Tragestrennzeit" (in den Projekteinstellungen) 08:00:00 ist, ist die Startzeit gleich die "Tagestrennzeit".<br />EndOfNextDay(#2017/4/2#,1) -> #2017/4/4 07:59:59#  End time of tomorrow.||  
+
|<code>EndOfNextWeek(#2020/4/2#,-1)</code>||2020/03/29 23:59:59||Ende der vorherigen Woche
 
|-
 
|-
 
|}
 
|}
  
 
+
=== EndOfNextMonth( time, month ) ===
EndOfNextWeek( Zeit, Woche )
+
{| class="wikitable"
 
 
Parameter
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||Zeit||Basiszeit|| 
+
!rowspan="2"|Parameter
 +
|''time''||colspan="2"|Basiszeit
 
|-
 
|-
||   ||Woche||Ganze Zahl. Hinzugfügte Woche.
+
|''month''||colspan="2"|Integer, Versatzmonate
 
|-
 
|-
|}
+
!Rückgabewert
 
+
|colspan="3"|Ende des Monats ''month'' Monate nach dem Monat in dem ''time'' liegt.
Rückgabewert
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||Gibt die Endzeit (Sonntag) (nach Hinzufügen der Wochen), basierend auf der Zeit, aus.||  
+
!rowspan="3"|Beispiele
 +
|<code>EndOfNextMonth(#2020/4/2#,1)</code>||2020/05/31 23:59:59||Ende des nächsten Monats
 
|-
 
|-
|}
+
|<code>EndOfNextMonth(#2020/4/2#,0)</code>||2020/04/30 23:59:59||Ende des Monats
 
 
Beispiel
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||EndOfNextWeek(#2017/4/2#,1) -> #2017/04/10 23:59:59#  Endzeit der nächsten Woche.<br />EndOfNextWeek(#2017/4/2#,0) -> #2017/04/03 23:59:59#  Endzeit dieser Woche<br />EndOfNextWeek(#2017/4/2#,-1) -> #2017/03/27 23:59:59#  Endzeit der letzten Woche<br /><br />Wenn die "Tragestrennzeit" (in den Projekteinstellungen) 08:00:00 ist, ist die Startzeit gleich die "Tagestrennzeit".<br />EndOfNextDay(#2017/4/2#,1) -> #2017/04/11 07:59:59#  Endzeit der nächsten Woche.||  
+
|<code>EndOfNextMonth(#2020/4/2#,-1)</code>||2020/03/31 23:59:59||Ende des vorherigen Monats
 
|-
 
|-
 
|}
 
|}
  
 +
== Benachbarte Nutzungsanweisungen ==
 +
; Hinweis
 +
: Erfordert mindestens Asprova Version 12.1.
  
EndOfNextMonth( Zeit, Monat )
+
=== GetNearestUseInstOfDiffWork_Left( resource, time, operation, flag ) ===
 
+
{| class="wikitable"
Parameter
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||Zeit||Basiszeit|| 
+
!rowspan="4"|Parameter
 +
|''resource''||Ressourcenobjekt
 
|-
 
|-
||   ||Monat||Ganze Zahl. Hinzugfügte Monate.
+
|''time''||Basiszeit
 
|-
 
|-
|}
+
|''operation''||Auszuschließender Vorgang
 
 
Rückgabewert
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||Gibt die Endzeit (nach hinzugefügten Monaten), basierend auf der Zeit, aus.|| 
+
|''flag''||0 für alle Aufgaben, 1 nur für Produktionsaufgaben
 
|-
 
|-
|}
+
!Rückgabewert
 
+
|colspan="2"|Gibt eine Liste der Nutzungsanweisungen aus [Nutzungsanweisungen in Beginnreihenfolge] von ''resource'' zurück, deren [Ende] am nächsten vor ''time'' liegt, auf die ''flag'' zutrifft, und deren [Vorgang] nicht ''operation'' ist.
Beispiel
 
 
 
 
 
{|
 
 
|-
 
|-
|   ||EndOfNextMonth(#2017/4/2#,1) -> #2017/05/31 23:59:59#  Endzeit des nächsten Monats.<br />EndOfNextMonth(#2017/4/2#,0) -> #2017/04/30 23:59:59#  Endzeit diesen Monats.<br />EndOfNextMonth(#2017/4/2#,-1) -> #2017/03/31 23:59:59#  Endzeit letzten Monats<br /><br />Wenn die "Tagestrennzeit" (in den Projekteinstellugen) auf 08:00:00 gestellt ist, dann ist die Endzeit um 08:00:00.<br />EndOfNextMonth(#2017/4/2#,1) -> #2017/06/01 07:59:59#  Endzeit des Monats.||  
+
!Beispiel
 +
|colspan="2"|
 
|-
 
|-
 
|}
 
|}

Version vom 8. Januar 2019, 16:22 Uhr

Hilfe Nummer: 741530
Interne Funktionen
Formeleditor

Asprova stellt Ihnen die folgenden Funktionen zur Arbeit mit Zeiten und Zeitreihen zur Verfügung.

Now( )

Parameter keiner
Rückgabewert Die aktuelle Systemzeit.
Beispiel Now() 2020/06/27 10:30:00

Periodenbeginn & -ende

Bei allen folgenden Formeln zum Periodenbeginn ist die Uhrzeit des Rückgabewerts die [Tagestrennzeit] des Projekts. Bei den Formeln zum Periodenende ist die Uhrzeit des Rückgabewerts eine Sekunde vor der [Tagestrennzeit] des Projekts.

Beispiele
Angenommen wird die [Tagestrennzeit] 08:00:00.
StartOfNextDay(#2020/4/2#,1) 2020/04/03 08:00:00
EndOfNextDay(#2020/4/2#,1) 2020/04/04 07:59:59

Für alle folgenden Beispiele wird die [Tagestrennzeit] 00:00:00 angenommen.

StartOfNextDay( time, day )

Parameter time Basiszeit
day Integer, Versatztage
Rückgabewert Beginn des Tages day Tage nach dem Tag in dem time liegt.
Beispiele StartOfNextDay(#2020/4/2#,1) 2020/04/03 00:00:00 Beginn des nächsten Tages
StartOfNextDay(#2020/4/2#,0) 2020/04/02 00:00:00 Beginn des Tages
StartOfNextDay(#2020/4/2#,-1) 2020/04/01 00:00:00 Beginn des vorherigen Tages

StartOfNextWeek( time, week )

Parameter time Basiszeit
week Integer, Versatzwochen
Rückgabewert Beginn der Woche (Montag) week Wochen nach der Woche in der time liegt.
Beispiele StartOfNextWeek(#2020/4/2#,1) 2020/04/06 00:00:00 Beginn der nächsten Woche
StartOfNextWeek(#2020/4/2#,0) 2020/03/30 00:00:00 Beginn der Woche
StartOfNextWeek(#2020/4/2#,-1) 2020/03/23 00:00:00 Beginn der vorherigen Woche

StartOfNextMonth( time, month )

Parameter time Basiszeit
month Integer, Versatzmonate
Rückgabewert Beginn des Monats month Monate nach dem Monat in dem time liegt.
Beispiele StartOfNextMonth(#2020/4/2#,1) 2020/05/01 00:00:00 Beginn des nächsten Monats
StartOfNextMonth(#2020/4/2#,0) 2020/04/01 00:00:00 Beginn des Monats
StartOfNextMonth(#2020/4/2#,-1) 2020/03/01 00:00:00 Beginn des vorherigen Monats

EndOfNextDay( time, day )

Parameter time Basiszeit
day Integer, Versatztage
Rückgabewert Ende des Tages day Tage nach dem Tag in dem time liegt.
Beispiele EndOfNextDay(#2020/4/2#,1) 2020/04/03 23:59:59 Ende des nächsten Tages
EndOfNextDay(#2020/4/2#,0) 2020/04/02 23:59:59 Ende des Tages
EndOfNextDay(#2020/4/2#,-1) 2020/04/01 23:59:59 Ende des vorherigen Tages

EndOfNextWeek( time, week )

Parameter time Basiszeit
week Integer, Versatzwochen
Rückgabewert Ende der Woche (Montag) week Wochen nach der Woche in der time liegt.
Beispiele EndOfNextWeek(#2020/4/2#,1) 2020/04/12 23:59:59 Ende der nächsten Woche
EndOfNextWeek(#2020/4/2#,0) 2020/03/05 23:59:59 Ende der Woche
EndOfNextWeek(#2020/4/2#,-1) 2020/03/29 23:59:59 Ende der vorherigen Woche

EndOfNextMonth( time, month )

Parameter time Basiszeit
month Integer, Versatzmonate
Rückgabewert Ende des Monats month Monate nach dem Monat in dem time liegt.
Beispiele EndOfNextMonth(#2020/4/2#,1) 2020/05/31 23:59:59 Ende des nächsten Monats
EndOfNextMonth(#2020/4/2#,0) 2020/04/30 23:59:59 Ende des Monats
EndOfNextMonth(#2020/4/2#,-1) 2020/03/31 23:59:59 Ende des vorherigen Monats

Benachbarte Nutzungsanweisungen

Hinweis
Erfordert mindestens Asprova Version 12.1.

GetNearestUseInstOfDiffWork_Left( resource, time, operation, flag )

Parameter resource Ressourcenobjekt
time Basiszeit
operation Auszuschließender Vorgang
flag 0 für alle Aufgaben, 1 nur für Produktionsaufgaben
Rückgabewert Gibt eine Liste der Nutzungsanweisungen aus [Nutzungsanweisungen in Beginnreihenfolge] von resource zurück, deren [Ende] am nächsten vor time liegt, auf die flag zutrifft, und deren [Vorgang] nicht operation ist.
Beispiel

Hilfe Nummer: 741530