Đổi số thành chữ trong Google Sheets

Tên hàm chưa hợp lệ nên chưa tạo mã. Sửa tên ở mục “Đổi tên hàm” hoặc dùng tên mặc định.

/**
 * Generated by sothanhchu.com - Vietnamese number to words (Google Apps Script)
 * Function: DOCSO(value) - whole numbers only
 * Config: number; nghin / linh / mot / bon / lam / ty; case: sentence
 * Pure JavaScript: no network calls, no Google services, no spreadsheet reads.
 * Input: a single cell or a range. A number below 1E+15, or text made only of digits.
 * Blank cells stay blank. In a range, a bad cell shows "#LỖI: ..."; for one cell the function throws an error message.
 */
var STC_MONEY_ = false;
var STC_OMIT_ZERO_HUNDRED_ = false;
var STC_CASE_ = 'sentence'; // sentence | lower | upper
var STC_MAX_DIGITS_ = 36;
var STC_LIMIT_ = 1e15; // cell numbers at or above this are refused (use text)
var STC_WORDS_ = {
  digits: ['không', 'một', 'hai', 'ba', 'bốn', 'năm', 'sáu', 'bảy', 'tám', 'chín'],
  hundred: 'trăm', ten: 'mười', tens: 'mươi',
  thousand: 'nghìn', million: 'triệu', billion: 'tỷ',
  zeroTens: 'linh', one: 'mốt', four: 'bốn', five: 'lăm',
  neg: 'âm', unit: '', whole: ''
};

/**
 * Đọc số nguyên thành chữ tiếng Việt. Nhận một ô hoặc cả vùng ô.
 *
 * @param {number|string|Array<Array<number|string>>} value Một ô hoặc một vùng ô, ví dụ A1 hoặc A1:A100.
 * @return {string|Array<Array<string>>} Chữ đọc; với vùng ô thì trả về mảng cùng số dòng, số cột.
 * @customfunction
 */
function DOCSO(value) {
  return stcRun_(value);
}

function stcRun_(value) {
  if (Array.isArray(value)) {
    // A range arrives as a two-dimensional array. Convert in memory, keep the same rows and columns.
    return value.map(function (row) {
      return Array.isArray(row) ? row.map(stcCell_) : [stcCell_(row)];
    });
  }
  var r = stcConvert_(value);
  if (!r.ok) throw new Error(r.message);
  return r.text;
}

// One cell of a range: a bad cell becomes a short visible text, so the rest of the range still converts.
function stcCell_(value) {
  var r = stcConvert_(value);
  return r.ok ? r.text : '#LỖI: ' + r.short;
}

function stcFail_(short, message) {
  return { ok: false, short: short, message: message };
}

// Accepts a whole number: a numeric cell below 1E+15, or text made only of digits (optional leading minus).
function stcConvert_(value) {
  var neg = false;
  var digits;
  if (value === '' || value === null || value === undefined) return { ok: true, text: '' };
  if (typeof value === 'number') {
    if (!isFinite(value)) return stcFail_('không phải số', 'Giá trị không phải một số hữu hạn.');
    if (Math.abs(value) >= STC_LIMIT_) return stcFail_('số quá lớn', 'Ô số từ 1E+15 trở lên không giữ đủ chữ số. Hãy nhập số dưới dạng văn bản (định dạng ô là Text).');
    if (value !== Math.floor(value)) return stcFail_('số thập phân', 'Hàm chỉ đọc số nguyên; ô này có phần thập phân.');
    neg = value < 0;
    digits = String(Math.abs(value));
  } else if (typeof value === 'string') {
    var s = value.trim();
    if (s === '') return { ok: true, text: '' };
    if (s.charAt(0) === '-') {
      neg = true;
      s = s.slice(1);
    }
    if (!/^[0-9]+$/.test(s)) return stcFail_('không phải số nguyên', 'Chỉ nhận số nguyên hoặc văn bản gồm toàn chữ số (có thể có dấu trừ ở đầu).');
    digits = s;
  } else if (typeof value === 'boolean') {
    return stcFail_('đúng/sai', 'Ô chứa giá trị đúng/sai, không phải số.');
  } else {
    return stcFail_('không phải số', 'Ô chứa ngày, giờ hoặc giá trị khác, không phải số nguyên.');
  }
  digits = digits.replace(/^0+/, '');
  if (digits.length > STC_MAX_DIGITS_) return stcFail_('quá dài', 'Chỉ đọc tối đa ' + STC_MAX_DIGITS_ + ' chữ số.');
  if (digits === '') neg = false;
  var w = STC_WORDS_;
  var text = stcWords_(digits);
  if (neg) text = w.neg + ' ' + text;
  if (STC_MONEY_) {
    text += ' ' + w.unit;
    if (w.whole) text += ' ' + w.whole;
  }
  if (STC_CASE_ === 'upper') text = text.toUpperCase();
  else if (STC_CASE_ === 'sentence') text = text.charAt(0).toUpperCase() + text.slice(1);
  return { ok: true, text: text };
}

