Umwandeln: Unterschied zwischen den Versionen

Aus Asprova Hilfe
Wechseln zu: Navigation, Suche
(Imported from text file)
 
 
(10 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
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 Zeichenkette umwandeln ==
−
Format( value, expr )
+
=== Format( value, expr) ===
−
 
+
{| class="wikitable"
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||value||Übersetze Daten/ Zeit/ Anzahl.|| 
+
!rowspan="2"|Parameter
 +
|''value''||colspan="2"|Zu formatierendes Datum/Zeit/Zahl
 
|-
 
|-
−
||   ||expr||String-Format spezifizieren. Gleicht der Funktion VisualBasic-Format.
+
|''expr''||colspan="2"|Struktur des Rückgabewerts
 
|-
 
|-
−
|}
+
!Rückgabewert
−
 
+
|colspan="3"|Gibt ''value'' entsprechend den Vorgaben in ''expr'' formatiert zurück.
−
Rückgabewert
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Formatwert basiert auf spezifizierter 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
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Nehmen Sie beispielsweise ME.StartTime=2011/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 2011'<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
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Because " character cannot be used in specified string expr, if you want to use " character, please surround it with {}. Number format cannot be used.|| 
+
|<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. Spezifiziert die Anzahl der Get-Strings von Links.
+
!Hinweis
 +
|colspan="3"|Entspricht weitgehende der Format()-Funktion in Visual Basic.
 
|-
 
|-
 
|}
 
|}
  
−
Rückgabewert
+
== Zeichenkette in Zahl umwandeln ==
−
 
+
=== FindNumberL( str, count ) ===
−
 
+
{| class="wikitable"
−
{|
+
|-
 +
!rowspan="2"|Parameter
 +
|''str''||Quellstring
 
|-
 
|-
−
|   ||Gibt die gefundene Anzahl an str-Strings von Links wieder.|| 
+
|''count''||Integer, Position der Zahl
 
|-
 
|-
−
|}
+
!Rückgabewert
−
 
+
|colspan="2"|Gibt die ''count''-te Zahl in ''str'' zurück.
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||FindNumberL( 'Jahr:2011 Monat6 Tag1',1 ) -> 2011<br />FindNumberL( 'Jahr:2011 Monat6 Tag1',2 ) -> 6<br />FindNumberL( 'Jahr:2011 Monat6 Tag1',3 ) -> 1||  
+
!rowspan="3"|Beispiele
 +
|<code>FindNumberL('Jahr: 2020 Monat: 6 Tag: 1',1)</code>||2020
 
|-
 
|-
−
|}
+
|<code>FindNumberL('Jahr: 2020 Monat: 6 Tag: 1',2)</code>||6
−
 
 
−
 
 
−
FindNumberR( str, count )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||str||Quellstring|| 
+
|<code>FindNumberL('Jahr: 2020 Monat: 6 Tag: 1',3)</code>||1
 
|-
 
|-
−
||   ||count||Ganze Zahl. Spezifiziert die Anzahl der Get-Strings von Rechts.
+
!Hinweis
 +
|colspan="2"|''str'' mit dem Muster "xxxE(-)xx" wird als Zahl in [https://de.wikipedia.org/wiki/Wissenschaftliche_Notation wissenschaftlicher Notation] ausgewertet.
 
|-
 
|-
 
|}
 
|}
  
−
Rückgabewert
+
=== FindNumberR( str, count ) ===
−
 
+
{| class="wikitable"
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Gibt die gefundene Anzahl an str-Strings von Rechts wieder.||  
+
!rowspan="2"|Parameter
 +
|''str''||Quellstring
 
|-
 
|-
−
|}
+
|''count''||Integer, Position der Zahl
−
 
 
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||FindNumberR( 'Jahr:2011 Monat6 Tag1',1 ) -> 2011<br />FindNumberR( 'Jahr:2011 Monat6 Tag1',2 ) -> 6<br />FindNumberR( 'Jahr:2011 Monat6 Tag1',3 ) -> 1|| 
+
!Rückgabewert
 +
|colspan="2"|Gibt die ''count''-te Zahl von rechts in ''str'' zurück.
 
|-
 
|-
−
|}
+
!rowspan="3"|Beispiele
−
 
+
|<code>FindNumberR('Jahr: 2020 Monat: 6 Tag: 1',1)</code>||1
−
<hr>
 
−
<Cast-String zu Zahl>
 
−
 
 
−
GetYearPart( time )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Zeit||Zielzeit|| 
+
|<code>FindNumberR('Jahr: 2020 Monat: 6 Tag: 1',2)</code>||6
 
|-
 
|-
−
|}
+
|<code>FindNumberR('Jahr: 2020 Monat: 6 Tag: 1',3)</code>||2020
−
 
 
−
 
 
−
GetMonthPart( time )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Zeit||Zielzeit|| 
+
!Hinweis
 +
|colspan="2"|''str'' mit dem Muster "xxxE(-)xx" wird als Zahl in [https://de.wikipedia.org/wiki/Wissenschaftliche_Notation wissenschaftlicher Notation] ausgewertet.
 
|-
 
|-
 
|}
 
|}
  
−
 
+
== Datum in Zahl umwandeln ==
−
GetDayPart( time )
+
=== GetYearPart( time ) ===
−
 
+
{| class="wikitable"
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Zeit||Zielzeit|| 
+
!Parameter
 +
|''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|| 
+
!Parameter
 +
|''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|| 
+
!Parameter
 +
|''time''||Zielzeit
 
|-
 
|-
−
|}
+
!Rückgabewert
−
 
+
|colspan="2"|Gibt den Tag von ''time'' zurück.
−
<hr>
 
−
<Cast-String zu Zahl>
 
−
 
 
−
ConvertTime( time, unit )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|  ||Zeit||Zielzeit|| 
+
!Beispiel
−
|-
+
|<code>GetDayPart(#2020/6/1 12:30:00#)</code>||1
−
||  ||Einheit||Formateinheit (m, M, h, H, d, D). Die Zeit wird abgerundet für den Fall, dass Kleinbuchstaben verwendet werden. Die Zeit wird aufgerundet wenn es sich um Großbuchstaben handelt. m - minute, h - hour, d - date.
 
 
|-
 
|-
 
|}
 
|}
  
−
Rückgabewert
+
=== GetHourPart( time ) ===
−
 
+
{| class="wikitable"
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Gibt die Zeit mit der spezifizierten Zeiteinheit wieder.|| 
+
!Parameter
 +
|''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, rundet den zweiten Teil und gibt 5 Minuten aus.<br />ConvertTime( 350s, 'M' ) -> 6 350 Sekunden gleichen 5 Minuten 50 Sekunden, rundet den zweiten Teil auf und gibt 6 Minuten aus. <br />ConvertTime( 1.6H, 'H' ) -> 2  Rundet 1.6 auf und gibt 2 Stunden zurück.||  
+
!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.|| 
+
!Parameter
 +
|''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
+
=== GetSecondPart( time ) ===
−
 
+
{| class="wikitable"
−
 
 
−
{|
 
−
|-
 
−
|  ||Gibt spezifiziert Jahr / Monat / Tag / Stunde / Minute / Sekunde aus.|| 
 
−
|-
 
−
|}
 
−
 
 
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||DateF( 2011, 6, 15, 6, 30, 30 ) -> 2011/06/15 06:30:30|| 
+
!Parameter
 +
|''time''||Zielzeit
 
|-
 
|-
−
 
+
!Rückgabewert
−
|}
+
|colspan="2"|Gibt die Sekunde von ''time'' zurück.
−
 
 
−
Hinweise
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||F' von DateF steht für das 'F' von Full, was bedeutet, dass alles (Year/Month/Day/Hour/Minute/Second) spezifiziert werden kann.||  
+
!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.|| 
+
!Parameter
 +
|''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
−
|}
 
−
 
 
−
Rückgabewert
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Gibt spezifiziert Jahr/Monat/Tag aus. Hier besteht keine Verbindung zur "Tagesabgrenzungszeit" im Reiter "Zeitperioden" der Projekteinstellungen.||  
+
|<code>GetTimePart(now())</code>||Aktuelle Zeit
 
|-
 
|-
 
|}
 
|}
  
−
Beispiel
+
== Zeit in Zeit umwandeln ==
−
 
+
=== ConvertTime( time, unit ) ===
−
 
+
{| class="wikitable"
−
{|
 
 
|-
 
|-
−
|   ||DateS( 2011, 6, 15 ) -> 2011/06/15||  
+
!rowspan="2"|Parameter
−
|-
+
|''time''||colspan="2"|Zielzeit
−
|}
 
−
 
 
−
Hinweise
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||S' von DateS steht für das 'S' von Simple, was lediglich bedeutet, dass nur Jahr/Monat/Tag spezifiziert werden.|| 
+
|''unit''||colspan="2"|Basiseinheit der Umwandlung - Sekunde, Minute, Stunde oder Tag
 
|-
 
|-
−
|}
+
!Rückgabewert
−
 
