String

4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente

versión 11 (Modificado)


String (expresion{; formato}) Cadena

ParámetroTipoDescripción
expresionExpresión a convertir en cadena
(puede ser de tipo Real, Entero, Entero largo, Fecha,
Hora, Alfa, Texto o Booleana)
formatoAlfa | NumFormato de visualización
ResultadoCadenaExpresió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:

EjemploResultado
String(2^15) ` Utilizar formato por defecto32768 (formato por defecto)
String(2^15;"###,##0 habitantes")32,768 habitantes
String(1/3;"##0.00000")0.33333
String(1/3) ` Utilizar formato por defecto0.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úmeroConstante 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 special12/29/06 o 12/29/1896 o 12/29/2096
5 Internal date long 29 diciembre 2006
6 Internal date abbreviated 29 dic 2006
7Internal date short12/29/2006
8ISO Date Time2006-12-29T00:00:00
100Blank 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;Internal date long)   ` $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úmeroConstante 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 SS62:03
7Min Sec62 minutos 3 segundos
8ISO Date Time0000-00-00T01:02:03
9System time short01:02:03
10System time long abbreviated10203 AM (Mac únicamente)
11System time long1:02:03 AM HNEC (Mac únicamente)
100Blank 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.


4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente