Google Sheet 上で数字を文字列に

2020年10月5日 20:00

Google Sheet 上で大きな数字、たとえば「1234567890」を "one billion two hundred thirty-four million five hundred sixty-seven thousand eight hundred and ninety" といった文字列に変換したいと思ったことはないでしょうか？

... まあ普通はありませんよね。英語のスピーチ原稿を書いていたり、英訳をしているとき以外は普通の日本人の人には縁のないことかもしれません。

それでもこの note を書いた理由は、たまたま数字を文字列に変換する Javascript のライブラリを発見したので、Javascript のライブラリを Googe Sheet の中に組み込む例題として使ってみようと思ったからです。これができれば、プログラマでなくても、ちょっとした便利な機能を自分の Google Sheet に組み込むことができるようになるかも。

とりあえずできそうなことを気軽にやってみましょう。

js written number ライブラリ

見つけたのは js written number というプロジェクトです。github上でここに置かれています。

ラストネームが Yamada さんなのですが、日系人の方なのでしょうか。

ともあれここの説明書（README）を読むと以下のような用例が書かれています。

var writtenNumber = require('written-number');
writtenNumber(1234); // => 'one thousand two hundred and thirty-four'

writtenNumber.defaults.lang = 'es';
writtenNumber(4758); // => 'cuatro mil setecientos cincuenta y ocho'

writtenNumber(1234, {lang: 'fr'});   // => 'mille deux cent trente-quatre'
writtenNumber(1234, {lang: 'es'});   // => 'mil doscientos treinta y cuatro'
writtenNumber(1234, {lang: 'az'});   // => 'min iki yüz otuz dörd'
writtenNumber(1234, {lang: 'pt'});   // => 'mil duzentos e trinta e quatro'
writtenNumber(1234, {lang: 'ar'});   // => 'ألف ومائتان وأربعة وثلاثون'
writtenNumber(1234, {lang: 'eo'});   // => 'mil ducent tridek kvar'
writtenNumber(1234, {lang: 'vi'});   // => 'một ngàn hai trăm và ba mươi bốn'
writtenNumber(1234, {lang: 'uk'});   // => 'одна тисяча двісті тридцять чотири'
writtenNumber(1234, {lang: 'id'});   // => 'seribu dua ratus tiga puluh empat'

一行目の var writtenNumber = require('written-number'); の部分で、まず 'written-number' というライブラリを読み込んで writtenNumber という関数を使えるようにしています。

二行目の writtenNumber(1234); // => 'one thousand two hundred and thirty-four' という部分は // 以降がコメントで、writtenNumber(1234); という呼び出しを行うと 'one thousand two hundred and thirty-four' という文字列が返ってくると説明されているようです。

この writeNumber という関数を呼び出せるようにしてやれば良さそうです。

面白いのが、英語だけではなく様々な言語への変換も組み込まれていることですね。フランス語やロシア語ベトナム語などもあります。まあすべての言語が本当に正しいのかはわかりませんが、一応それぞれの言語はそれぞれの言語のネイティブエンジニアが寄付しているようです。これがオープンソースの良いところですね。

残念ながら日本語は組み込まれていません（いつか日本語の組込みをテーマとしてとりあげるかもしれません）。

さてこの writtenNumber を Google Sheet の中で使えるようにしたいのですが ...

Google Sheet への js written number の組込み

ここでは「【実験】数字→テキスト」という名前のGoogle Sheet （以下 GS）を作って実験します。さて GS の最上部には「ツール」というメニューがあります。

この「ツール」メニューの中の「スクリプトエディタ」という項目を選びます。

さてスクリプトエディタが開いたら、以下のようになっているはずです。

プロジェクトに名前をつけます。ここでは安直に number2text という名前をつけました。左上の名前の部分（number2text）をクリックすると編集できます。

右側の function myFunction() ... と書いてある場所が、スクリプト（プログラム）を書き込む場所です。ここでは「コード.gs」の中身を完全に以下のコードで置き変えます。

// Currently supported languages are:
// English	en
// Portuguese (Brazil)	pt
// Portuguese (Portugal)	ptPT
// Spanish	es
// French	fr
// Esperanto	eo
// Vietnamese	vi
// Arabic	ar
// Azerbaijan	az
// Turkish	tr
// English (Indian)	enIndian
// Ukrainian	uk
// Indonesian	id
// Russian	ru
function NUMBER2TEXT(num, lang = "en", noAnd = false) {
 var result = writtenNumber(num, {lang: lang, noAnd: noAnd});
 return result;
}

ここで何をしているかというと、writtenNumber という関数を呼び出すための NUMBER2TEXT という関数を定義しています。

この NUMBER2TEXT を GS からは呼び出すつもりです。つまりGSのセルで "=NUMBER2TEXT(1234)" といった使い方ができるようにしたいわけです。

NUMBER2TEXT には３つの引数があって、一番目は数字を渡す num、二番目は言語を指定する lang（ディフォルトは "en" 英語）、そして三番目は出力から "and" を省略するかどうかのフラグです（ディフォルトは false なので and は出力されます）。

この3つの引数を、writtenNumber に渡して返ってきた答（result）をさらに返しています。

では肝心の writtenNumber の中身はどうするのかと言えば ... 以下の部分から抜き出します（これは GitHub 上のソースコードをテキスト形式で抜き出すための URL です）。

README の用例では require でライブラリを読み込んでいるのですが、ここではライブラリの中身を直接 Code.gs の最後の部分にコピーしてしまいます（長過ぎるので全部はお見せしません）。こんな感じになっているはずです（なお、うまく編集できなかった人のために、記事の最後に「コード.gs」の中身をファイルとしてアップロードしてあります）。