Datum, tijd, nummer en overige opmaak

Staat voor de dag van de maand als een getal van 1 tot 31: 27.

Een waarde met één cijfer wordt weergegeven zonder voorloopnul: 3.

Als deze alleen wordt gebruikt, moet u het voorvoegsel % gebruiken.

Staat voor de dag van de maand als een tweecijferig getal van 01 tot en met 31: 27.

Een waarde met één cijfer wordt weergegeven met een voorloopnul: 03.

Staat voor de maand als een getal van 1 tot en 12: 11.

Een waarde met één cijfer wordt opgemaakt zonder voorloopnul: 5.

Als deze alleen wordt gebruikt, moet u het voorvoegsel % gebruiken.

Staat voor de maand als een getal van twee cijfers van 01 tot en 12: 11.

Een waarde met één cijfer wordt opgemaakt met een voorloopnul: 05.

Staat voor het jaartal als een getal van één of twee cijfers: 23.

Als het jaartal meer dan twee cijfers heeft, verschijnen alleen de laatste twee cijfers in het resultaat. Als u bijvoorbeeld het jaar 2023 opgeeft, verschijnt 23.

Als een tweecijferig jaartal begint met een nul (bijvoorbeeld 02), wordt het getal opgemaakt zonder een voorloopnul: 2.

Staat voor het jaartal als een getal van twee cijfers: 23.

Als het jaartal meer dan twee cijfers heeft, verschijnen alleen de laatste twee cijfers in het resultaat. Als u bijvoorbeeld het jaar 2023 opgeeft, verschijnt 23.

Als het tweecijferige jaartal minder dan twee significante cijfers heeft, wordt het getal opgevuld met voorloopnullen om twee cijfers te bekomen: 02.

Als deze alleen wordt gebruikt, moet u het voorvoegsel % gebruiken.

Staat voor een jaartal met minimaal drie cijfers: 2023.

Als het jaartal meer dan drie significante cijfers heeft, worden ze opgenomen in de resultaatstring. Als het jaartal minder dan drie cijfers heeft, wordt het getal opgevuld met voorloopnullen om drie cijfers te bereiken.

Opmerking: bij de Thaise boeddhistische kalender, die vijfcijferige jaartallen kent, geeft deze notatieaanduiding alle vijf cijfers weer.

Staat voor het jaartal als een getal van vier cijfers: 2023.

Als het jaartal meer dan vier cijfers heeft, verschijnen alleen de laatste vier cijfers in het resultaat. Als het jaartal minder dan vier cijfers heeft, wordt het getal opgevuld met voorloopnullen om vier cijfers te bereiken.

Opmerking: bij de Thaise boeddhistische kalender, die vijfcijferige jaartallen kent, geeft deze notatieaanduiding alle vijf cijfers weer.

Staat voor het jaartal als een vijfcijferig getal.

Als het jaartal meer dan vijf cijfers heeft, verschijnen alleen de laatste vijf cijfers in het resultaat. Als het jaartal minder dan vijf cijfers heeft, wordt het getal opgevuld met voorloopnullen om vijf cijfers te bereiken: 02023.

Als er nog meer dan vijf y-aanduidingen zijn, wordt het getal opgevuld met zoveel voorloopnullen als nodig om het aantal y-aanduidingen te bereiken. Als er bijvoorbeeld acht y-aanduidingen zijn, is de uitvoer 00002023.

Staat voor de periode of het tijdperk, zoals A.D. Het script negeert deze aanduiding als de datum die moet worden opgemaakt geen bijbehorende periode- of tijdperkstring heeft.

Eén g kan niet alleen worden gebruikt. Als u alleen de naam van het tijdperk of periode uitvoert, gebruikt u een dubbele gg.

Vertegenwoordigt het uur als een nummer van 1 tot 12 op een 12-uurs klok die hele uren telt sinds middernacht of 's middags.

Een bepaald uur na middernacht is hierbij niet te onderscheiden van hetzelfde uur na de middag. 1:00 AM is bijvoorbeeld hetzelfde als 1:00 PM.

Het uur wordt niet afgerond en een waarde met één cijfer wordt opgemaakt zonder voorloopnul.

Als deze alleen wordt gebruikt, moet u het voorvoegsel % gebruiken.

