Umwandeln: Unterschied zwischen den Versionen

Aus Asprova Hilfe
Wechseln zu: Navigation, Suche
K (GK verschob die Seite Cast nach Umwandeln)
(Überarbeitung und Formatierung)
Zeile 1: Zeile 1:
−
{{DISPLAYTITLE:Cast}}
+
{{DISPLAYTITLE:Umwandeln}}
 
<div align="right">Hilfe Nummer: 741520</div>
 
<div align="right">Hilfe Nummer: 741520</div>
−
 
 
<div align="right">[[Interne Funktionen|Interne Funktion]]</div>
 
<div align="right">[[Interne Funktionen|Interne Funktion]]</div>
 
<div align="right">[[Formeleditor|Formeldialog]]</div>
 
<div align="right">[[Formeleditor|Formeldialog]]</div>
 
<hr>
 
<hr>
−
Interne Funktionen, die mit der Typwandlung verbunden sind.
 
  
−
<Besetzungsdatum/Zeit/Anzahl an String>
+
Asprova stellt Ihnen die folgenden Funktionen zur Umwandlung von Daten in andere Datentypen zur Verfügung.
  
−
 
+
== Datum, Zeit  oder Zahl in String umwandeln ==
−
Format( value, expr )
+
=== Format( value, expr) ===
−
 
+
{| class="wikitable"
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||value||Übersetze Daten/ Zeit/ Anzahl.|| 
+
!rowspan="2"|Argumente
 +
|''value''||colspan="2"|Zu formatierendes Datum/Zeit/Zahl
 
|-
 
|-
−
||   ||expr||Bestimmen Sie das String-format. Diese ist gleich des Formates der Funktion des VisualBasic-Formates.
+
|''expr''||colspan="2"|Struktur des Rückgabewerts
 
|-
 
|-
−
|}
+
!Rückgabewert
−
 
+
|colspan="3"|Gibt ''value'' entsprechend den Vorgaben in ''expr'' formatiert zurück.
−
Rückgabewert
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Formatwert basierend auf festgelegter Formatstring-Formel.||  
+
!rowspan="7"|Beispiele
 +
|<code>Format(ME.StartTime,'h:m:s')</code>||"5:4:23"||rowspan="4"|''<code>ME.StartTime</code> ist der 27.01.2020 17:14:23.''
 
|-
 
|-
−
|}
+
|<code>Format(ME.StartTime,'hh:mm:ss tt')</code>||"05:04:23 PM"
−
 
 
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Beispiel: ME.StartTime=2017/1/27 17:04:23.<br />Format(ME.StartTime, "h:m:s") -> '5:4:23'<br />Format(ME.StartTime, "hh:mm:ss tt") -> '05:04:23 PM'<br />Format(ME.StartTime, "dddd, MMM d yyyy") -> 'Dienstag, Jan 27 2017 '<br />Format(ME.StartTime, "HH:mm:ss") -> '17:04:23'<br /><br />Format(5459.4, "##,##0.00") -> '5,459.40'<br />Format(334.9, "###0.00") -> '334.90'<br />Format(5, "0.00%") -> '500.00%'|| 
+
|<code>Format(ME.StartTime,'dddd, MMM d yyyy') </code>||"Montag, Jan 27 2020"
 
|-
 
|-
−
|}
+
|<code>Format(ME.StartTime,'HH:mm:ss') </code>||"17:04:23"
−
 
 
−
Hinweise
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Anführungszeichen (") können in bestimmten String-Formeln nicht benutzt werden, außer sie werden in {} angegeben. Das Zahlenformat kann nicht benutzt werden.|| 
+
|<code>Format(5459.4,'##,##0.00')</code>||colspan="2"|"5,459.40"
 
|-
 
|-
−
|}
+
|<code>Format(334.9,'###0.00')</code>||colspan="2"|"334.90"
−
 
 
−
<hr>
 
−
<Cast-String zu Zahl>
 
−
 
 
−
FindNumberL( str, count )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||str||Quellstring|| 
+
|<code>Format(5,'0.00%')</code>||colspan="2"|"500.00%"
 
|-
 
