AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Su versión: XXA250083N

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
El contenido de esta página se actualizaó a la versión 26.  Consulte la documentación 26 .
Ayuda / WLanguage / WLanguage functions / Standard functions / Functions for string management
  • Formato detallado del string a obtener
  • Límites
  • Conversión en bytes
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Otros
Procedimientos almacenados
Transforma un valor numérico (entero, real o moneda) en una cadena de caracteres según el formato especificado.
PHP En esta versión, el valor numérico a transformar debe ser un entero o un real.
Ejemplo
NumToString(123) // Returns "123"
NumToString(1.23) // Returns "1.23"
NumToString(12345.5, "+10.2f") // Returns " +12345.50"
NumToString(12345.5, "-+10.2f") // Returns "+12345.50 "
NumToString(12345.5, "+010.2f") // Returns "+012345.50"
NumToString(12345.5, "010.2f") // Returns "0012345.50"

NumToString(12345.5, "10.2fS")
// Returns " 12 345.50" (the thousand separator is " ")

NumToString(12345.5, "10,2fS")
// Returns " 12 345,50" (the decimal separator is ",")
Sintaxis
<Result> = NumToString(<Number> [, <Format>])
<Result>: Character string
Número expresado en formato de cadena de caracteres según el formato seleccionado.
Si <Number> es una cadena, esta cadena se devuelve tal cual es. El formato se ignora.
PHP Si <Number> es una cadena, esta cadena se transforma como si fuera un número.
<Number>: Integer or real
Valor numérico a convertir en una cadena de caracteres (según el formato especificado).
<Format>: Optional character string or constant
  • Formato del string, expresado en el siguiente formato:
    "[<Alignment>][<Sign>][<Zero>][<Size>][<.Precision>]<Type>[<Thousand>]"

    PHP La cadena se expresa en el siguiente formato:
    "[<Zero>][<Alignment>][<Size>][<.Precision>]<Type>"

    Consulte observaciones para obtener más detalles.
  • WINDEVWEBDEV - Código ServidoriPhone/iPadUniversal Windows 10 AppWindows Mobile Constante utilizada para definir un formato de sistema:
    maskSystemCurrencyUtilice la máscara de moneda del sistema.
    maskSystemNumeralUtilice la máscara numérica del sistema.
Observaciones

Formato detallado del string a obtener

Para convertir un valor numérico en una cadena, es necesario especificar el formato de la cadena que se quiere get. Este formato se describe a continuación:
"[<Alignment>][<Sign>][<Zero>][<Size>][<.Precision>]<Type>[<Thousand>]"
PHP El formato se describe a continuación:
"[<Zero>][<Alignment>][<Size>][<.Precision>]<Type>"
Los valores posibles son:
<Alineación>Si se especifica este parámetro, justifica el número a la izquierda (<Alineación> = "-").
El número está justificado a la derecha por Default.
<Signo>Si se especifica este parámetro, fuerza el signo para los números positivos (<Signo> = "+"). Esta señal aparecerá a la izquierda del primer número significativo.
Por defecto, solo los números negativos tienen un signo "-" a la izquierda del primer número significativo..
Caso especial: si se especifica este parámetro y si el número es igual a 0, se mostrará el signo "+".. Lo mismo si un número negativo es igual a 0.
<Zero>Si se especifica este parámetro (<Cero> ="0"), el número se completará con ceros a la izquierda del primer dígito significativo si la parte significativa del número es menor que el tamaño solicitado y si se justifica el número a la derecha..
Por defecto, el número no se completa con ceros "0" a la izquierda..
Por ejemplo: NumToString(123, "05d") devolverá "00123".
<Tamaño>Define la longitud total de la cadena de resultados. La longitud total corresponde a los siguientes elementos: signo, separador de mil, punto decimal, exponente, parte entera y decimal del número. Este tamaño debe ser inferior a 100.
Si el tamaño especificado es demasiado pequeño para contener la parte significativa del número, se ignorará.
Por Default, el número tendrá el tamaño de su parte significativa (no puede ser llenado con ceros). Lo mismo si <Tamaño> = 0.
Si el tamaño especificado es mayor que la parte significativa del número:
  • la cadena de resultados se rellenará con espacios a la derecha si el número está justificado a la izquierda,
  • la cadena de resultados se rellenará con espacios o ceros a la izquierda si el número está justificado a la derecha.
PHP Define la longitud total de la cadena de resultados o la longitud total de la parte entera si el número está lleno de ceros.. La longitud total corresponde a los siguientes elementos: signo, separador de mil, punto decimal, exponente, parte entera y decimal del número.
Si el tamaño especificado es demasiado pequeño para contener la parte significativa del número, se ignorará.
Por Default, el número tendrá el tamaño de su parte significativa (no puede ser llenado con ceros). Lo mismo si <Tamaño> = 0.
Si el tamaño especificado es mayor que la parte significativa del número:
  • la cadena de resultados se rellenará con espacios a la derecha si el número está justificado a la izquierda,
  • la cadena de resultados se rellenará con espacios o ceros a la izquierda si el número está justificado a la derecha.