Bijvoorbeeld: voor de tijd 5:43 toont deze aangepaste notatieaanduiding 5.

Vertegenwoordigt het uur als een tweecijferig nummer van 01 tot 12 op een 12-uurs klok die hele uren telt sinds middernacht of 's middags.

Een bepaald uur na middernacht is hierbij niet te onderscheiden van hetzelfde uur na de middag. 1:00 AM is bijvoorbeeld hetzelfde als 1:00 PM.

Het uur wordt niet afgerond en een waarde met één cijfer wordt opgemaakt met een voorloopnul.

Bijvoorbeeld: voor de tijd 5:43 toont deze aangepaste notatieaanduiding 05.

Vertegenwoordigt het uur als een nummer van 0 tot 23 op een 24-uurs klok die de uren telt sinds middernacht.

Een waarde met één cijfer wordt opgemaakt zonder voorloopnul.

Bijvoorbeeld: voor de tijd 17:43 toont deze aangepaste notatieaanduiding 17.

Als deze alleen wordt gebruikt, moet u het voorvoegsel % gebruiken.

Vertegenwoordigt het uur als een tweecijferig nummer van 00 tot 23 op een 24-uurs klok die de uren telt sinds middernacht.

Een waarde met één cijfer wordt opgemaakt met een voorloopnul.

Bijvoorbeeld: voor de tijd 17:43 toont deze aangepaste notatieaanduiding 17.

Staat voor het aantal minuten als een getal van 0 tot 59.

Dit is het aantal hele minuten dat is verstreken sinds het afgelopen uur. Een waarde met één cijfer wordt opgemaakt zonder voorloopnul.

Bijvoorbeeld: voor de tijd 05:43:34 toont deze aangepaste notatieaanduiding 43.

Als deze alleen wordt gebruikt, moet u het voorvoegsel % gebruiken.

Staat voor het aantal minuten als een tweecijferig getal van 00 tot en met 59.

Dit is het aantal hele minuten dat is verstreken sinds het afgelopen uur. Een waarde van één cijfer wordt opgemaakt met een voorloopnul.

Bijvoorbeeld: voor de tijd 05:03 toont deze aangepaste notatieaanduiding 03.

Staat voor de seconden als een getal van 0 tot 59.

Dit is het aantal hele seconden dat is verstreken sinds de afgelopen minuut. Een waarde met één cijfer wordt opgemaakt zonder voorloopnul.

Bijvoorbeeld: voor de tijd 05:43 toont deze aangepaste notatieaanduiding 4.

Als deze alleen wordt gebruikt, moet u het voorvoegsel % gebruiken.

Staat voor de seconden als een getal van twee cijfers van 00 tot 59.

Dit is het aantal hele seconden dat is verstreken sinds de afgelopen minuut. Een waarde met één cijfer wordt opgemaakt met een voorloopnul.

Bijvoorbeeld: voor de tijd 05:43 toont deze aangepaste notatieaanduiding 04.

Staat voor een aantal cijfers van de secondenfractie. f-aanduidingen voor kleine letters omvatten de achterliggende nullen. F-aanduidingen van hoofdletters laten achterliggende nullen weg.

Deze aanduiding werkt alleen met datum/tijden van OLE-automatisering Een manier om datums en tijden weer te geven als drijvendekommagetallen. Duidt het aantal dagen sinds 30 december 1899 aan..

Het aantal opgenomen f- of F-tekens bepaalt hoeveel significante cijfers van de tweede breuk moeten worden opgenomen:

• F: tienden van een seconde of het e meest significante cijfer. Als het cijfer nul is, wordt er niets weergegeven.
• ff of FF: honderdsten van een seconde of twee significante cijfers.
• fff of FFF: honderdsten van een seconde of drie significante cijfers. Dit wordt ook milliseconden genoemd.
• ffff of FFFF: tienduizendsten van een seconde of vier significante cijfers.
• fffff of FFFFF: honderdduizendsten van een seconde of vijf significante cijfers.
• ffffff of FFFFFF: miljoensten van een seconde of zes significante cijfers.
• FFFFFFF: tienmiljoensten van een seconde of zeven significante cijfers.

Hoe meer precisie u opgeeft, hoe minder betrouwbaar of betekenisvol dit kan zijn. De nauwkeurigheid van tijdwaarde is afhankelijk van de resolutie van de systeemklok van de computer.