|-
−
||   ||count||Ganze Zahl. Bestimmen Sie die Anzahl von Get-Strings von ganz links.
+
!Hinweis
 +
|colspan="3"|Entspricht weitgehende der Format()-Funktion in Visual Basic.
 
|-
 
|-
 
|}
 
|}
  
−
Rückgabewert
+
== String in Zahl umwandeln ==
−
 
+
=== FindNumberL( str, count ) ===
−
 
+
{| class="wikitable"
−
{|
 
 
|-
 
|-
−
|   ||Gibt die gefundene Anzahl an str-Strings von ganz links wieder.||  
+
!rowspan="2"|Argumente
 +
|''str''||Quellstring
 
|-
 
|-
−
|}
+
|''count''||Integer, Position der Zahl
−
 
 
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||FindNumberL( 'Jahr:2017 Monat6 Tag1',1 ) -> 2017<br />FindNumberL( 'Jahr:2017 Monat6 Tag1',2 ) -> 6<br />FindNumberL( 'Jahr:2017 Monat6 Tag1',3 ) -> 1|| 
+
!Rückgabewert
 +
|colspan="2"|Gibt die ''count''-te Zahl in ''str'' zurück.
 
|-
 
|-
−
|}
+
!rowspan="3"|Beispiele
−
 
+
|<code>FindNumberL('Year:2020 Month6 Day1',1)</code>||2020
−
 
 
−
FindNumberR( str, count )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||str||Quellstring|| 
+
|<code>FindNumberL('Year:2020 Month6 Day1',2)</code>||6
 
|-
 
|-
−
||   ||count||Ganze Zahl. Bestimmen Sie die Anzahl der Get-Strings von ganz rechts.
+
|<code>FindNumberL('Year:2020 Month6 Day1',2)</code>||1
 
|-
 
|-
 
|}
 
|}
  
−
Rückgabewert
+
=== FindNumberR( str, count ) ===
−
 
+
{| class="wikitable"
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Gibt die gefundene Anzahl an str-Strings von ganz rechts wieder.||  
+
!rowspan="2"|Argumente
 +
|''str''||Quellstring
 
|-
 
|-
−
|}
+
|''count''||Integer, Position der Zahl
−
 
 
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||FindNumberR( 'Jahr:2017 Monat6 Tag1',1 ) -> 2017<br />FindNumberR( 'Jahr:2017 Monat6 Tag1',2 ) -> 6<br />FindNumberR( 'Jahr:2017 Monat6 Tag1',3 ) -> 1|| 
+
!Rückgabewert
 +
|colspan="2"|Gibt die ''count''-te Zahl von rechts in ''str'' zurück.
 
|-
 
|-
−
|}
+
!rowspan="3"|Beispiele
−
 
+
|<code>FindNumberR('Year:2020 Month6 Day1',1)</code>||1
−
<hr>
 
−
<Cast-String zu Zahl>
 
−
 
 
−
GetYearPart( time )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Zeit||Zielzeit|| 
+
|<code>FindNumberR('Year:2020 Month6 Day1',2)</code>||6
−
|-
 
−
|}
 
−
 
 
−
 
 
−
GetMonthPart( time )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Zeit||Zielzeit|| 
+
|<code>FindNumberR('Year:2020 Month6 Day1',2)</code>||2020
 
|-
 
|-
 
|}
 
|}
  
−
 
+
== Datum in Zahl umwandeln ==
−
GetDayPart( time )
+
=== GetYearPart( time ) ===
−
 
+
{| class="wikitable"
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Zeit||Zielzeit|| 
+
!Argument
 +
|''time''||Zielzeit
 
|-
 
|-
−
|}
+
!Rückgabewert
−
 
+
|colspan="2"|Gibt das Jahr von ''time'' zurück.
−
 
 
−
GetHourPart( time )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Zeit||Zielzeit|| 
+
!Beispiel
 +
|<code>GetYearPart(#2020/6/1 12:30:00#)</code>||2020
 
|-
 
|-
 
|}
 
|}
  
−
 
