Num - script- en diagramfunctie
Num() geeft de opmaak van een getal, wat wil zeggen dat deze functie de numerieke waarde van de invoer converteert naar tekst 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(number[, 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 numerieke waarde van de invoeruitdrukking en genereert een tekenreeks die het getal vertegenwoordigt.
Argument | Beschrijving |
---|---|
number | De teksttekenreeks die moet worden geëvalueerd. |
format | Tekenreeks die specificeert hoe de resulterende tekenreeks moet worden opgemaakt. 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. |
Zie Conventies voor getal- en tijdnotaties voor meer informatie over getalnotaties.
Voorbeeld | Resultaten (geretourneerde tekenreekswaarde) |
---|---|
Num(35648.312) | Retourneer 35648.312 (afhankelijk van omgevingsvariabelen in het script) |
Num(35648.312, '0.0', '.') | Retourneert 35648.3 |
Num(35648.312, '0,00', ',') | Retourneert 3,56,48 |
Num(35648.312, '#,##0.0', '.', ',') | Retourneert 35,648.3 |
Num(35648.312, '# ##0', ',', ' ') | Retourneert 35 648 |