Staat voor het eerste teken van de AM/PM-aanduiding. De AM-aanduiding wordt gebruikt als het uur minder dan 12 is. Anders wordt de PM-aanduiding gebruikt.

Voor talen die een AM/PM-aanduiding hebben waarbij het eerste teken en het tweede teken veranderen, gebruikt u de tt-aanduiding.

Als deze alleen wordt gebruikt, moet u het voorvoegsel % gebruiken.

Staat voor de AM/PM-aanduiding. De AM-aanduiding wordt gebruikt als het uur minder dan 12 is. Anders wordt de PM-aanduiding gebruikt.

Gebruik de tt-aanduiding voor talen, zoals Japans, die een AM/PM-aanduiding gebruiken waarbij het eerste teken hetzelfde is en het tweede teken verandert.

Staat voor de ondertekende offset van de tijdzone van het lokale besturingssysteem vanaf de Gecoördineerde Universele Tijd (UTC). Het aantal z-tekens bepaalt hoeveel offset er is om weer te geven:

• z, zz: meet de offset in uren.
• zzz: meet de offset in uren en minuten.

De offset wordt altijd weergegeven met een voorliggend teken. Een plusteken (+) geeft het aantal uren aan dat de tijd voorloopt op UTC; een minteken (-) geeft het aantal uren aan dat de tijd achterloopt op UTC. De offset varieert van -12 tot +13. Een waarde met één cijfer wordt opgemaakt met een voorloopnul.

Als deze alleen wordt gebruikt, moet u het voorvoegsel % gebruiken.

Het getal wordt geconverteerd naar een string die een valutabedrag voorstelt. Neem een nummer op met de notatieaanduiding om het aantal cijfers na de komma's aan te geven. De tekengrootte van de notatieaanduiding heeft geen invloed op de resultaten.

ASSIGN StringVal = "0013001.93912837"
ASSIGN CurrencyResult = "{StringVal.format('C')}"
ASSIGN CurrencyResult3 = "{StringVal.format('C3')}"

Resultaat:

CURRENCYRESULT=$13,001.94

CURRENCYRESULT3=$13,001.939

E0

E-0

e0

e+0

e-0

Het getal wordt omgezet in een string van de vorm -d.ddd…E+ddd of -d.ddd…e+ddd, waarbij elke deen cijfer voorstelt (0-9). De string begint met een minteken als het getal negatief is. Er staat altijd één cijfer voor de komma.

Neem een nummer op met de notatieaanduiding om het aantal cijfers na de komma's aan te geven. Als u geen notatieaanduiding opneemt, gebruikt het script standaard zes cijfers na de komma.

De tekengrootte van de notatieaanduiding geeft aan of de exponent in de uitvoer wordt voorafgegaan door een E of een e. De exponent bestaat altijd uit een plus- of minteken en minimaal drie cijfers. De exponent wordt zo nodig aangevuld met voorloopnullen.

Als een van de strings E, E+, E-, e, e+ of e- aanwezig is in opmaakstring en onmiddellijk wordt gevolgd door minimaal één 0-teken, dan wordt het getal opgemaakt volgens de wetenschappelijke notatie met een E of e tussen het getal en de exponent.

Het aantal 0-tekens na de aanduiding voor de wetenschappelijke notatie bepaalt het minimum aantal cijfers dat voor de exponent moet worden gebruikt. De aanduidingen E+ en e+ en geven aan dat een tekensymbool (plus of min) altijd vóór de exponent moet staan. De notatie E, E-, e of e- geven aan dat een "E", "E-", "e" of geven aan dat een tekensymbool alleen mag worden gebruikt voor negatieve exponenten.

 ASSIGN StringVal = "0013001.93912837"
ASSIGN ScientificResult = "{StringVal.format('e')}"		
ASSIGN ScientificResult = "{StringVal.format('E2')}"	

Resultaat:

SCIENTIFICRESULT=1.300194e+004

SCIENTIFICRESULT2=1.300194E+004

Het getal wordt omgezet in een string van de vorm -ddd.ddd… waar elke d een cijfer (0-9) voorstelt. De string begint met een minteken als het getal negatief is.

