CStr
Sintaxis básica y Crystal.
CStr y ToText son funciones equivalentes.
Sobrecargas
- CStr (x)
- CStr (x, y)
- CStr (x, y, z)
- CStr (x, y, z, w)
- CStr (x, y, z, w, q)
Argumentos
| Convirtiendo . . .
| Descripción
|
Valores Booleanos
| - x es un valor Booleano que es convertido a cadena de caracteres, ya sea "Verdadero" o "Falso".
|
Valores Numéricos y de Moneda
| - x es un valor fraccionario o monetario a ser convertido a cadena de caracteres de texto; puede ser un valor entero o fraccionario.
- y es un número entero que indica el número de lugares decimales para llevar el valor en x. (Este argumento es opcional.)
- z es un solo carácter de cadena de caracteres de texto que indica el carácter utilizado para separar los miles en x. En forma predeterminada es el carácter especificado en su panel de control Internacional o Regional. (Este argumento es opcional.)
- w es un sólo carácter de cadena de caracteres de texto que indica el carácter a ser utilizado como separador decimal en x. En forma predeterminada este carácter es especificado en su panel de control Internacional o Regional. (Este argumento es opcional.)
|
Valores numéricos y de moneda (con formato)
| - x es un valor fraccionario o monetario a ser convertido a cadena de texto; puede ser un valor entero o fraccionario.
- y es una cadena de caracteres de texto a ser utilizada para indicar el formato para mostrar el valor en x. Vea Cadenas de formato para información sobre cómo crear una cadena con formato.
- z es un número entero que indica el número de lugares decimales para llevar al valor en x. (Este argumento es opcional.)
- w es un solo carácter de cadena de texto que indica el carácter utilizado para separar los miles en x. En forma predeterminada es el carácter especificado en su panel de control Internacional o Regional. (Este argumento es opcional.)
- q es un solo carácter de cadena de texto que indica el carácter a ser utilizado como separador decimal en x. En forma predeterminada este carácter es especificado en su panel de control Internacional o Regional. (Este argumento es opcional.)
|
Valores de fecha
| |
Valores de hora
| - x es un valor de hora a ser convertido en cadena de caracteres de texto.
- y es una cadena de texto que define cómo va a ser formateado el valor x. Vea Cadenas de formato para valores de fecha, hora, y fecha/hora para información sobre cómo crear una cadena con formato. (Este argumento es opcional.)
- z es una cadena de texto a ser utilizada como una etiqueta para las horas A.M. (mañana). (Este argumento es opcional)
- w es una cadena de texto a ser utilizada como etiqueta para las horas P.M. (tarde). (Este argumento es opcional.)
|
Valores de fecha/hora
| - x es un valor Fecha/hora a ser convertido a cadena de texto.
- y es una cadena de texto que indica cómo va a ser formateada la cadena resultante. Vea Cadenas de formato para valores de fecha, hora, y fecha/hora para información sobre cómo crear una cadena con formato. (Este argumento es opcional.)
- z es una cadena de texto a ser utilizada como etiqueta para las horas A.M. (mañana). (Este argumento es opcional.)
- w es una cadena de texto a ser utilizada como etiqueta para las horas P.M. (tarde). (Este argumento es opcional.)
|
Devuelve
Una cadena de texto.
Acción
La función CStr convierte números fraccionarios, valor monetario, fecha, hora y valores de fecha/hora a cadenas de caracteres de texto.
Uso(s) típico(s)
Utilice está función para convertir un número fraccionario, un valor monetario, de fecha, hora, o de fecha/hora a una cadena de texto para que aparezca como un texto en su informe (formas de carta, comentarios, etc.).
Ejemplo(s)
Los siguientes ejemplos son aplicables a las sintaxis básica y Crystal:
CStr ({Pedidos.Enviados})
Devuelve Verdadero cuando el valor en ({pedidos.ENVIADOS}) es Verdadero.
CStr(123,45)
Devuelve "123.45".
CStr(12345,6749.2)
Devuelve "12345.67".
CStr(12345,6750.2)
Devuelve "12345.68".
CStr(12345,4999,0)
Devuelve "12345".
CStr(12345,5000,0)
Devuelve "12346".
CStr({archivo.MONTO} * {archivo.CANTIDAD})
Devuelve "44,890.20" cuando Monto = 24.45 y Cantidad = 1836.
CStr es útil cuando quiera construir una oración combinando (concatenando) un número convertido u otro valor con otra cadena de texto :
"El precio base del elemento # " + {archivo.NÚMERO DE ELEMENTO} + " es $" + CStr({archivo.PRECIO BASE}) + "."
Imprime la oración "El precio base del elemento A1/4520/B12 es $50.00." cuando el Número de Elemento es A1/4520/B12 y Precio Base es 50.00, convertido a texto y con formato de dos lugares decimales.
CStr(CDate(1996, 11, 1), "aa MMM dd, dddd")
Devuelve "96 Nov 01, Lunes".
CStr(CDateTime(1995,10,12,3,30,11),"HH:mm, aa MMMM ddd")
Devuelve 03:30, Lun. Octubre 95.
CStr(CTime(12, 10, 10), "HH*mm*ss tt", "amStr", "pmStr")
Devuelve "12*10*10 pmStr".
Comentario(s)
Las sobrecargas de CStr que sólo admiten un argumento operan como la función de Visual Basic del mismo nombre.
Convirtiendo valores Booleanos:
- La función CStr, cuando utiliza valores Booleanos, es más útil para combinar (concatenar) un valor Booleano con otro texto. De otra manera, un campo Booleano puede ser formateado para aparecer como Verdadero o Falso en su informe simplemente cambiando el formato en la ficha Booleano del Editor de Formato.
Convirtiendo números fraccionarios y valores monetarios:
- Si el número de lugares decimales es especificado, esta función no trunca el número cuando es convertido a texto, pero lo redondea al número de lugares decimales especificados. Vea Round (x), Round (x, #lugares) para obtener más información sobre el procedimiento de redondeo de Crystal Reports.
Convirtiendo valores de fecha, hora, y fecha/hora:
- Cualquier carácter, a excepción de los caracteres de formato de fecha o de hora, puede ser utilizado dentro de la cadena de formato. Por ejemplo, puede desear utilizar una diagonal para separar diferentes elementos (mes, día, año) de la fecha, como en "12/30/95", o puede desear utilizar dos puntos para separar elementos diferentes (horas, minutos, segundos) de la hora, como en "12:30:10".
- Si desea utilizar cualquiera de los caracteres anteriores en la cadena de formato, deben de aparecer entre comillas. Por ejemplo: CStr(CDateTime(1995,10,12,13,20,22), "MM/dd/aa hh 'h' mm 'min' ss 'sec' ", 'am', 'pm') = "10/12/95 1 h 20 min 22 sec pm"
Argumentos opcionales de paso:
- Varios argumentos para la función CStr han sido especificados como opcionales. De cualquier forma, un argumento no puede estar en blanco si un argumento es suministrado después de que está en la función. En otras palabras, usted no puede dejar los argumentos y y z en blanco y proporcionar un argumento para w. Es posible, de cualquier forma, dejar uno, dos, o todos los argumentos opcionales en blanco, mientras no se suministren argumentos después de los argumentos en blanco. Las siguientes combinaciones son posibles cuando se suministran argumentos a la función CStr:
- CStr (x)
- CStr (x, y)
- CStr (x, y, z)
- CStr (x, y, z, w)
- CStr (x, y, z, w, q)
- Utilizando los caracteres de formato "t" o "tt" en una cadena de formato de tiempo proporciona cadenas predeterminadas para indicar horas a.m. (mañana) y p.m. (tarde). "t" produce un carácter sencillo, "a" o "p", mientras que "tt" produce la cadena completa, "am" o "pm". Usted pueda pasar su propia cadena personalizada para indicar cadenas am/pm. (Vera los argumentos para convertir valores de hora y de fecha/hora con CStr en la sección Argumentos anterior.) Si pasa sus propias cadenas am/pm, los caracteres de formato "t" y "tt" tendrán el mismo efecto en ellos (produciendo cadenas de carácter sencillo contra caracteres múltiples). De cualquier forma los caracteres de formato "t" y "tt" son opcionales y sólo son necesarios cuando las cadenas predeterminadas am/pm son necesarias.