// Whole number (digits only) -> words. Groups of three digits; from 10^9 on the number is read in
// nine-digit chunks, each followed by the billion word once per chunk level (nghìn tỷ, triệu tỷ, tỷ tỷ ...).
function stcWords_(digits) {
  var w = STC_WORDS_;
  if (digits === '') return w.digits[0];
  var padded = digits;
  while (padded.length % 3 !== 0) padded = '0' + padded;
  var count = padded.length / 3;
  var vals = [];
  var top = -1;
  for (var i = 0; i < count; i++) {
    vals.push(parseInt(padded.substr(i * 3, 3), 10));
    if (top < 0 && vals[i] > 0) top = i;
  }
  var out = [];
  for (var j = 0; j < count; j++) {
    if (vals[j] === 0) continue;
    var g = count - 1 - j;
    var pos = g % 3;
    var chunk = Math.floor(g / 3);
    var piece = [stcGroup_(vals[j], j === top)];
    if (pos === 1) piece.push(w.thousand);
    if (pos === 2) piece.push(w.million);
    if (chunk > 0) {
      var lowest = true;
      for (var lower = chunk * 3; lower < g; lower++) {
        if (vals[count - 1 - lower] > 0) lowest = false;
      }
      if (lowest) {
        for (var k = 0; k < chunk; k++) piece.push(w.billion);
      }
    }
    out.push(piece.join(' '));
  }
  return out.join(' ');
}

// One group of three digits (1..999). isTop = the most significant non-zero group (no leading "không trăm").
function stcGroup_(v, isTop) {
  var w = STC_WORDS_;
  var h = Math.floor(v / 100);
  var t = Math.floor(v / 10) % 10;
  var u = v % 10;
  var s = [];
  if (h > 0) {
    s.push(w.digits[h], w.hundred);
  } else if (!isTop && !STC_OMIT_ZERO_HUNDRED_) {
    s.push(w.digits[0], w.hundred);
  }
  var zeroTensCtx = t === 0 && u > 0 && (h > 0 || !isTop);
  if (t === 0) {
    if (zeroTensCtx) s.push(w.zeroTens);
  } else if (t === 1) {
    s.push(w.ten);
  } else {
    s.push(w.digits[t], w.tens);
  }
  if (u > 0) {
    if (u === 1 && t >= 2) s.push(w.one);
    else if (u === 4 && (t >= 2 || zeroTensCtx)) s.push(w.four);
    else if (u === 5 && t >= 1) s.push(w.five);
    else s.push(w.digits[u]);
  }
  return s.join(' ');
}

Chưa chạy thử trong Google Apps Script thật. Mã mới chỉ được chạy cục bộ bằng Node.js. Sau khi dán, đối chiếu bảng “Kiểm tra sau khi cài” bên dưới. Ô số chỉ nhận số nguyên dưới 1E+15; số dài nhập dưới dạng văn bản.

Mã chỉ là JavaScript thuần: không gọi mạng, không gọi dịch vụ nào của Google. Đọc qua trước khi dán: cách tự kiểm tra.