Neem een nummer op met de notatieaanduiding om aan te geven hoeveel cijfers na de komma's het resultaat volgens u moet hebben. Zonder de precisie-indicator, wordt het script standaard ingesteld op twee cijfers na de komma.

ASSIGN StringVal = "0013001.93912837"
ASSIGN FixedPointResult = "{StringVal.format('F3')}"
ASSIGN FixedPointResult2 = "{StringVal.format('f')}"

Resultaat:

FIXEDPOINTRESULT=13001.939

FIXEDPOINTRESULT2=13001.94

Het getal wordt naar het meest compacte, of naar de fixed-point of wetenschappelijke notatie geconverteerd, afhankelijk van het type nummer en of een precisieaanduiding is inbegrepen. Als de precisieaanduiding wordt weggelaten of nul is, bepaalt het type van het getal de standaardprecisie volgens de onderstaande lijst:

• Byte of SByte: 3
• Int16 of UInt16: 5
• Int32 or UInt32: 10
• Int64 or UInt64: 19
• Enkel: 7
• Dubbel: 15
• Decimaal: 29

De fixed-point notatie wordt gebruikt als de exponent van het getal in de wetenschappelijke notatie groter zou zijn dan -5 en kleiner dan de precisieaanduiding; anders wordt de wetenschappelijke notatie gebruikt. Het resultaat bevat een decimaalteken indien vereist en achterliggende nullen worden weggelaten.

Als de precisieaanduiding aanwezig is en het aantal significante cijfers in het resultaat de opgegeven precisie overschrijdt, worden de overtollige cijfers aan het einde verwijderd door middel van afronding. Er geldt een uitzondering op deze regel als het getal een decimaal getal is en de precisieaanduiding is weggelaten. In dat geval wordt altijd de fixed-point notatie gebruikt en blijven de achterliggende nullen behouden.

Als de wetenschappelijke notatie wordt gebruikt, wordt de exponent in het resultaat voorafgegaan door E als de notatieaanduiding G is, of door e als de notatieaanduiding g is.

ASSIGN StringVal = "0013001.93912837"
ASSIGN GeneralResult1 = "{StringVal.format('G')}"
ASSIGN StringVal2 = 6002348902348890234.234432234
ASSIGN GeneralResult2 = "{StringVal2.format('G')}"

Resultaat:

GENERALRESULT1=13001.93912837

GENERALRESULT2=6.00234890234889E+18

Deze indeling wordt alleen ondersteund voor integer-typen. Het getal wordt omgezet in een reeks hexadecimale cijfers. De notatieaanduiding geeft aan of hoofdletters of kleine letters moeten worden gebruikt voor de hexadecimale cijfers groter dan 9. Gebruik bijvoorbeeld X om ABCDEF te produceren en x om abcdef te produceren.

De precisieaanduiding geeft het minimum aantal cijfers in de resulterende string aan. Indien nodig wordt het getal met voorloopnullen aangevuld om het aantal cijfers te verkrijgen dat door de precisieaanduiding wordt voorgeschreven.

Het getal wordt omgezet in een reeks van de vorm -d,ddd,ddd.ddd…, waarbij:

• Het minteken ( - ) een negatief cijfersymbool aangeeft indien vereist.
• Elke d staat voor een cijfer (0-9).
• Een komma ( , ) geeft een scheidingsteken voor duizendtallen aan tussen nummergroepen.
• Het punt ( . ) geeft een scheidingsteken voor decimalen aan.

Neem een precisieaanduiding op om het aantal cijfers na de komma's aan te geven dat u wilt toepassen op het resultaat. Als er geen precisieaanduiding is opgenomen, wordt deze standaard ingesteld op twee cijfers na de komma. Als het cijfer geen decimaalteken bevat, wordt .00 toegevoegd aan het uitvoernummer.

ASSIGN StringVal = "0013001.93912837"
ASSIGN NumberResult = StringVal.format('N')
ASSIGN NumberResult2 = "{StringVal.format('n2')}"

Resultaat:

NUMBERRESULT=13,001.94

NUMBERRESULT2=13,001.9391

Het getal wordt geconverteerd naar een string die een percentage voorstelt. Het geconverteerde getal wordt vermenigvuldigd met 100 om als percentage te worden gepresenteerd.