+
=== GetMonthPart( time ) ===
−
GetMinutePart( time )
+
{| class="wikitable"
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Zeit||Zielzeit|| 
+
!Argument
 +
|''time''||Zielzeit
 
|-
 
|-
−
|}
+
!Rückgabewert
−
 
+
|colspan="2"|Gibt den Monat von ''time'' zurück.
−
 
 
−
 
 
−
GetSecondPart( time )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Zeit||Zielzeit|| 
+
!Beispiel
 +
|<code>GetMonthPart(#2020/6/1 12:30:00#)</code>||6
 
|-
 
|-
 
|}
 
|}
  
−
<hr>
+
=== GetDayPart( time ) ===
−
<Cast-String zu Zahl>
+
{| class="wikitable"
−
 
 
−
GetTimePart( time )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
−
|-
 
−
|  ||Zeit||Zielzeit|| 
 
 
|-
 
|-
−
|}
+
!Argument
−
 
+
|''time''||Zielzeit
−
<hr>
 
−
<Cast-String zu Zahl>
 
−
 
 
−
ConvertTime( time, unit )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Zeit||Zielzeit|| 
+
!Rückgabewert
 +
|colspan="2"|Gibt den Tag von ''time'' zurück.
 
|-
 
|-
−
||  ||Einheit||Formateinheit (m, M, h, H, d, D). Die Zeit wird abgerundet, wenn Kleinbuchstaben verwendet werden. Die Zeit wird aufgerundet, wenn Großbuchstaben verwendet werden. m - minute, h - hour, d - date.
+
!Beispiel
 +
|<code>GetDayPart(#2020/6/1 12:30:00#)</code>||1
 
|-
 
|-
 
|}
 
|}
  
−
Rückgabewert
+
=== GetHourPart( time ) ===
−
 
+
{| class="wikitable"
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Gibt die Zeit in der spezifizierten Zeiteinheit wieder.|| 
+
!Argument
 +
|''time''||Zielzeit
 
|-
 
|-
−
|}
+
!Rückgabewert
−
 
+
|colspan="2"|Gibt die Stunde von ''time'' zurück.
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||ConvertTime( 350s, 'm' ) -> 5  350 Sekunden gleichen 5 Minuten 50 Sekunden; der zweite Teil wird abgerundet und gibt 5 Minuten aus<br />ConvertTime( 350s, 'M' ) -> 6 350 Sekunden gleichen 5 Minuten 50 Sekunden; der zweite Teil wird aufgerundet und gibt 6 Minuten aus <br />ConvertTime( 1.6H, 'H' ) -> 2  Rundet 1.6 auf und gibt 2 Stunden aus||  
+
!Beispiel
 +
|<code>GetHourPart(#2020/6/1 12:30:00#)</code>||12
 
|-
 
|-
 
|}
 
|}
  
−
<hr>
+
=== GetMinutePart( time ) ===
−
<Cast-String zu Zahl>
+
{| class="wikitable"
−
 
 
−
DateF(Jahr, Monat, Tag, Stunde, Minute, Sekunde)
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Jahr||Ganze Zahl, Jahr.|| 
+
!Argument
 +
|''time''||Zielzeit
 
|-
 
|-
−
||   ||Monat||Ganze Zahl, Monat.
+
!Rückgabewert
 +
|colspan="2"|Gibt die Minute von ''time'' zurück.
 
|-
 
|-
−
||  ||Tag||Ganze Zahl, Tag.
+
!Beispiel
−
|-
+
|<code>GetMinutePart(#2020/6/1 12:30:00#)</code>||0
−
||  ||Stunde||Ganze Zahl, Stunde.
 
−
|-
 
−
||  ||Minute||Ganze Zahl, Minute.
 
−
|-
 
−
||  ||Sekunde||Ganze Zahl, Sekunde.
 
−
|-
 
−
|}
 
−
 
 
−
Rückgabewert
 
−
 
 
−
 
 
−
{|
 
−
|-
 
−
|  ||Gibt spezifiziert Jahr / Monat / Tag / Stunde / Minute / Sekunde aus.||  
 
 
|-
 
|-
 
|}
 
|}
  
−
Beispiel
+
=== GetSecondPart( time ) ===
−
 
