String()

Funktionsreferenz Konvertiert Daten in eine Zeichenfolge, die gemäß einer angegebenen Formatmaske formatiert ist. Sie können Datums-, DateTime-, numerische und Zeitdaten konvertieren und formatieren.

String ( data {, format } )

Argument	Beschreibung
data	Die Daten, die als Zeichenfolge mit der angegebenen Formatierung zurückgegeben werden sollen. Die Daten können den Datentyp Datum, DateTime, numerisch, Zeit oder Zeichenfolge haben.
format (optional)	Eine Zeichenfolge mit den Anzeigemasken, die Sie zum Formatieren der Daten verwenden möchten. Die Masken bestehen aus Formatierungsangaben, die für den Datentyp von data spezifisch sind. Wenn data vom Typ Zeichenfolge ist, ist format erforderlich. Die Formatzeichenfolge kann je nach Datentyp von data aus mehreren Masken bestehen. Die Masken werden jeweils durch ein Semikolon getrennt. Einzelheiten zu den einzelnen Datentypen finden Sie unter „Verwendung“.

Datentyp: String Gibt die Daten im angegebenen Format zurück, wenn der Vorgang erfolgreich ist, und die leere Zeichenfolge (‘’), wenn der Datentyp von data nicht zum Typ der angegebenen Anzeigemaske passt oder format keine gültige Maske ist.

Format

Wenn Sie für Datums-, DateTime-, numerische und Zeitdaten kein Format angeben, wird für die zurückgegebene Zeichenfolge das Standardformat des Systems verwendet. Für numerische Daten ist das Standardformat das Format [General]. Für Zeichenfolgendaten ist eine Anzeigeformatmaske erforderlich. (Andernfalls hätte die Funktion nichts zu tun.) Das Format kann aus einer oder mehreren Masken bestehen:

Formate für Datums-, DateTime-, Zeichenfolgen- und Zeitdaten können eine oder zwei Masken enthalten. Die erste Maske ist das Format für die Daten, die zweite Maske das Format für einen Nullwert. Formate für numerische Daten können bis zu vier Masken enthalten. Ein Format mit einer einzigen Maske behandelt sowohl positive als auch negative Daten. Gibt es weitere Masken, gilt die erste Maske für positive Werte und die weiteren Masken für negative Werte, Nullwerte (0) und Nullwerte (null).

Ein Format kann Farbangaben enthalten. Wenn das Anzeigeformat nicht zum Datentyp passt, führt der Versuch, die Maske anzuwenden, zu unvorhersehbaren Ergebnissen.

Beispiel 1

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

Ergibt: Jan 31, 2005

Beispiel 2

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

Ergibt: Jan 31, 2005, 6:8

Beispiel 3

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

Ergibt: 0123, wenn nbr 123 ist, (123), wenn nbr -123 ist, xxxx, wenn nbr 0 ist, empty, wenn nbr null ist

Beispiel 4

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

Ergibt: A-B-C

Beispiel 5

String(ABC, '@*@')

Ergibt: A*B

Beispiel 6

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

Ergibt: ABC

Beispiel 7

String('ABC”, ' ')

Ergibt: ein Leerzeichen

Beispiel 8

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

Ergibt: 6:8

Beispiel 9

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

Ergibt: 08:06:04 pm

Beispiel 10

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

Ergibt: 8:06:04 am:

Beispiel 11

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

Ergibt: 6:11:25.300000