Neem een precisieaanduiding op om het aantal cijfers na de komma's aan te geven dat u wilt toepassen op het resultaat. Als er geen precisieaanduiding is opgenomen, wordt deze standaard ingesteld op twee cijfers na de komma. Als het cijfer geen decimaalteken bevat, wordt .00 toegevoegd aan het uitvoernummer.

ASSIGN StringVal = "0013001.93912837"
ASSIGN PercentResult = "{StringVal.format('P')}"
ASSIGN PercentResult2 = StringVal.format('P2')	

Resultaat:

PERCENTRESULT=1,300,193.91%

PERCENTRESULT2=1,300,193.91%

Deze notatieaanduiding werkt alleen voor de typen Single en Double. De retour-aanduiding garandeert dat een numerieke waarde die is geconverteerd naar een string, terug wordt geconverteerd naar dezelfde numerieke waarde. Wanneer een numerieke waarde wordt opgemaakt volgens deze aanduiding, wordt de waarde eerst getest met de algemene getalnotatie, met 15 precisieplaatsen voor een Double-getal en 7 precisieplaatsen voor een Single-getal. Als de waarde met succes terug wordt geconverteerd naar dezelfde numerieke waarde, wordt de waarde opgemaakt volgens de algemene notatieaanduiding. Als de waarde echter niet terug wordt geconverteerd naar dezelfde numerieke waarde, dan wordt de waarde opgemaakt met behulp van 17 precisieplaatsen voor een Double-getal en 9 precisieplaatsen voor een Single-getal.

Hoewel er een precisieaanduiding aanwezig kan zijn, wordt deze genegeerd. Retour-aanduidingen hebben voorrang boven de precisie bij gebruik van deze aanduiding.

ASSIGN StringVal = "0013001.93912837"
ASSIGN RoundTripResult = "{StringVal.format('R')}"	

Resultaat:

ROUNDTRIPRESULT=13001.93912837

Gebruik één of meer 0-plaatshouders om de opmaak te definiëren voor cijfers in de uitvoer. U kunt deze plaatshouder combineren met de andere tekens van de plaatshouder die in deze tabel is gedefinieerd.

Als de waarde die wordt opgemaakt, een cijfer bevat op de positie waar 0 verschijnt in de opmaakstring, verschijnt dit cijfer in de uitvoerstring. Als er geen cijfer verschijnt in de positie waar een 0 verschijnt in de opmaakstring, verschijnt 0 in plaats daarvan in de uitvoerstring. Dit kan handig zijn om nullen toe te voegen aan een cijfer dat voorloopnullen vereist, maar er geen heeft.

De positie van de meest linkse '0' vóór de komma en de meest rechtse '0' achter de komma bepalen het bereik van cijfers die altijd aanwezig zullen zijn in de uitvoerstring.

De 00-aanduiding zorgt dat de waarde wordt afgerond naar het dichtstbijzijnde gehele getal.

ASSIGN number = "2343456.2343"
ASSIGN zeroPlaceholders = "number.format(000,000.00)
ASSIGN number = "456.47"
ASSIGN doubleZeroSpecifier = number.format('00')

Het resultaten van het voorbeeld zijn:

zeroPlaceholders = 2,343,456.23

doubleZeroSpecifier = 456

Gebruik één of meer cijfer-plaatshouders om de opmaak te definiëren voor cijfers in de uitvoer. U kunt deze plaatshouder combineren met de andere tekens van de plaatshouder die in deze tabel is gedefinieerd.

Als de waarde die wordt opgemaakt, een cijfer bevat op de positie waar een # verschijnt in de opmaakstring, verschijnt dit cijfer in het uitvoerresultaat. Als er geen cijfer verschijnt in de positie waar een # verschijnt in de opmaakstring, is die plaats leeg in de uitvoerstring.

Als het cijfer dat wordt opgemaakt, een 0 bevat als een significant cijfer, verschijnt 0 in de uitvoerstring. Als de 0 geen significant cijfer is, verschijnt het niet in de uitvoerstring, zelfs als 0 het enige cijfer in de string is dat moet worden opgemaakt.

De ##-opmaakstring zorgt dat de waarde wordt afgerond naar het dichtstbijzijnde gehele getal.

ASSIGN number = "2343456.2043"
ASSIGN digitPlaceholders = "number.format(###,###.##)
ASSIGN number = "456.47"
ASSIGN doubleDigitSpecifier = number.format('##')