+
{| class="wikitable"
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||DateF( 2017, 6, 15, 6, 30, 30 ) -> 2017/06/15 06:30:30|| 
+
!Argument
 +
|''time''||Zielzeit
 
|-
 
|-
−
 
+
!Rückgabewert
−
|}
+
|colspan="2"|Gibt die Sekunde von ''time'' zurück.
−
 
 
−
Hinweise
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||F' von DateF steht für das 'F' von Full. Alles (Year/Month/Day/Hour/Minute/Second) kann hinterlegt werden.||  
+
!Beispiel
 +
|<code>GetSecondPart(#2020/6/1 12:30:00#)</code>||0
 
|-
 
|-
 
|}
 
|}
  
−
 
+
== Datum in Zeit umwandeln ==
−
DateS( Jahr, Monat, Tag )
+
=== GetTimePart( time ) ===
−
 
+
{| class="wikitable"
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Jahr||Ganze Zahl, Jahr.|| 
+
!Argument
 +
|''time''||Zielzeit
 
|-
 
|-
−
||   ||Monat||Ganze Zahl, Monat.
+
!Rückgabewert
 +
|colspan="2"|Gibt die Zeit von ''time'' zurück.
 
|-
 
|-
−
||   ||Tag||Ganze Zahl, Tag.
+
!rowspan="2"|Beispiele
 +
|<code>GetTimePart(#2020/6/1 12:30:00#)</code>||12H30M
 
|-
 
|-
−
|}
+
|<code>GetTimePart(now())</code>||Aktuelle Zeit
−
 
 
−
Rückgabewert
 
−
 
 
−
 
 
−
{|
 
−
|-
 
−
|  ||Gibt das bestimmte Jahr/Monat/Tag aus. Hier besteht keine Verbindung zur "Tagesabgrenzungszeit" im Reiter "Zeitperioden" der Projekteinstellungen.||  
 
 
|-
 
|-
 
|}
 
|}
  
−
Beispiel
+
== Zeit in Zeit umwandeln ==
−
 
+
=== ConvertTime( time, unit ) ===
−
 
+
{| class="wikitable"
−
{|
 
 
|-
 
|-
−
|   ||DateS( 2017, 6, 15 ) -> 2017/06/15||  
+
!rowspan="2"|Argumente
 +
|''time''||colspan="2"|Zielzeit
 
|-
 
|-
−
|}
+
|''unit''||colspan="2"|Basiseinheit der Umwandlung - Sekunde, Minute, Stunde oder Tag
−
 
 
−
Hinweise
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||S' von DateS steht für das 'S' von Simple. Nur Jahr/Monat/Tag können hinterlegt werden.|| 
+
!Rückgabewert
 +
|colspan="3"|Gibt ''time'' als Zahl zurück.
 
|-
 
|-
−
|}
+
!rowspan="3"|Beispiele
−
 
+
|<code>ConvertTime(350s,'m')</code>||5||''5m + 50s, Sekunden werden abgerundet.''
−
 
 
−
DateT( Jahr, Monat, Tag, Zeit )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
−
|-
 
−
|  ||Jahr||Ganze Zahl, Jahr.|| 
 
 
|-
 
|-
−
||  ||Monat||Ganze Zahl, Monat.
+
|<code>ConvertTime(350s,'M')</code>||6||''5m + 50s, Sekunden werden aufgerundet.''
 
|-
 
|-
−
||  ||Tag||Ganze Zahl, Tag.
+
|<code>ConvertTime(1.6H,'H')</code>||2||''1h + 36m, Minuten werden aufgerundet.''
 
|-
 
|-
−
||   ||Zeit||Zeit
+
!Hinweis
 +
|colspan="3"|Erlaubte Werte für ''unit'' sind
 +
* Abrunden - s, m, h, d
 +
* Aufrunden - S, M, H, D
 
|-
 
|-
 
|}
 
|}
  
−
Rückgabewert
+
== Zahl in Datum umwandeln ==
−
 
+
=== DateF( year, month, day, hour, minute, second ) ===
−
 