<.Precisión>Define el separador decimal (caracteres "." o ",") y el número de decimales (solo para los <Tipos> flotante ("f") y exponente ("e")).
El separador decimal :
  • Si el separador decimal es una coma, el separador decimal será el definido.:
    • en los parámetros lingüísticos de Windows.
    • WEBDEV - Código Servidor en la configuración Windows del servidor.
    • iPhone/iPad para el usuario actual.
  • Si el separador decimal es un punto, el separador decimal utilizado será un punto.
Observaciones:
  • ChangeSeparator no tiene ningún efecto sobre este separador. En efecto, esta función actúa sobre la máscara de visualización de los valores numéricos en los controles.
  • WEBDEV - Código Navegador La sintaxis de <,Precision> no puede ser usada: se debe utilizar <.Precisión>.
Número de decimales:
  • El número de decimales debe ser inferior a 100..
  • Si el número de decimales en el número es mayor que <Precisión>, la parte decimal se redondea al número especificado de decimales.
  • Si el número de decimales del número es menor que <Precisión>, la parte decimal se completará con ceros "0" a la derecha.
  • El valor de <Precisión> puede ser mayor que <Tamaño>. En este caso, <Size> es ignorado.
PHP Define el número de decimales (solo para los <Tipos> flotante ("f") y exponente ("e").
  • Si el número de decimales en el número es mayor que <Precisión>, la parte decimal se redondea al número especificado de decimales.
  • Si el número de decimales del número es menor que <Precisión>, la parte decimal se completará con ceros "0" a la derecha.
  • El valor de <Precisión> puede ser mayor que <Tamaño>. En este caso, <Tamaño> si se ignora si el número está lleno de caracteres de espacio.
<Tipo>Tipo de resultado, parámetro obligatorio:
  • d: Integer:
    Un número real se redondeará al entero más cercano.
  • e: Notación exponencial :
    Si no se indica <precisión>, 6 dígitos por Default.
  • f: Notación decimal:
    Si no se indica <precisión>, 6 dígitos por Default.
  • x y X: Notación hexadecimal (X para letras mayúsculas):
    Sólo se tiene en cuenta la parte entera del número (no se redondea)..
    Caso particular:
    1. Tamaño no especificado y número negativo: 20 caracteres hexadecimales para una moneda, 8 caracteres para todos los demás tipos numéricos.
    2. Número negativo: el tamaño de la cadena de resultados será al menos el tamaño que permita especificar el bit de signo.
    Por ejemplo: -32767 en el formato "3X" devolverá "8001"
  • o: Notación ocular :
    Sólo se tiene en cuenta la parte entera del número (no se redondea)..
    Caso particular:
    1. Tamaño no especificado y número negativo: 27 caracteres hexadecimales para una moneda, 11 caracteres para todos los demás tipos numéricos.
    2. Número negativo: el tamaño de la cadena de resultados será al menos el tamaño que permita especificar el bit de signo.
    Por ejemplo: -32767 en un formato "3o" devolverá "700001"
<Mil>Separador de miles (<Thousand> = "S" o "s"). Los dígitos que se encuentran en la parte entera del número estarán agrupados por 3 y separados por el separador de miles definido en Windows.. Si el signo está presente, siempre se mostrará inmediatamente a la izquierda del primer dígito significativo.. No se puede encontrar un separador de miles entre el signo y el primer dígito..
WEBDEV - Código Navegador El separador de miles siempre es un espacio (' ').
WINDEVWEBDEV - Código ServidorWEBDEV - Código NavegadorReportes y ConsultasiPhone/iPadUniversal Windows 10 AppWindows MobileAjaxCódigo de Usuario (UMC)

Límites

  • El formato "f" devuelve un resultado válido para números entre -1e+17 y 1e+17.
  • Formatos "x", "d" u "o": la parte entera no debe exceder de 99 999 999 999 999 999 999 999 999.
  • WEBDEV - Código Servidor ¿Cómo utilizar una coma para el separador de decimales?
    Si la configuración de Windows en el servidor no utiliza una coma como separador de decimales, tiene la capacidad de:
    • usar un control Campo de entrada numérico (oculto si es necesario). El valor visualizado puede ser recuperado por ..DisplayedValue.
    • usar un formato de pantalla control.

Conversión en bytes

Para convertir un tamaño en bytes, utilice LengthToString.
Componente : wd250std.dll
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Como mostrar pontos e virgula
cyTotal_aberto is currency=10600385.15
STC_TOTAL+=" Aberto:"+NumToString(cyTotal_aberto,"10,2fS") // "10,2f"
//RESULTADO SERA: 10.600.385,15
amarildo
16 03 2020

Última modificación: 03/05/2020

Señalar un error o enviar una sugerencia | Ayuda local