Num# - script- en diagramfunctie

Num#() interpreteert een tekenreeks als een numerieke waarde, wat wil zeggen dat deze functie de invoerreeks converteert naar een getal met gebruikmaking van de opmaak die is opgegeven in de tweede parameter. Als de tweede parameter wordt weggelaten, worden de scheidingstekens voor decimalen en duizendtallen gebruikt die zijn ingesteld in het load-script voor gegevens. Aangepaste scheidingstekens voor decimalen en scheidingstekens voor duizendtallen zijn optionele parameters.

Syntaxis:

Num#(text[, format[, dec_sep [, thou_sep ] ] ])

Retourgegevenstypen: dubbele waarde

De functie Num#() retourneert een dubbele waarde met zowel de tekenreeks als de numerieke waarde. De functie neemt de tekstuele representatie van de invoeruitdrukking en genereert een getal. De notatie van het getal wordt niet gewijzigd: de uitvoer wordt in dezelfde notatie weergegeven als de invoer.

Argumenten
Argument	Beschrijving
text	De teksttekenreeks die moet worden geëvalueerd.
format	Tekenreeks die specificeert welke getalopmaak wordt gebruikt in de eerste parameter. Bij weglating worden de scheidingstekens voor decimalen en duizendtallen gebruikt die zijn ingesteld in het load-script voor gegevens. De functie Num# ondersteunt vele opmaakopties voor verschillende numerieke structuren, bijvoorbeeld: #,##0:geeft een getal zonder decimalen weer. #,##0.00:geeft een getal met twee decimalen weer. ##0.00%: geeft een getal als een percentage met twee decimalen weer. #,##0;(#,##0): plaatst getallen tussen haakjes. $#,##0.00: maakt getallen op als valuta met een $-symbool. 0.00E+0:gGeeft getallen in wetenschappelijke notatie weer.
dec_sep	Tekenreeks die het scheidingsteken voor decimalen opgeeft. Bij weglating wordt gebruikgemaakt van de waarde voor de variabele DecimalSep die is ingesteld in het load-script voor gegevens. De functie Num# ondersteunt vele notaties voor scheidingstekens voor decimalen, bijvoorbeeld: Komma ' , ': Bijvoorbeeld $1,000,00 voor duizend dollar. Punt ' . ': bijvoorbeeld € 1,000.00. Koppelteken ' - ': als dit wordt gebruikt in plaats van de traditionele punt of komma als scheidingsteken voor decimalen, geeft het waarden weer als ¥1,000-00. Ga voor meer informatie naar DecimalSep.
thou_sep	Tekenreeks die het scheidingsteken voor duizendtallen opgeeft. Bij weglating wordt gebruikgemaakt van de waarde voor de variabele ThousandSep die is ingesteld in het load-script voor gegevens. De functie Num# ondersteunt vele opties voor het scheidingsteken voor duizendtallen: Punt ' . ': gebruikt een punt als scheidingsteken voor duizendtallen (gebruikelijk in sommige Europese notaties), wordt weergegeven als $1.000,00 indien gecombineerd met een komma als scheidingsteken voor decimalen. Spatie ' ': gebruikt een spatie voor het scheidingsteken voor duizendtallen, wat gebruikelijk is in sommige Europese landen. Wordt weergegeven als € 1 000.00. Onderstrepingsteken '_': gebruikt een onderstrepingsteken voor het scheidingsteken voor duizendtallen, dat soms wordt gebruikt in technische of specifieke regionale notaties. Geeft waarden weer zoals $1_000.00. Ga voor meer informatie naar ThousandSep.

Voorbeeld: diagramuitdrukkingen
Voorbeeld	Resultaten (geretourneerde tekenreekswaarde)
Num#( '35,648.31', '#', '.' , ',' )	Retourneert een tekenreeks van 35,648.31 en numerieke waarde van 35648.31.
Num#( ‘35 648.312’, '#', '.' , ',' )	Retourneert een tekenreeks van 35 648.312 en numerieke waarde van 35648.312.
Num#( '35.648,3123', '#', '.' , ',' )	Retourneert een tekenreeks van 35.648,3123 en numerieke waarde van NULL (- ).
Num#( '35 648,31234', '#', '.' , ',' )	Retourneert een tekenreeks van 35 648,31234 en numerieke waarde van NULL (- ).
Num#('1,234.56', '#,##0.00')	Retourneert een tekenreeks van 1,234.56 en numerieke waarde van 1230.45.
Num#('$1,230.45', '$#,##0.00')	Retourneert een tekenreeks van $1,230.45 en numerieke waarde van 1234.56.
Num#('20220315', 'YYYYMMDD')	Retourneert een tekenreeks van 20220315 en numerieke waarde van 20220315.

