Arbeitszeit: Unterschied zwischen den Versionen

Aus Asprova Hilfe
Wechseln zu: Navigation, Suche
K (→‎GetResourceQtyTime( resource, start, end ))
 
(8 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
 
{{DISPLAYTITLE:Arbeitszeit}}
 
{{DISPLAYTITLE:Arbeitszeit}}
 
<div align="right">Hilfe Nummer: 741540</div>
 
<div align="right">Hilfe Nummer: 741540</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>
−
Dies ist eine interne Funktion, die mit der Arbeitszeit verbunden ist.
 
  
 +
Asprova stellt Ihnen die folgenden Funktionen rund um Arbeitszeiten zur Verfügung.
  
−
AdvanceAlongResourceWorkingTime( Ressource, Zeit, Zeitspanne )
+
== AdvanceAlongResourceWorkingTime( resouce, time, timeSpan ) ==
−
 
+
{| class="wikitable"
−
Parameter
+
|-
−
 
+
!rowspan="3"|Parameter
−
 
+
|''resource''||Ressource
−
{|
+
|-
 +
|''time''||Basiszeit
 +
|-
 +
|''timeSpan''||Zeitspanne
 +
|-
 +
!Rückgabewert
 +
|colspan="2"|Gibt den Zeitpunkt ''timeSpan'' nach ''time'' zurück, wobei nur die Arbeitszeiten auf ''resource'' berücksichtigt werden.
 
|-
 
|-
−
|   ||Ressource||Ressourcen Objekt|| 
+
!rowspan="2"|Beispiele
 +
|<code>AdvanceAlongResourceWorkingTime(ME.Resource,#2020/06/01 00:00:00#,24h)</code>||02/06/2020 21:00
 
|-
 
|-
−
||   ||Zeit||Basiszeit
+
|colspan="2"|[[Image:incodefunc-kadoujikan01.png]]<br><code>ME</code> ist hier "Mischer 1".
 
|-
 
|-
−
||   ||Zeitspanne||Vorlaufzeit
+
!Hinweis
 +
|colspan="2"|Hat ''timeSpan'' einen negativen Wert, so liegt der Rückgabewert vor ''time''.
 
|-
 
|-
 
|}
 
|}
  
−
Rückgabewert
+
== GetResourceQtyTime( resource, start, end ) ==
−
 
+
{| class="wikitable"
−
 
+
|-
−
{|
+
!rowspan="3"|Parameter
 +
|width="1px"|''resource''||Ressource
 +
|-
 +
|''start''||Beginn
 +
|-
 +
|''end''||Ende
 
|-
 
|-
−
|   ||Gibt die Zeit nach der Zeitspanne von der Basiszeit, zusammen mit der Ressorucenarbeitszeit, aus.|| 
+
!Rückgabewert
 +
|colspan="2"|Gibt die Ressourcenanzahlzeit (Ressourcenzeit * Ressourcenanzahl) von ''resource'' zwischen ''start'' und ''end'' zurück.
 
|-
 
|-
−
|}
+
!rowspan="2"|Beispiel
−
 
+
|<span style="white-space: nowrap;"><code>GetResourceQtyTime(ME,#2020/06/04 00:00#,#2020/06/09 00:00#)</code></span>||172800
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||AdvanceAlongResourceWorkingTime(ME,#2008/06/09 00:00:00#,24h) -> #2008/06/10 21:00:00#<br /><br />ME ist Mischer1. Gibt die Zeit nach 24 Stunden von 2008/06/09 00:00:00, zusammen mit der Arbeitszeit von Mischer1, aus.|| 
+
|colspan="2"|[[Image:GetResourceQtyTime01.png]]<br><code>ME</code> ist hier "Mischer 1". 1*12h + 2*12h + 1*12h = 172800 (≈2d)
 
|-
 
|-
 
|}
 
|}
  
−
 
+
== GetWorkingDays ( start, end, resource, minTime ) ==
−
[[Image:incodefunc-kadoujikan01.jpg]]
+
{| class="wikitable"
−
 
 
−
Hinweise
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Stellt das zweite Argument einen negativen Wert dar, wird ein Zeitpunkt in der Vergangenheit ausgegeben.||  
+
!rowspan="4"|Parameter
 +
|width="1px"|''start''||Beginn
 
|-
 
|-
−
|}
+
|''end''||Ende
−
 
 
−
 
 
−
&nbsp;
 
−
 
 
−
GetResourceQtyTime( Ressrouce, Start, Ende )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Ressoruce||Ressourcen Objekt|| 
+
|''resource''||Ressource
 
|-
 
|-
−
||   ||Start||Berechnete Startzeit
+
|''minTime''||Minimale Arbeitszeit in einem Arbeitstag
 
|-
 
|-
−
||   ||Ende||Berechnete Endzeit
+
!Rückgabewert
 +
|colspan="2"|Gibt die Anzahl an Arbeitszeitperioden auf ''resource'' zwischen ''start'' und ''end'' an, die mindestens ''minTime'' lang sind. Arbeitszeitperioden werden dabei mitternachts automatisch als unterbrochen angesehen.
 
|-
 
|-
−
|}
+
!rowspan="4"|Beispiele
−
 
+
|<span style="white-space: nowrap;"><code>GetWorkingDays(#2008/06/09&#160;00:00#,#2008/06/11&#160;00:00#,ME,5h)</code></span>||2
−
Rückgabewert
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Gibt die benötigte Ressorucenzeit (Arbeitszeit * Ressourcenmenge), abhängig von berechneter Start- und Endzeit, aus.|| 
+
|colspan="2"|[[Image:incodefunc-kadoujikan02.png]]<br><code>ME</code> ist hier "Mischer 1".
 
|-
 
|-
−
|}
+
|<code>GetWorkingDays(#2008/06/09&#160;00:00#,#2008/06/11&#160;00:00#,ME,4h)</code>||4
−
 
 
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||GetResourceQtyTime(ME,#2009/06/04 00:00:00#,#2009/06/09 00:00:00#) -> 172800<br /><br />ME ist [Mischer1]. Gibt die Ressourcenzeit zwischen 2009/06/04 00:00:00 und 2009/06/09 00:00:00 aus.<br />Rückgabewert ist 12H*1 + 12H*2 + 12H*1 = 172800S (48H).||
+
|colspan="2"|[[Image:incodefunc-kadoujikan03.png]]
 
|-
 
|-
 
|}
 
|}
  
−
 
+
== GetWorkingTime( start, end, resource ) ==
−
[[Image:GetResourceQtyTime01.jpg]]
+
{| class="wikitable"
−
 
+
|-
−
 
+
!rowspan="3"|Parameter
−
{|
+
|''start''||Beginn
 
|-
 
|-
−
|   ||Ist die Funktioen GetWorkingTime in Gebrauch, wird die Ressorucenzeit nicht berechnet. Ausgegeben wird 12H * 3 = 129600S (36H).|| 
+
|''end''||Ende
 
|-
 
|-
−
|}
+
|''resource''||Ressource
−
 
 
−
 
 
−
&nbsp;
 
−
 
 
−
GetWorkingDays ( Start, Ende, Ressoruce, MinZeit )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Start||Berechnete Startzeit|| 
+
!Rückgabewert
 +
|colspan="2"|Gibt die Arbeitszeit von ''resource'' zwischen ''start'' und ''end'' zurück.
 
|-
 
|-
−
||   ||Ende||Berechnete Endzeit
+
!rowspan="2"|Beispiele
 +
|<code>GetWorkingTime(#2008/06/09 00:00:00#,#2008/06/11 00:00:00#,ME)</code>||2d
 
|-
 
|-
−
||   ||Ressoruce||Ressourcen Objekt
+
|colspan="2"|[[Image:incodefunc-kadoujikan04.png]]<br><code>ME</code> ist hier "Mischer 1".
 
|-
 
|-
−
||   ||MinZeit||Minimale Arbeitszeit ist für die Buchhaltung essentiell.
+
!Hinweis|
 +
|colspan="2"|Anders als bei [[#GetResourceQtyTime( resource, start, end )|GetResourceQtyTime()]] wird die Ressourcenanzahl ''nicht'' berücksichtigt.
 
|-
 
|-
 
|}
 
|}
  
−
Rückgabewert
+
== GetCalendar( res, time ) ==
−
 
+
{| class="wikitable"
−
 
+
|-
−
{|
+
!rowspan="2"|Parameter
 +
|width="1px"|''res''||Ressource
 +
|-
 +
|''time''||Zeit
 +
|-
 +
!Rückgabewert
 +
|colspan="2"|Gibt das Kalenderobjekt zurück, das auf ''resource'' für den Zeitpunkt ''time'' angewendet wird.
 +
|-
 +
!rowspan="2"|Beispiele
 +
|colspan="2"|<code>GetCalendar(ME.Resource,ME.StartTime)</code>
 
|-
 
|-
−
|   ||Gibt aus, wie viele Male länger die Zeitperiode ist, als die Minimum Arbeitszeit (von Startzeit bis Endzeit der Ressource).|| 
+
|colspan="2"|
 +
[[Image:getcalendar_01.png]]
 +
{| class="wikitable
 
|-
 
|-
−
|}
+
|+ Kalendertabelle
−
 
 
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||GetWorkingDays(#2008/06/09 00:00:00#,#2008/06/11 00:00:00#,ME,5h) -> 2<br /><br />ME ist Mischer1. Da es zwei Zeitperioden gibt, die länger als 5 Stunden sind (vom 2008/06/09 00:00:00 bis 2008/06/11 00:00:00), wird 2 ausgegeben.|| 
+
!style="background: #3C78AE; color:white;"|Ressource
 +
!style="background: #3C78AE; color:white;"|Darum oder<br>Wochentag
 +
!style="background: #3C78AE; color:white;"|Schicht-<br>code
 +
!style="background: #3C78AE; color:white;"|Reihen-<br>folge
 +
!style="background: #3C78AE; color:white;"|Ressourcen<br>anzahl
 +
!Vorgänge
 +
|- style="background: white"
 +
|*||Mo-Fr||Tagesschicht||align="right"|10||align="right" style="color: #4B8050;"|1||style="background:#EBEBEB"|02:10
 +
|- style="background: #DFEBF4;"
 +
|Mischer 1||02/06/2020||Tagesschicht 2||align="right"|30||align="right" style="color: #4B8050;"|1||style="background:#EBEBEB"|03:10
 +
|- style="background: white"
 +
|Mischer 1||03/06/2020||Nacht 1;Nacht 2||align="right"|30||align="right"|2||style="background:#EBEBEB"|04:10, 05:10
 
|-
 
|-
 
|}
 
|}
−
 
+
<code>ME</code> ist hier "Mischer 1".
−
 
 
−
[[Image:incodefunc-kadoujikan02.jpg]]
 
−
 
 
−
 
 
−
{|
 
−
|-
 
−
|  ||GetWorkingDays(#2008/06/09 00:00:00#,#2008/06/11 00:00:00#,ME,5h) -> 2<br /><br />ME ist Mischer1. Da es vier Zeitperioden gibt, die länger als 4 Stunden sind (vom 2008/06/09 00:00:00 bis 2008/06/11 00:00:00), wird 4 ausgegeben.|| 
 
 
|-
 
|-
 
|}
 
|}
  
−
 
+
== GetShiftList( res, time, includeStart, includeEnd ) ==
−
[[Image:incodefunc-kadoujikan03.jpg]]
+
{| class="wikitable"
−
&nbsp;
+
|-
−
 
+
!rowspan="4"|Parameter
−
GetWorkingTime( Start, Ende, Ressoruce )
+
|width="1px"|''res''||Ressource
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Start||Berechnete Startzeit|| 
+
|''time''||Zeit
 
|-
 
|-
−
||   ||Ende||Berechnete Endzeit
+
|''includeStart''||Definiert ob Schichten eingeschlossen werden, die genau zu ''time'' beginnen.
 
|-
 
|-
−
||   ||Ressoruce||Ressourcen Objekt
+
|''includeEnd''||Definiert ob Schichten eingeschlossen werden, die genau zu ''time'' enden.
 
|-
 
|-
−
|}
+
!Rückgabewert
−
 
+
|colspan="2"|Gibt die Schichtobjekte zurück, die zu ''time'' auf ''resource'' angewendet werden. Über ''includeStart'' und ''includeEnd'' wird definiert, ob Schichten mit einbezogen werden, die genau um ''time'' beginnen oder enden. Bei TRUE werden diese einbezogen, bei FALSE nicht.
−
Rückgabewert
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Gibt die gesamte Arbeitszeit einer bestimmten Ressource von Start bis Ende aus.|| 
+
!rowspan="2"|Beispiele
 +
|colspan="2"|<code>GetShiftList(ME.Resource,ME.StartTime,TRUE,TRUE)</code>
 
|-
 
|-
−
|}
+
|colspan="2"|[[Image:Getshift_01.png]]<br><code>ME</code> ist hier "Mischer 1".
−
 
 
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||GetWorkingTime(#2008/06/09 00:00:00#,#2008/06/11 00:00:00#,ME) -> 1440M<br /><br />ME ist Mischer1. Gibt 1440 Minuten Arbeitszeit für Mischer1 im Zeitraum von 2008/06/09 00:00:00 bis 2008/06/11 00:00:00 aus.|| 
+
!Hinweise|
 +
|colspan="2"|
 +
* Schichten sind nach deren Beginn sortiert.
 +
* Es wird angenommen, dass die Zeiten in [Arbeitszeiten] der Schichten zwischen 00:00 und 48:0 liegen.
 +
* Liegt ''time'' in einer arbeitsfreien Zeit und der Tag ist ein Feiertag, so wird die Feiertagsschicht zurückgegeben.
 
|-
 
|-
 
|}
 
|}
−
 
−
 
−
[[Image:incodefunc-kadoujikan04.jpg]]
 
−
 
  
 
<hr>
 
<hr>
 
<div align="right">Hilfe Nummer: 741540</div>
 
<div align="right">Hilfe Nummer: 741540</div>

Aktuelle Version vom 15. Januar 2019, 15:35 Uhr

Hilfe Nummer: 741540
Interne Funktionen
Formeleditor

Asprova stellt Ihnen die folgenden Funktionen rund um Arbeitszeiten zur Verfügung.

AdvanceAlongResourceWorkingTime( resouce, time, timeSpan )

Parameter resource Ressource
time Basiszeit
timeSpan Zeitspanne
Rückgabewert Gibt den Zeitpunkt timeSpan nach time zurück, wobei nur die Arbeitszeiten auf resource berücksichtigt werden.
Beispiele AdvanceAlongResourceWorkingTime(ME.Resource,#2020/06/01 00:00:00#,24h) 02/06/2020 21:00
Incodefunc-kadoujikan01.png
ME ist hier "Mischer 1".
Hinweis Hat timeSpan einen negativen Wert, so liegt der Rückgabewert vor time.

GetResourceQtyTime( resource, start, end )

Parameter resource Ressource
start Beginn
end Ende
Rückgabewert Gibt die Ressourcenanzahlzeit (Ressourcenzeit * Ressourcenanzahl) von resource zwischen start und end zurück.
Beispiel GetResourceQtyTime(ME,#2020/06/04 00:00#,#2020/06/09 00:00#) 172800
GetResourceQtyTime01.png
ME ist hier "Mischer 1". 1*12h + 2*12h + 1*12h = 172800 (≈2d)

GetWorkingDays ( start, end, resource, minTime )

Parameter start Beginn
end Ende
resource Ressource
minTime Minimale Arbeitszeit in einem Arbeitstag
Rückgabewert Gibt die Anzahl an Arbeitszeitperioden auf resource zwischen start und end an, die mindestens minTime lang sind. Arbeitszeitperioden werden dabei mitternachts automatisch als unterbrochen angesehen.
Beispiele GetWorkingDays(#2008/06/09 00:00#,#2008/06/11 00:00#,ME,5h) 2
Incodefunc-kadoujikan02.png
ME ist hier "Mischer 1".
GetWorkingDays(#2008/06/09 00:00#,#2008/06/11 00:00#,ME,4h) 4
Incodefunc-kadoujikan03.png

GetWorkingTime( start, end, resource )

Parameter start Beginn
end Ende
resource Ressource
Rückgabewert Gibt die Arbeitszeit von resource zwischen start und end zurück.
Beispiele GetWorkingTime(#2008/06/09 00:00:00#,#2008/06/11 00:00:00#,ME) 2d
Incodefunc-kadoujikan04.png
ME ist hier "Mischer 1".
Anders als bei GetResourceQtyTime() wird die Ressourcenanzahl nicht berücksichtigt.

GetCalendar( res, time )

Parameter res Ressource
time Zeit
Rückgabewert Gibt das Kalenderobjekt zurück, das auf resource für den Zeitpunkt time angewendet wird.
Beispiele GetCalendar(ME.Resource,ME.StartTime)

Getcalendar 01.png

Kalendertabelle
Ressource Darum oder
Wochentag 		Schicht-
code 		Reihen-
folge 		Ressourcen
anzahl 		Vorgänge
* Mo-Fr Tagesschicht 10 1 02:10
Mischer 1 02/06/2020 Tagesschicht 2 30 1 03:10
Mischer 1 03/06/2020 Nacht 1;Nacht 2 30 2 04:10, 05:10

ME ist hier "Mischer 1".

GetShiftList( res, time, includeStart, includeEnd )

Parameter res Ressource
time Zeit
includeStart Definiert ob Schichten eingeschlossen werden, die genau zu time beginnen.
includeEnd Definiert ob Schichten eingeschlossen werden, die genau zu time enden.
Rückgabewert Gibt die Schichtobjekte zurück, die zu time auf resource angewendet werden. Über includeStart und includeEnd wird definiert, ob Schichten mit einbezogen werden, die genau um time beginnen oder enden. Bei TRUE werden diese einbezogen, bei FALSE nicht.
Beispiele GetShiftList(ME.Resource,ME.StartTime,TRUE,TRUE)
Getshift 01.png
ME ist hier "Mischer 1".
  • Schichten sind nach deren Beginn sortiert.
  • Es wird angenommen, dass die Zeiten in [Arbeitszeiten] der Schichten zwischen 00:00 und 48:0 liegen.
  • Liegt time in einer arbeitsfreien Zeit und der Tag ist ein Feiertag, so wird die Feiertagsschicht zurückgegeben.
Hilfe Nummer: 741540
Abgerufen von „http://hilfe.asprova.eu/index.php?title=Arbeitszeit&oldid=5946“