numeroaletras

package module
v0.1.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 23, 2025 License: MIT Imports: 4 Imported by: 1

README

NumeroALetras para Go

NumeroALetras es una biblioteca escrita en Go que convierte valores numéricos a su representación literal en español. Es útil para facturación, reportes financieros, documentos legales y cualquier sistema donde se requiera expresar montos en texto.

Este proyecto está basado en la biblioteca php-numero-a-letras desarrollada por @luecano y licenciada bajo MIT License.


✨ Características

  • Conversión de números enteros y decimales a palabras en español.
  • Representación de montos con moneda y centavos.
  • Formato especial para facturación electrónica SUNAT (45.50 → CUARENTA Y CINCO 50/100 SOLES).
  • Apócope opcional de “UNO” a “UN”.
  • Corrección de acentos en casos especiales (VEINTIDÓS, VEINTITRÉS, VEINTISÉIS).
  • Personalización del conector (por defecto: "CON").

📦 Instalación

go get github.com/user0608/numeroaletras

🧪 Ejemplos de uso

Convertir número a palabras
n := numeroaletras.NewNumeroALetras()
res, _ := n.ToWords(1100, 0)
fmt.Println(res)
// Salida: "MIL CIEN"
Activar apócope
n := numeroaletras.NewNumeroALetras()
n.UseApocope(true)
res, _ := n.ToWords(101, 0)
fmt.Println(res + " AÑOS")
// Salida: "CIENTO UN AÑOS"
Representación monetaria
n := numeroaletras.NewNumeroALetras()
res, _ := n.ToMoney(2500.90, 2, "DÓLARES", "CENTAVOS")
fmt.Println(res)
// Salida: "DOS MIL QUINIENTOS DÓLARES CON NOVENTA CENTAVOS"
Representación con conector personalizado
n := numeroaletras.NewNumeroALetras()
n.Conector = "Y"
res, _ := n.ToMoney(11.10, 2, "pesos", "centavos")
fmt.Println(res)
// Salida: "ONCE PESOS Y DIEZ CENTAVOS"
Formato SUNAT (factura)
n := numeroaletras.NewNumeroALetras()
res, _ := n.ToInvoice(1700.50, 2, "soles")
fmt.Println(res)
// Salida: "MIL SETECIENTOS CON 50/100 SOLES"
Formato libre
n := numeroaletras.NewNumeroALetras()
res, _ := n.ToString(5.2, 1, "años", "meses")
fmt.Println(res)
// Salida: "CINCO AÑOS CON DOS MESES"

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type NumeroALetras

type NumeroALetras struct {
	Conector string
	// contains filtered or unexported fields
}

func NewNumeroALetras

func NewNumeroALetras() *NumeroALetras

func (*NumeroALetras) ToInvoice

func (n *NumeroALetras) ToInvoice(number float64, decimals int, currency string) (string, error)

func (*NumeroALetras) ToMoney

func (n *NumeroALetras) ToMoney(number float64, decimals int, currency, cents string) (string, error)

func (*NumeroALetras) ToString

func (n *NumeroALetras) ToString(number float64, decimals int, wholeStr, decimalStr string) (string, error)

func (*NumeroALetras) ToWords

func (n *NumeroALetras) ToWords(number float64, decimals int) (string, error)

func (*NumeroALetras) UseApocope

func (n *NumeroALetras) UseApocope(value bool)

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL