String()

Functiereferentie Converteert gegevens naar een tekenreeks die is opgemaakt volgens een opgegeven opmaakmasker. U kunt gegevens van het type date, DateTime, numeriek en time converteren en opmaken.

String ( data {, format } )

Argument	Beschrijving
data	De gegevens die u als tekenreeks met de opgegeven opmaak wilt terugkrijgen. Data kan het gegevenstype date, DateTime, numeriek, time of string hebben.
format (optioneel)	Een tekenreeks met de weergavemaskers die u wilt gebruiken om de gegevens op te maken. De maskers bestaan uit opmaakinformatie die specifiek is voor het gegevenstype van data. Als data van het type string is, is format verplicht. De opmaaktekenreeks kan uit meer dan één masker bestaan, afhankelijk van het gegevenstype van data. Maskers worden van elkaar gescheiden door een puntkomma. Zie Gebruik voor details over elk gegevenstype.

Gegevenstype: String Retourneert de gegevens in de opgegeven opmaak als dit lukt, en de lege tekenreeks (‘’) als het gegevenstype van data niet overeenkomt met het type van het opgegeven weergavemasker of als format geen geldig masker is.

Opmaak

Voor gegevens van het type date, DateTime, numeriek en time wordt de standaardopmaak van het systeem gebruikt voor de geretourneerde tekenreeks als u geen opmaak opgeeft. Voor numerieke gegevens is de standaardopmaak de opmaak [General]. Voor gegevens van het type string is een weergavemasker verplicht. (Anders zou de functie niets te doen hebben.) De opmaak kan uit een of meer maskers bestaan:

Opmaak voor gegevens van het type date, DateTime, string en time kan een of twee maskers bevatten. Het eerste masker is de opmaak voor de gegevens; het tweede masker is de opmaak voor een null-waarde. Opmaak voor numerieke gegevens kan maximaal vier maskers bevatten. Een opmaak met één masker verwerkt zowel positieve als negatieve gegevens. Als er extra maskers zijn, is het eerste masker voor positieve waarden en zijn de extra maskers voor negatieve waarden, nulwaarden en null-waarden.

Een opmaak kan kleurspecificaties bevatten. Als de weergaveopmaak niet overeenkomt met het gegevenstype, levert de poging om het masker toe te passen onvoorspelbare resultaten op.

Voorbeeld 1

String(Date('2005-01-31'), 'mmm dd, yyyy)

Retourneert: Jan 31, 2005

Voorbeeld 2

String(DateTime('2005-01-31 06:08:00.63534'), 'mmm dd, yyyy, h:m')

Retourneert: Jan 31, 2005, 6:8

Voorbeeld 3

String(nbr, '0000;(000);xxxx;empty')

Retourneert: 0123 als nbr 123 is, (123) als nbr -123 is, xxxx als nbr 0 is, empty als nbr null is

Voorbeeld 4

String('ABC', '@-@-@')

Retourneert: A-B-C

Voorbeeld 5

String(ABC, '@*@')

Retourneert: A*B

Voorbeeld 6

String('ABC', '@@@')

Retourneert: ABC

Voorbeeld 7

String('ABC”, ' ')

Retourneert: een spatie

Voorbeeld 8

String(Time('06:08:02.9986'),'h:m')

Retourneert: 6:8

Voorbeeld 9

String(Time('20:06:04'), 'hh:mm:ss am/pm')

Retourneert: 08:06:04 pm

Voorbeeld 10

String(Time('08:06:04'), 'h:mm:ss am/pm')

Retourneert: 8:06:04 am:

Voorbeeld 11

String(Time('6:11:25.300000', 'h:mm:ss.ffffff')

Retourneert: 6:11:25.300000