ToText

Sintaxis básica y Crystal.

ToText y CStr son funciones equivalentes.

Sobrecargas
Argumentos

Convirtiendo . . . Descripción

Valor Booleano

  • 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 Numérico o de Moneda que será convertido en una cadena de texto; puede ser un valor entero o sólo una fracción.
  • 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 numérico o de moneda que será convertido en una cadena de texto; puede ser un valor entero o sólo una fracción.
  • 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 obtener más información sobre cómo crear una cadena de 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

  • x es un valor Fecha a ser convertido en una cadena 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 obtener más información sobre cómo crear esta cadena de formato. (Este argumento es opcional.)

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 obtener más información sobre cómo crear esta cadena de formato. (Este argumento es opcional.)
  • z es una cadena de texto para 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 obtener más información sobre cómo crear una cadena de formato. (Este argumento es opcional.)
  • z es una cadena de texto para 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 ToText 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:

ToText({pedidos.ENVIADOS})

Devuelve Verdadero cuando el valor en ({pedidos.ENVIADOS}) es Verdadero.

ToText(123.45)

Devuelve "123.45".

ToText(12345.6749,2)

Devuelve "12345.67".

ToText(12345.6750,2)

Devuelve "12345.68".

ToText(12345.4999,0)

Devuelve "12345".

ToText(12345.5000,0)

Devuelve "12346".

ToText({archivo.AMT} * {archivo.CANTIDAD})

Devuelve 44,890.20 cuando Amt = 24.45 y Cantidad = 1836.

ToText 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.NUMERO DE ELEMENTO} + " es $" + ToText({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.

Los siguientes ejemplos son aplicables para la sintaxis Crystal:

ToText(CDate(1,11,1996), "ddd, dd MMM aa")

Devuelve Lunes, 01 Nov 96.

ToText(DateTime(1995,10,12,3,30,11),"HH:mm,ddd MMMM aa")

Devuelve 03:30, Lun. Octubre 95.

ToText(Time(12, 10, 10), "HH*mm*ss tt", "amStr", "pmStr")

Devuelve 12*10*10 pmStr.



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