+
|colspan="3"|Gibt ''time'' als Zahl zurück.
−
 
 
−
DateT( Jahr, Monat, Tag, Zeit )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Jahr||Ganze Zahl, Jahr.|| 
+
!rowspan="3"|Beispiele
 +
|<code>ConvertTime(350s,'m')</code>||5||''5m + 50s, Sekunden werden abgerundet.''
 
|-
 
|-
−
||  ||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"
−
{|
+
|-
 +
!rowspan="6"|Parameter
 +
|''year''||Integer, Jahr
 
|-
 
|-
−
|   ||Gibt Jahr/Monat/Tag einer Zeit aus.|| 
+
|''month''||Integer, Monat
 
|-
 
|-
−
|}
+
|''day''||Integer, Tag
−
 
 
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||DateT( 2011, 6, 15, 6H ) -> 2011/06/15 06:00:00<br />DateT( 2011, 6, 15, 6M) -> 2011/06/15 00:06:00<br />DateT( 2011, 6, 15, 6S ) -> 2011/06/15 00:00:06|| 
+
|''hour''||Integer, Stunde
 
|-
 
|-
−
 
+
|''minute''||Integer, Minute
−
|}
 
−
 
 
−
Hinweise
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||T' von DateT steht für 'T' von TimeSpan.<br />Eine Zeiteinheit, wie z.B. H, M und S kann spezifiziert werden.||  
+
|''second''||Integer, Sekunde
 
|-
 
|-
−
|}
+
!Rückgabewert
−
 
+
|colspan="2"|Gibt ''year'', ''month'', ''day'', ''hour'', ''minute'' & ''second'' als Datum zurück.
−
<hr>
 
−
<Cast-String zu Zahl>
 
−
 
 
−
CDblFromStr( str )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||str||String.|| 
+
!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.
 
|}
 
|}
  
−
Rückgabewert
+
=== DateS( year, month, day ) ===
−
 
+
{| class="wikitable"
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Gibt den str-String als Zahl aus.|| 
+
!rowspan="3"|Parameter
 +
|''year''||Integer, Jahr
 
|-
 
|-
−
|}
+
|''month''||Integer, Monat
−
 
 
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||CDblFromStr('1.5') -> 1.5|| 
+
|''day''||Integer, Tag
−
|-
 
−
|}
 
−
 
 
−
Hinweise
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Eine Plug-In-Erweiterung ist erforderlich.|| 
+
!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
−
<hr>
 
−
<Cast-String zu Zahl>
 
−
 
 
−
CLngFromStr( str )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||str||String.|| 
+
!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.
 
|-
 
|-
 
|}
 
|}
  
−
Rückgabewert
+
=== DateT( year, month, day, time ) ===
−
 
+
{| class="wikitable"
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Formatiert str-String als Zahl. Die Zahl nach dem Dezimalkomma wird gekürzt, indem durch die Rundungsregel eine 0 ausgegeben wird, sollte die Zahl kleiner als 5 sein und eine 1, sollte die Zahl größer oder gleich 5 sein.|| 
+
!rowspan="4"|Parameter
 +
|''year''||Integer, Jahr
 
|-
 
|-
−
|}
+
|''month''||Integer, Monat
−
 
 
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||CLngFromStr('1.5') -> 2||  
+
|''day''||Integer, Tag
 
|-
 
|-
−
|}
+
|''time''||Zeitspane
  
−
Hinweise
 
−
 
−
 
−
{|
 
 
|-
 
|-
−
|   ||Plug-In-Erweiterung erforderlich.|| 
+
!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
−
<hr>
 
−
<Cast-String zu Zahl>
 
−
 
 
−
CStrFromDbl( Wert )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Wert||Zahl.|| 
+
|<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
−
 
 
−
Rückgabewert
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Gibt den Wert als String zurück.|| 
+
!Hinweise
 +
|colspan="2"|Das "T" in <code>DateT()</code> steht für "Zeitspanne" ("time span").
 
|-
 
|-
 
|}
 
|}
  
−
Beispiel
+
== Zeichenkette in Datum oder Zeit umwandeln ==
−
 
+
=== ParseDate( string, pattern ) ===
−
 
+
{| class="wikitable"
−
{|
 
 
|-
 
|-
−
|   ||CStrFromDbl(1.5) -> 1.5|| 
+
!rowspan="2"|Parameter
 +
|''string''||Zeichenkette, in der Datum enthalten ist
 
|-
 
|-
−
|}
+
|''pattern''||Muster nach dem das Datum aus der Zeichenkette extrahiert werden soll
−
 
 
−
Hinweise
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Plug-In-Erweiterung erforderlich.|| 
+
!Rückgabewert
 +
|colspan="2"|Datum
 
|-
 
|-
−
|}
+
!rowspan="2"|Beispiele
−
 
+
|<code>ParseDate('23.01.25','dd.MM.yy')</code>||23/01/2025
−
<hr>
 
−
<Cast-String zu Zahl>
 
−
 
 
−
CLngFromDbl(Wert )
 
−
 
 
−
Parameter
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Wert||Zahl.||  
+
|<code>ParseDate('23.01.25 13-45-26','dd.MM.yy HH-mm-ss')</code>||23/01/2025 13:45:26
 
|-
 
|-
 
|}
 
|}
  
−
Rückgabewert
+
=== ParseTimespan( string, pattern ) ===
−
 
+
{| class="wikitable"
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||Die Zahl nach dem Dezimalkomma wird gekürzt, indem durch die Rundungsregel eine 0 ausgegeben wird, sollte die Zahl kleiner als 5 sein und eine 1, sollte die Zahl größer oder gleich 5 sein.|| 
+
!rowspan="2"|Parameter
 +
|''string''||Zeichenkette, in die Zeitspanne enthalten ist
 
|-
 
|-
−
|}
+
|''pattern''||Muster nach dem die Zeitspanne aus der Zeichenkette extrahiert werden soll
−
 
 
−
Beispiel
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   ||CLngFromDbl(1.5) -> 2|| 
+
!Rückgabewert
−
|-
+
|colspan="2"|Zeitspanne
−
|}
 
−
 
 
−
Hinweise
 
−
 
 
−
Plug-In-Erweiterung erforderlich.
 
−
 
 
−
 
 
−
{|
 
 
|-
 
|-
−
|   |||| 
+
!Beispiel
 +
|<code>ParseTimespan('12:34','HH:mm')</code>||12H34M
 
|-
 
|-
 
|}
 
|}

Aktuelle Version vom 31. Oktober 2024, 07: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 Zeichenkette umwandeln

Format( value, expr)

Parameter 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.

Zeichenkette in Zahl umwandeln

FindNumberL( str, count )

Parameter str Quellstring
count Integer, Position der Zahl
Rückgabewert Gibt die count-te Zahl in str zurück.
Beispiele FindNumberL('Jahr: 2020 Monat: 6 Tag: 1',1) 2020
FindNumberL('Jahr: 2020 Monat: 6 Tag: 1',2) 6
FindNumberL('Jahr: 2020 Monat: 6 Tag: 1',3) 1
Hinweis str mit dem Muster "xxxE(-)xx" wird als Zahl in wissenschaftlicher Notation ausgewertet.

FindNumberR( str, count )

Parameter str Quellstring
count Integer, Position der Zahl
Rückgabewert Gibt die count-te Zahl von rechts in str zurück.
Beispiele FindNumberR('Jahr: 2020 Monat: 6 Tag: 1',1) 1
FindNumberR('Jahr: 2020 Monat: 6 Tag: 1',2) 6
FindNumberR('Jahr: 2020 Monat: 6 Tag: 1',3) 2020
Hinweis str mit dem Muster "xxxE(-)xx" wird als Zahl in wissenschaftlicher Notation ausgewertet.

Datum in Zahl umwandeln

GetYearPart( time )

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

GetMonthPart( time )

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

GetDayPart( time )

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

GetHourPart( time )

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

GetMinutePart( time )

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

GetSecondPart( time )

Parameter 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 )

Parameter 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 )

Parameter 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 )

Parameter 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 )

Parameter 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 )

Parameter year Integer, Jahr
month Integer, Monat
day Integer, Tag
time 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").

Zeichenkette in Datum oder Zeit umwandeln

ParseDate( string, pattern )

Parameter string Zeichenkette, in der Datum enthalten ist
pattern Muster nach dem das Datum aus der Zeichenkette extrahiert werden soll
Rückgabewert Datum
Beispiele ParseDate('23.01.25','dd.MM.yy') 23/01/2025
ParseDate('23.01.25 13-45-26','dd.MM.yy HH-mm-ss') 23/01/2025 13:45:26

ParseTimespan( string, pattern )

Parameter string Zeichenkette, in die Zeitspanne enthalten ist
pattern Muster nach dem die Zeitspanne aus der Zeichenkette extrahiert werden soll
Rückgabewert Zeitspanne
Beispiel ParseTimespan('12:34','HH:mm') 12H34M
Hilfe Nummer: 741520
Abgerufen von „http://hilfe.asprova.eu/index.php?title=Umwandeln&oldid=7861“