+
{| class="wikitable"
−
{|
 
−
|-
 
−
|  ||Gibt Jahr/Monat/Tag einer Zeit aus.|| 
 
−
|-
 
−
|}
 
−
 
 
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||DateT( 2017, 6, 15, 6H ) -> 2017/06/15 06:00:00<br />DateT( 2017, 6, 15, 6M) -> 2017/06/15 00:06:00<br />DateT( 2017, 6, 15, 6S ) -> 2017/06/15 00:00:06|| 
+
!rowspan="6"|Argumente
 +
|''year''||Integer, Jahr
 
|-
 
|-
−
 
+
|''month''||Integer, Monat
−
|}
 
−
 
 
−
Hinweise
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||T' von DateT steht für 'T' von TimeSpan.<br />Eine Zeiteinheit, beispielsweise H, M und S, kann hinterlegt werden.||  
+
|''day''||Integer, Tag
 
|-
 
|-
−
|}
+
|''hour''||Integer, Stunde
−
 
 
−
<hr>
 
−
<Cast-String zu Zahl>
 
−
 
 
−
CDblFromStr( str )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||str||String.|| 
+
|''minute''||Integer, Minute
 
|-
 
|-
−
|}
+
|''second''||Integer, Sekunde
−
 
 
−
Rückgabewert
 
−
 
 
−
 
 
−
{|
 
−
|-
 
−
|  ||Gibt den str-String als Zahl aus.|| 
 
 
|-
 
|-
−
|}
+
!Rückgabewert
−
 
+
|colspan="2"|Gibt ''year'', ''month'', ''day'', ''hour'', ''minute'' & ''second'' als Datum zurück.
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||CDblFromStr('1.5') -> 1.5||  
+
!Beispiel
 +
|<code>DateF(2020,6,15,6,30,30)</code>||2020/06/15 06:30:30
 
|-
 
|-
 +
!Hinweis
 +
|colspan="2"|Das "F" in <code>DateF()</code> steht für "vollständig" ("full"), da alle Elemente des Datums vorgegeben werden können.
 
|}
 
|}
  
−
Hinweise
+
=== DateS( year, month, day ) ===
−
 
+
{| class="wikitable"
−
 
 
−
{|
 
−
|-
 
−
|  ||Eine Plug-In-Erweiterung ist erforderlich.|| 
 
 
|-
 
|-
−
|}
+
!rowspan="3"|Argumente
−
 
+
|''year''||Integer, Jahr
−
<hr>
 
−
<Cast-String zu Zahl>
 
−
 
 
−
CLngFromStr( str )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||str||String.|| 
+
|''month''||Integer, Monat
 
|-
 
|-
−
|}
+
|''day''||Integer, Tag
−
 
 
−
Rückgabewert
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Formatiert str-String als Zahl. Die Zahl nach dem Dezimalkomma wird gekürzt: Durch die Rundungsregel wird eine 0 ausgegeben, wenn die Zahl kleiner als 5 ist und eine 1 wenn die Zahl größer oder gleich 5 ist.|| 
+
!Rückgabewert
 +
|colspan="2"|Gibt ''year'', ''month'' & ''day'' als Datum zurück.
 
|-
 
|-
−
|}
+
!Beispiel
−
 
+
|<code>DateS(2020,6,15)</code>||2020/06/15 00:00:00
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||CLngFromStr('1.5') -> 2|| 
+
!Hinweise
 +
|colspan="2"|
 +
* Das "S" in <code>DateS()</code> steht für "einfach" ("simple"), da keine Uhrzeit vorgegeben werden kann.
 +
* Die [Tagestrennzeit] der Projekteigenschaften wird nicht berücksichtigt.
 
|-
 
|-
 
|}
 
|}
  
−
Hinweise
+
=== DateT( year, month, day, time ) ===
−
 
+
{| class="wikitable"
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Plug-In-Erweiterung erforderlich.|| 
+
!rowspan="4"|Argumente
 +
|''year''||Integer, Jahr
 
|-
 
|-
−
|}
+
|''month''||Integer, Monat
−
 
 
−
<hr>
 
−
<Cast-String zu Zahl>
 
−
 
 
−
CStrFromDbl( Wert )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Wert||Zahl.|| 
+
|''day''||Integer, Tag
 
