CStr

Sintaxis básica y Crystal.

CStr y ToText son funciones equivalentes.

Sobrecargas
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:

Convirtiendo números fraccionarios y valores monetarios:

Convirtiendo valores de fecha, hora, y fecha/hora:

Argumentos opcionales de paso:



Seagate Software, Inc.
http://www.seagatesoftware.com
Envíe sus comentarios a:
techpubs@seagatesoftware.com