Het resultaten van het voorbeeld zijn:

digitPlaceholders = 2.343.456,2

doubleDigitSpecifier = 456

Het eerste punt ( . ) in de opmaakstring bepaalt de locatie van het decimale scheidingsteken in de opgemaakte waarde. Eventuele extra punten worden genegeerd.

De komma (,) specificeert het scheidingsteken voor duizendtallen en de getalaanpassing.

Scheidingsteken voor duizendtallen: als er een of meer komma's (,) worden opgegeven tussen twee cijfer-plaatshouders (0 of #) die het integer-gedeelte van een getal opmaken, wordt een groepscheidingsteken ingevoegd tussen elke cijfergroep in het integer-gedeelte van de uitvoer. Bijvoorbeeld: als de string #,# en de InvariantCulture-eigenschap worden gebruikt om het getal 1000 op te maken, is de uitvoer 1.000.

Getalaanpassing: als er een of meer punten (,) onmiddellijk links van het expliciete of impliciete decimaalteken aanwezig zijn, wordt het getal dat moet worden opgemaakt, één keer gedeeld door 1000 voor elk getalaanpassingsteken. Als u bijvoorbeeld de string 0,, gebruikt om het getal 100 miljoen op te maken, is de uitvoer 100.

U kunt een scheidingsteken voor duizendtallen en getalaanpassingstekens in dezelfde opmaakstring gebruiken. Bijvoorbeeld: als de string #,0,, en de InvariantCulture-eigenschap worden gebruikt om het getal 1 miljard op te maken, is de uitvoer 1,000.

Hiermee kunt u twee of drie mogelijke opmaakopties voor getallen definiëren. De opmaak wordt toegepast, afhankelijk of het nummer positief, negatief of nul is.

De opmaakopties zijn gedefinieerd in één string. Elke optie is gescheiden door een puntkomma ( ; ). Gebruik de nul, cijfer, duizendtallen en decimaal-plaatshouders om de opmaak te definiëren, zoals weergegeven in de onderstaande voorbeelden Deze plaatshouders zijn beschreven in deze tabel.

Als er twee secties zijn in de string met de aangepaste indeling:

• De linkersectie definieert de opmaak van positieve en nul-nummers.
• De rechtersectie definieert de opmaak van negatieve nummers.

Voorbeeld:

ASSIGN number9 = 928374
ASSIGN sectionSeparator4 = number9.format('000,000.##;00.##')

ASSIGN number10 = -998822.25
ASSIGN sectionSeparator5 = number10.format('000,000.##;00.##')

ASSIGN number11 = 0
ASSIGN sectionSeparator6 = number11.format('000,000.##;00.##')	

Het resultaten van het voorbeeld zijn:

sectionSeparator4 = 928,374

sectionSeparator5 = 998822.25

sectionSeparator6 = 000,000

Als er drie secties zijn:

• De linkersectie definieert de opmaak van positieve nummers
• De middelste sectie definieert de opmaak van negatieve nummers.
• De rechtersectie definieert de opmaak van nul-nummers.

Voorbeeld:

ASSIGN number1 = 1789789
ASSIGN sectionSeparator1 = number1.format('000,000.##;00.##;000.0000')

ASSIGN number2 = 0
ASSIGN sectionSeparator2 = number2.format('000,000.##;00.##;000.0000')

ASSIGN number3 = -4321
ASSIGN sectionSeparator3 = number3.format('000,000.##;00.##;000.0000')

Het resultaten van het voorbeeld zijn:

sectionSeparator1 = 1,789,789

sectionSeparator2 = 000.0000

sectionSeparator3 = 4321

Alle overige tekens

Elk ander teken wordt ongewijzigd naar de resultaatstring gekopieerd en heeft geen invloed op de opmaak.

Gebruik dit om een voorvoegsel aan een string die een escape-reeks bevat, toe te voegen. Het $ teken moet buiten de dubbele aanhalingstekens staan. Voorbeeld:

z = $"Use the \{myVar} variable."

Gebruik dit om een voorvoegsel toe te voegen aan een waarde om het te declareren als een datum/tijd-type. Het teken # moet buiten de dubbele aanhalingstekens staan. Voorbeeld:

ASSIGN var = #"02/09/2023"