Voorbeeld - Basisprincipes voor Num#

Overzicht

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

Een gegevensverzameling die wordt geladen in een tabel met de naam Example.
De volgende velden in de gegevenstabel:
- ProductID
- ProductName
- SalesAmount
De standaardinstellingen voor ThousandSep en DecimalSep om dit voorbeeld te illustreren.
Een voorgaande lading die de functie Num# gebruikt. Wanneer het wordt uitgevoerd, maakt het een extra veld genaamd FormattedSalesAmount.

Load-script

SET ThousandSep=',';
SET DecimalSep='.';
Example:
LOAD
ProductID,
ProductName,
SalesAmount,
Num#(SalesAmount, '#.##0,00',',','.') AS FormattedSalesAmount
INLINE [
ProductID, ProductName, SalesAmount
1, Product A, '1.234,56'
2, Product B, '2.456,78'
3, Product C, '345,67'
4, Product D, '987,12'
5, Product E, '1.200,45'
];

Resultaten

Laad de gegevens en open een werkblad. Maak een nieuwe tabel en voeg deze velden toe als dimensies:

ProductID
ProductName
SalesAmount
FormattedSalesAmount

Maak de volgende meting:

=Num(FormattedSalesAmount), om de numerieke waarde van het veld weer te geven volgens de systeeminstellingen voor de getalnotatie.

Results table
ProductID	ProductName	SalesAmount	FormattedSalesAmount	Num(FormattedSalesAmount)
1	Product A	1.234,56	1.234,56	1234.56
2	Product B	2.456,78	2.456,78	2456.78
3	Product C	345,67	345,67	345.67
4	Product D	987,12	987,12	987.12
5	Product E	1.200,45	1.200,45	1200.45

In dit voorbeeld kunt u zien hoe de functie Num# gegevens van SalesAmount van de oorspronkelijke opmaak van tekst omzet in een numerieke waarde.

Voorbeeld – Scenario met Num#

Overzicht

Een gegevensverzameling bevat verkoopgegevens van verschillende landen in verschillende tekstopmaak. We willen de gegevens standaardiseren en in een tabel weergeven.

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

Een gegevensverzameling die wordt geladen in een tabel met de naam Example.
De volgende velden in de gegevenstabel:
- Country
- Product
- Amount
Een voorgaande lading die de functie Num# gebruikt om de waarden in het veld Amount om te zetten.

Load-script

Example:
LOAD
Country,
Product,
IF(Country = 'Germany', Num#(Amount, '#.##0,00', ',', '.'), Num#(Amount, '#,##0.00')) AS Amount
INLINE [
Country, Product, Amount
Germany, Product A, '1.234,56'
USA, Product B, '2,345.78'
Germany, Product C, '987,12'
USA, Product D, '1,200.45'
Germany, Product E, '345,67'
];

Resultaten

Laad de gegevens en open een werkblad. Maak een nieuwe tabel en voeg deze velden toe als dimensies:

Product
Country
Amount

Maak de volgende meting:

Num(Amount), om de numerieke waarde van het veld Amount weer te geven volgens de systeeminstellingen voor de getalnotatie.

Results table
Product	Country	Amount	Num(Amount)
Customer A	Germany	1.234,56	1234.56
Customer B	USA	2,345.78	2345.78
Customer C	Germany	987,12	987.12
Customer D	USA	1,200.45	1200.45
Customer E	Germany	345,67	345.67

Wanneer u de kolom Amount vergelijkt met de kolom Num(Amount), ziet u dat de gegevens die worden gepresenteerd met de functie Num# de onderliggende numerieke waarden wijzigen, maar de tekenreeksopmaak ongewijzigd laten. Bijvoorbeeld, alle waarden voor Germany in de kolom Amount gebruiken een komma als scheidingsteken voor decimalen, maar de onderliggende opmaak in Num(Amount) gebruikt een punt voor alle waarden.

Was deze pagina nuttig?

Als u problemen ervaart op deze pagina of de inhoud onjuist is – een typfout, een ontbrekende stap of een technische fout – laat het ons weten zodat we dit kunnen verbeteren!

Geef hier uw feedback