n2words/dist/pt-BR.js

Convert numbers to words in 70+ languages with zero dependencies. Supports BigInt, decimals, and browser/Node.js environments.

/*! n2words/pt-BR v5.1.2 | MIT License | github.com/forzagreen/n2words */
function e(e){let[n,t]=e.toLowerCase().split("e");const r=parseInt(t,10);let i="";"-"===n[0]&&(i="-",n=n.slice(1));const o=n.indexOf("."),s=-1===o?n:n.slice(0,o)+n.slice(o+1),u=(-1===o?n.length:o)+r;return u>=s.length?i+s+"0".repeat(u-s.length):u<=0?i+"0."+"0".repeat(-u)+s:i+s.slice(0,u)+"."+s.slice(u)}function n(n){const r=n.toString();return t(r)?e(r):r}function t(e){return e.includes("e")||e.includes("E")}function r(e){const n="-"===e[0];n&&(e=e.slice(1));const t=e.indexOf(".");if(-1===t)return{isNegative:n,integerPart:BigInt(e)};const r=e.slice(0,t)||"0",i=e.slice(t+1);return{isNegative:n,integerPart:BigInt(r),decimalPart:i}}function i(n){let r=n.trim();if(0===r.length||Number.isNaN(Number(r)))throw new RangeError(`Invalid currency format: "${n}"`);t(r)&&(r=e(r));const i="-"===r[0];i&&(r=r.slice(1));const o=r.indexOf(".");if(-1===o)return{isNegative:i,dollars:BigInt(r),cents:0n};const s=r.slice(0,o)||"0",u=(r.slice(o+1)+"00").slice(0,2);return{isNegative:i,dollars:BigInt(s),cents:BigInt(u)}}function o(e,n,t){if(null===n)return;if(e<n&&!(t&&BigInt(t)>=n))return;const r=n.toString().length-1,i=n===10n**BigInt(r)?`10^${r} - 1`:""+(n-1n);throw new RangeError(`Number too large to convert: the largest supported value is ${i}`)}function s(e){return 10n**BigInt(3*(e+1))}const u=["","um","dois","três","quatro","cinco","seis","sete","oito","nove"],c=["dez","onze","doze","treze","quatorze","quinze","dezesseis","dezessete","dezoito","dezenove"],a=["","","vinte","trinta","quarenta","cinquenta","sessenta","setenta","oitenta","noventa"],l=["","cento","duzentos","trezentos","quatrocentos","quinhentos","seiscentos","setecentos","oitocentos","novecentos"],f="mil",m="zero",g="menos",d=["","primeiro","segundo","terceiro","quarto","quinto","sexto","sétimo","oitavo","nono"],h=["décimo","décimo primeiro","décimo segundo","décimo terceiro","décimo quarto","décimo quinto","décimo sexto","décimo sétimo","décimo oitavo","décimo nono"],p=["","","vigésimo","trigésimo","quadragésimo","quinquagésimo","sexagésimo","septuagésimo","octogésimo","nonagésimo"],b=["","centésimo","ducentésimo","tricentésimo","quadringentésimo","quingentésimo","sexcentésimo","septingentésimo","octingentésimo","nongentésimo"],w={BRL:{major:["real","reais"],minor:["centavo","centavos"]},USD:{major:["dólar","dólares"],minor:["centavo","centavos"]},EUR:{major:["euro","euros"],minor:["centavo","centavos"]},GBP:{major:["libra","libras"],minor:["pêni","pence"]},JPY:{major:["iene","ienes"],minor:["sen","sen"]}},v={minor:["centavo","centavos"]};function N(e){if(0===e)return{word:"",isExactHundred:!1};if(100===e)return{word:"cem",isExactHundred:!0};const n=e%10,t=Math.trunc(e/10)%10,r=Math.trunc(e/100),i=[];return r>0&&i.push(l[r]),1===t?i.push(c[n]):t>=2?i.push(n>0?a[t]+" e "+u[n]:a[t]):n>0&&i.push(u[n]),{word:i.join(" e "),isExactHundred:r>0&&0===t&&0===n,startsWithHundreds:e>=100}}const y=["",f,"milhão","bilhão","trilhão","quatrilhão","quintilhão","sextilhão","setilhão"],E=["",f,"milhões","bilhões","trilhões","quatrilhões","quintilhões","sextilhões","setilhões"],I=["","milésimo","milionésimo","bilionésimo","trilionésimo","quatrilionésimo","quintilionésimo","sextilionésimo"],q=s(y.length-1),x=s(I.length-1),O=s(y.length-1);function R(e){if(0n===e)return m;if(e<1000n)return N(Number(e)).word;if(e<1000000n){const n=Number(e/1000n),t=Number(e%1000n);let r;if(r=1===n?f:N(n).word+" "+f,t>0){const e=N(t);r+=!e.startsWithHundreds||e.isExactHundred?" e "+e.word:" "+e.word}return r}return function(e){const n=[];let t=e;for(;t>0n;)n.push(Number(t%1000n)),t/=1000n;let r=0;for(let e=0;e<n.length;e++)if(0!==n[e]){r=e;break}let i="",o=!1;for(let e=n.length-1;e>=0;e--){const t=n[e];if(0===t)continue;const s=N(t);if(i&&e===r&&o&&(!s.startsWithHundreds||s.isExactHundred)&&(i+=" e"),i&&(i+=" "),0===e)i+=s.word,o=!1;else if(1===e)i+=1===t?f:s.word+" "+f,o=!0;else{const n=1===t?y[e]:E[e];i+=1===t?"um "+n:s.word+" "+n,o=!0}}return i}(e)}function B(i){const{isNegative:s,integerPart:u,decimalPart:c}=function(i){const o=typeof i;if("bigint"==typeof i)return i<0n?{isNegative:!0,integerPart:-i}:{isNegative:!1,integerPart:i};if("number"==typeof i){if(!Number.isFinite(i))throw new RangeError("Number must be finite (NaN and Infinity are not supported)");return Number.isSafeInteger(i)?i<0?{isNegative:!0,integerPart:BigInt(-i)}:{isNegative:!1,integerPart:BigInt(i)}:r(n(i))}if("string"==typeof i)return r(function(n){const r=n.trim();if(0===r.length||Number.isNaN(Number(r)))throw new RangeError(`Invalid number format: "${n}"`);return t(r)?e(r):r}(i));throw new TypeError(`Invalid value type: expected number, string, or bigint, received ${o}`)}(i);o(u,q,c);let a="";return s&&(a=g+" "),a+=R(u),c&&(a+=" vírgula "+function(e){let n="",t=0;for(;t<e.length&&"0"===e[t];)n&&(n+=" "),n+=m,t++;const r=e.slice(t);return r&&(n&&(n+=" "),n+=R(BigInt(r))),n}(c)),a}function j(e){if(0===e)return"";const n=e%10,t=Math.trunc(e/10)%10,r=Math.trunc(e/100),i=[];return r>0&&i.push(b[r]),1===t?i.push(h[n]):t>=2?(i.push(p[t]),n>0&&i.push(d[n])):n>0&&i.push(d[n]),i.join(" ")}function z(n){const r=function(n){const r=typeof n;if("bigint"==typeof n){if(n<=0n)throw new RangeError("Ordinals must be positive integers");return n}if("number"==typeof n){if(!Number.isFinite(n))throw new RangeError("Ordinals must be finite numbers");if(!Number.isInteger(n))throw new RangeError("Ordinals must be whole numbers");if(n<=0)throw new RangeError("Ordinals must be positive integers");return BigInt(n)}if("string"==typeof n)return function(n){const r=n.trim();if(0===r.length)throw new RangeError("Ordinals cannot be empty strings");if("-"===r[0])throw new RangeError("Ordinals cannot be negative");if(r.includes("."))throw new RangeError("Ordinals must be whole numbers");if(t(r)){const n=e(r);if(n.includes("."))throw new RangeError("Ordinals must be whole numbers");const t=BigInt(n);if(t<=0n)throw new RangeError("Ordinals must be positive integers");return t}try{const e=BigInt(r);if(e<=0n)throw new RangeError("Ordinals must be positive integers");return e}catch(e){if(e instanceof RangeError)throw e;throw new RangeError(`Invalid ordinal format: "${n}"`,{cause:e})}}(n);throw new TypeError(`Invalid value type: expected number, string, or bigint, received ${r}`)}(n);if(o(r,x),r<10n)return d[Number(r)];if(r<20n)return h[Number(r)-10];if(r<100n){const e=Number(r%10n),n=Number(r/10n);return 0===e?p[n]:p[n]+" "+d[e]}return r<1000n?j(Number(r)):function(e){const n=[];let t=e;for(;t>0n;)n.push(Number(t%1000n)),t/=1000n;let r=0;for(let e=0;e<n.length;e++)if(0!==n[e]){r=e;break}let i="";for(let e=n.length-1;e>=0;e--){const t=n[e];if(0!==t)if(i&&(i+=" "),e===r)i+=0===e?j(t):1===t&&e>0?I[e]:j(t)+" "+I[e];else if(0===e)i+=N(t).word;else if(1===e)i+=1===t?f:N(t).word+" "+f;else{const n=1===t?y[e]:E[e];i+=1===t?"um "+n:N(t).word+" "+n}}return i}(r)}const $={and:!0,currency:""};function P(e,t){const{isNegative:r,dollars:s,cents:u}=function(e){const t=typeof e;if("bigint"==typeof e)return e<0n?{isNegative:!0,dollars:-e,cents:0n}:{isNegative:!1,dollars:e,cents:0n};if("number"==typeof e){if(!Number.isFinite(e))throw new RangeError("Currency must be a finite number");return Number.isSafeInteger(e)?e<0?{isNegative:!0,dollars:BigInt(-e),cents:0n}:{isNegative:!1,dollars:BigInt(e),cents:0n}:i(n(e))}if("string"==typeof e)return i(e);throw new TypeError(`Invalid value type: expected number, string, or bigint, received ${t}`)}(e);o(s,O);const{and:c,currency:a}=function(e,n){const t={...n};if(void 0===e)return t;if(!function(e){if(null===e||"object"!=typeof e)return!1;const n=Object.getPrototypeOf(e);return null===n||n===Object.prototype}(e))throw new TypeError("Invalid options: expected plain object or undefined, got "+typeof e);const r=Object.keys(n);for(const[i,o]of Object.entries(e)){if(!Object.hasOwn(n,i))throw new TypeError(`Unknown option "${i}" — expected one of: ${r.join(", ")}`);if(void 0!==o){if(typeof o!=typeof t[i])throw new TypeError(`Option "${i}" must be a ${typeof t[i]}, got ${typeof o}`);t[i]=o}}return t}(t,$);let l=a;if(!l){try{const e=new Intl.Locale("pt-BR");l=e.getCurrencies?.()[0]}catch{}l=l||"BRL"}l=l.toUpperCase();const f=w[l]||{major:[l,l],minor:v.minor};let d="";r&&(d=g+" ");const h=s>0n,p=u>0n;if(!h&&!p)return m+" "+f.major[1];if(h&&(d+=R(s)+" "+(1n===s?f.major[0]:f.major[1])),p){h&&(d+=c?" e ":" ");const e=R(u),n=1n===u?f.minor[0]:f.minor[1];d+=""===n?e:e+" "+n}return d}export{q as cardinalMax,$ as currencyDefaults,O as currencyMax,x as ordinalMax,B as toCardinal,P as toCurrency,z as toOrdinal};