|-
 
|-
−
|}
+
|''time''||Integer, Zeitspane
−
 
 
−
Rückgabewert
 
−
 
 
  
−
{|
 
 
|-
 
|-
−
|   ||Gibt den Wert als String zurück.|| 
+
!Rückgabewert
 +
|colspan="2"|Gibt ''year'', ''month'', ''day & ''time'' als Datum zurück.
 
|-
 
|-
−
|}
+
!rowspan="3"|Beispiele
−
 
+
|<code>DateT(2020,6,15,6H)</code>||2020/06/15 06:00:00
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||CStrFromDbl(1.5) -> 1.5||  
+
|<code>DateT(2020,6,15,6M)</code>||2020/06/15 00:06:00
 
|-
 
|-
−
|}
+
|<code>DateT(2020,6,15,6S)</code>||2020/06/15 00:00:06
−
 
 
−
Hinweise
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Plug-In-Erweiterung erforderlich.|| 
+
!Hinweise
 +
|colspan="2"|Das "T" in <code>DateT()</code> steht für "Zeitspanne" ("time span").
 
|-
 
|-
 
|}
 
|}
  
 
<hr>
 
<hr>
−
<Cast-String zu Zahl>
 
−
 
−
CLngFromDbl(Wert )
 
−
 
−
Parameter
 
−
 
−
 
−
{|
 
−
|-
 
−
|  ||Wert||Zahl.|| 
 
−
|-
 
−
|}
 
−
 
−
Rückgabewert
 
−
 
−
 
−
{|
 
−
|-
 
−
|  ||Die Zahl nach dem Dezimalkomma wird gekürzt: Durch die Rundungsregel wird eine 0 ausgegeben, wenn die Zahl kleiner als 5 ist und eine 1 wenn die Zahl größer oder gleich 5 ist.|| 
 
−
|-
 
−
|}
 
−
 
−
Beispiel
 
−
 
−
 
−
{|
 
−
|-
 
−
|  ||CLngFromDbl(1.5) -> 2|| 
 
−
|-
 
−
|}
 
−
 
−
Hinweise
 
−
 
−
Plug-In-Erweiterung erforderlich.
 
−
 
−
 
−
{|
 
−
|-
 
−
|  |||| 
 
−
|-
 
−
|}
 
−
 
 
<hr>
 
<hr>
 
<div align="right">Hilfe Nummer: 741520</div>
 
<div align="right">Hilfe Nummer: 741520</div>

Version vom 7. Januar 2019, 22:33 Uhr

Hilfe Nummer: 741520
Interne Funktion
Formeldialog

Asprova stellt Ihnen die folgenden Funktionen zur Umwandlung von Daten in andere Datentypen zur Verfügung.

Datum, Zeit oder Zahl in String umwandeln

Format( value, expr)

Argumente value Zu formatierendes Datum/Zeit/Zahl
expr Struktur des Rückgabewerts
Rückgabewert Gibt value entsprechend den Vorgaben in expr formatiert zurück.
Beispiele Format(ME.StartTime,'h:m:s') "5:4:23" ME.StartTime ist der 27.01.2020 17:14:23.
Format(ME.StartTime,'hh:mm:ss tt') "05:04:23 PM"
Format(ME.StartTime,'dddd, MMM d yyyy') "Montag, Jan 27 2020"
Format(ME.StartTime,'HH:mm:ss') "17:04:23"
Format(5459.4,'##,##0.00') "5,459.40"
Format(334.9,'###0.00') "334.90"
Format(5,'0.00%') "500.00%"
Hinweis Entspricht weitgehende der Format()-Funktion in Visual Basic.

String in Zahl umwandeln

FindNumberL( str, count )

Argumente str Quellstring
count Integer, Position der Zahl
Rückgabewert Gibt die count-te Zahl in str zurück.
Beispiele FindNumberL('Year:2020 Month6 Day1',1) 2020
FindNumberL('Year:2020 Month6 Day1',2) 6
FindNumberL('Year:2020 Month6 Day1',2) 1

FindNumberR( str, count )

Argumente str Quellstring
count Integer, Position der Zahl
Rückgabewert Gibt die count-te Zahl von rechts in str zurück.
Beispiele FindNumberR('Year:2020 Month6 Day1',1) 1
FindNumberR('Year:2020 Month6 Day1',2) 6
FindNumberR('Year:2020 Month6 Day1',2) 2020

Datum in Zahl umwandeln

GetYearPart( time )

Argument time Zielzeit
Rückgabewert Gibt das Jahr von time zurück.
Beispiel GetYearPart(#2020/6/1 12:30:00#) 2020

GetMonthPart( time )

Argument time Zielzeit
Rückgabewert Gibt den Monat von time zurück.
Beispiel GetMonthPart(#2020/6/1 12:30:00#) 6

GetDayPart( time )

Argument time Zielzeit
Rückgabewert Gibt den Tag von time zurück.
Beispiel GetDayPart(#2020/6/1 12:30:00#) 1

GetHourPart( time )

Argument time Zielzeit
Rückgabewert Gibt die Stunde von time zurück.
Beispiel GetHourPart(#2020/6/1 12:30:00#) 12

GetMinutePart( time )

Argument time Zielzeit
Rückgabewert Gibt die Minute von time zurück.
Beispiel GetMinutePart(#2020/6/1 12:30:00#) 0

GetSecondPart( time )

Argument time Zielzeit
Rückgabewert Gibt die Sekunde von time zurück.
Beispiel GetSecondPart(#2020/6/1 12:30:00#) 0

Datum in Zeit umwandeln

GetTimePart( time )

Argument time Zielzeit
Rückgabewert Gibt die Zeit von time zurück.
Beispiele GetTimePart(#2020/6/1 12:30:00#) 12H30M
GetTimePart(now()) Aktuelle Zeit

Zeit in Zeit umwandeln

ConvertTime( time, unit )

Argumente time Zielzeit
unit Basiseinheit der Umwandlung - Sekunde, Minute, Stunde oder Tag
Rückgabewert Gibt time als Zahl zurück.
Beispiele ConvertTime(350s,'m') 5 5m + 50s, Sekunden werden abgerundet.
ConvertTime(350s,'M') 6 5m + 50s, Sekunden werden aufgerundet.
ConvertTime(1.6H,'H') 2 1h + 36m, Minuten werden aufgerundet.
Hinweis Erlaubte Werte für unit sind
  • Abrunden - s, m, h, d
  • Aufrunden - S, M, H, D

Zahl in Datum umwandeln

DateF( year, month, day, hour, minute, second )

Argumente year Integer, Jahr
month Integer, Monat
day Integer, Tag
hour Integer, Stunde
minute Integer, Minute
second Integer, Sekunde
Rückgabewert Gibt year, month, day, hour, minute & second als Datum zurück.
Beispiel DateF(2020,6,15,6,30,30) 2020/06/15 06:30:30
Hinweis Das "F" in DateF() steht für "vollständig" ("full"), da alle Elemente des Datums vorgegeben werden können.

DateS( year, month, day )

Argumente year Integer, Jahr
month Integer, Monat
day Integer, Tag
Rückgabewert Gibt year, month & day als Datum zurück.
Beispiel DateS(2020,6,15) 2020/06/15 00:00:00
Hinweise
  • Das "S" in DateS() steht für "einfach" ("simple"), da keine Uhrzeit vorgegeben werden kann.
  • Die [Tagestrennzeit] der Projekteigenschaften wird nicht berücksichtigt.

DateT( year, month, day, time )

Argumente year Integer, Jahr
month Integer, Monat
day Integer, Tag
time Integer, Zeitspane
Rückgabewert Gibt year, month, day & time als Datum zurück.
Beispiele DateT(2020,6,15,6H) 2020/06/15 06:00:00
DateT(2020,6,15,6M) 2020/06/15 00:06:00
DateT(2020,6,15,6S) 2020/06/15 00:00:06
Hinweise Das "T" in DateT() steht für "Zeitspanne" ("time span").
Hilfe Nummer: 741520
Abgerufen von „http://hilfe.asprova.eu/index.php?title=Umwandeln&oldid=5885“