|
|
|
|
|
|
|
|
|
|
|
versión 11 (Modificado)
String (expresion{; formato}) 
Cadena
| Parámetro | Tipo | Descripción | |
| expresion | | Expresión a convertir en cadena | |
| (puede ser de tipo Real, Entero, Entero largo, Fecha, | |||
| Hora, Alfa, Texto o Booleana) | |||
| formato | Alfa | Num | | Formato de visualización |
| Resultado | Cadena |  | Expresión convertida en cadena alfanumérica |
Descripción
El comando String devuelve en forma de cadena alfanumérica la expresión de tipo numérico, Fecha, Hora, cadena o Booleana que se pasa en expresion.
Si no pasa el parámetro opcional formato, la cadena se devuelve en el formato por defecto del tipo de datos correspondiente. Si pasa formato, puede definir el formato de la cadena resultante.
Expresiones numéricas
Si expresion es una expresión numérica (Real, Entero, Entero largo), puede pasar el formato de la cadena opcional. Estos son algunos ejemplos:
| Ejemplo | Resultado |
| String(2^15) ` Utilizar formato por defecto | 32768 (formato por defecto) |
| String(2^15;"###,##0 habitantes") | 32,768 habitantes |
| String(1/3;"##0.00000") | 0.33333 |
| String(1/3) ` Utilizar formato por defecto | 0.3333333333333333 (formato por defecto) |
| String(Arctan(1)*4) | 3.1415926535897931 (formato por defecto) |
| String(Arctan(1)*4;"##0.00") | 3.14 |
| String(-1;"&x") | 0xFFFFFFFF |
| String(-1;"&$") | $FFFFFFFF |
| String(0 ?+ 7;"&x") | 0x80 |
| String(0 ?+ 7;"&$") | $80 |
| String(0 ?+ 14;"&x") | 0x4000 |
| String(0 ?+ 14;"&$") | $4000 |
| String(Num(1=1);"True;;False") | True |
| String(Num(1=2);"True;;False") | False |
El formato se especifica de la misma forma que para un campo numérico en un formulario. Para mayor información sobre formatos numéricos, consulte el manual de Diseño. Igualmente puede pasar el nombre de un estilo personalizado en formato. El nombre del estilo personalizado debe estar precedido por el carácter "|".
Expresiones de tipo Fecha
Si expresion es de tipo Fecha, la cadena se devuelve en el formato por defecto definido en el sistema.
En el parámetro formato, puede pasar una de las siguientes constantes del tema "Date Display Formats"):
| Número | Constante | Ejemplo |
| 1 | System date short | 12/29/2006 |
| 2 | System date abbreviated | mierc. 29 dic. 2006 |
| 3 | System date long | miércoles 29 diciembre 2006 |
| 4 | Internal date short special | 12/29/06 o 12/29/1896 o 12/29/2096 |
| 5 | Internal date long | 29 diciembre 2006 |
| 6 | Internal date abbreviated | 29 dic 2006 |
| 7 | Internal date short | 12/29/2006 |
| 8 | ISO Date Time | 2006-12-29T00:00:00 |
| 100 | Blank if null | "" en lugar de 0 |
Notas:
•El formato ISO Date Time corresponde a la norma ISO8601. Este formato contiene una fecha y una hora. Por ejemplo, la fecha del 31 de mayo de 2006 a la 1:20 p.m. se escribe 2006-05-31T13:20:00. Esto se utiliza para los procesos XML y con servicios Web. 4D no permite almacenar una fecha y hora en un solo campo. Sin embargo, es posible administrar las fechas en este formato utilizando el comando String.
• La constante Blank if null debe añadirse al formato; indica que en caso de un valor nulo 4D debe devolver una cadena vacía en lugar de ceros.
Estos ejemplos asumen que la fecha actual es 12/29/2006:
$vsResult:=String(Current date) ` $vsResult toma el valor "12/29/06" $vsResult:=String(Current date;Month Date Year) ` $vsResult toma el valor "29 diciembre, 2006" $vsResult:=String(Current date;ISO Date Time) ` $vsResult toma el valor "2006-12-29T00:00:00"
Expresiones de tipo Hora
Si expresion es de tipo Hora, la cadena se devuelve utilizando el formato por defecto HH:MM:SS. Puede pasar en el parámetro format una de las siguientes constantes del tema "Time Display Formats"):
| Número | Constante | Ejemplo |
| 1 | HH:MM:SS | 01:02:03 |
| 2 | HH:MM | 01:02 |
| 3 | Hour Min Sec | 1 hora 2 minutos 3 segundos |
| 4 | Hour Min | 1 hora 2 minutos |
| 5 | HH MM AM PM | 1:02 AM |
| 6 | MM SS | 62:03 |
| 7 | Min Sec | 62 minutos 3 segundos |
| 8 | ISO Date Time | 0000-00-00T01:02:03 |
| 9 | System time short | 01:02:03 |
| 10 | System time long abbreviated | 1•02•03 AM (Mac only) |
| 11 | System time long | 1:02:03 AM HNEC (Mac only) |
| 100 | Blank if null | "" en lugar de 0 |
Notas:
• Para mayor información sobre el formato ISO Date Time, consulte la nota anterior.
• La constante Blank if null debe añadirse al formato; indica que en el caso de un valor nulo, 4D debe devolver una cadena vacía en lugar de ceros.
Estos ejemplos asumen que la hora actual 5:30 PM y 45 segundos:
$vsResult:=String(Current time) ` $vsResult toma el valor "17:30:45" $vsResult:=String(Current time;Hour Min Sec) ` $vsResult toma el valor "17 horas 30 minutos 45 segundos"
Expresiones de tipo cadena
Si expresion es de tipo Alfa o Texto, el comando devuelve el mismo valor que se pasa en el parámetro. Esto puede ser útil particularmente en programación genérica utilizando punteros.
En este caso, si se pasa el parámetro formato se ignora.
Expresiones de tipo Booleano
Si expresion es de tipo Booleano, el comando devuelve la cadena "True" o "False" en el lenguaje de la aplicación (por ejemplo, "Vrai" o "Faux" en una versión francesa de 4D).
En este caso si se pasa el parámetro formato, se ignora.
Ver también
Date, Num, Time string.
|
|
|
|
|
|
|
|
|
|
|