Setelan Lokal Indonesia Dengan Apps Script

Merias tampilan dalam format lokal Indonesia dapat dilakukan dengan pengaturan langsung di aplikasi atau melalui Apps Script. Masing-masing punya keunggulan dan konsekuensi.

SETELAN APLIKASI VS APPS SCRIPT

Bila anda memilih mengatur tampilan langsung di setelan aplikasi:

• Akan menghemat beban kerja script yang berarti proses akan lebih cepat
• Namun efeknya terbatas pada aplikasi tersebut bahkan bisa jadi berbeda antar file-nya

Bila anda memilih mengatur tampilan dengan scripting Apps Script:

• Efeknya bisa lintas aplikasi
• Namun menambah beban kerja script yang berarti bisa mengurangi kecepatan prosesnya

Volume kerja merias format tampilan tidaklah setiap waktu dan biasanya hanya di awal saja sehingga bila dimungkinkan disarankan untuk mengatur langsung di setelan aplikasiSiLiKiDi

SETELAN INDONESIA DI GOOGLE SHEETS

Google Sheets sering menjadi sorotan dalam kasus merias format tanggal atau angka. Mengatur setelan format Indonesia sangatlah mudah di Sheets:

LOKALISASI DI SPREADSHEET

Setelan ini berlaku di satu file sheets untuk semua tab sheet di dalamnya dan tidak berlaku untuk berbeda file sheets, anda harus mengatur ulang untuk file sheets baru.

Pilih menu File - Spreadsheet settings

Pada tab General pilih Locale: Indonesia dan Time zone: (GMT+07:00) Jakarta

LOKALISASI DI SEL

Setelan ini lebih spesifik menjangkau sel atau range sel. Sebelumnya blok range sel atau sorot sel tertentu, lalu pilih menu Format - Number - More Formats - More date and time formats

Di sini anda bisa lebih banyak berimprovisasi dengan format tanggal termasuk susunannya dan tanda pemisahnya. Lakukan hal yang sama dengan memformat angka atau mata uang.

Hingga artikel ini ditulis, setelan Timezone untuk Apps Script hanya tersedia di Legacy Editor sehingga anda perlu beralih sementara ke editor lamaSiLiKiDi

SETELAN TIMEZONE APPS SCRIPT

Pada tampilan editor baru, klik tombol Use legacy editor

Setelah tampilan Legacy Editor terbuka, pilih menu File - Project properties

Pada tab Info - Time zone, pilih (GMT+07:00) Jakarta dan klik Save

Untuk kembali ke editor baru, klik tombol Use new editor

Apps Script menyediakan scripting independen lintas aplikasi dengan Class Utilities dan Services API untuk mengakses aplikasi GoogleSiLiKiDi

SCRIPTING PEMFORMATAN

Session.getScriptTimeZone()

getScriptTimeZone() adalah metode yang disediakan Class Session untuk mengambil setelan Timezone di Project Settings.

Utilities.formatDate()

formatDate( date, timeZone, format ) adalah metode yang disediakan Class Utilities untuk mengatur tampilan tanggal dengan tiga parameter:

1. date : Objek nilai tanggal yang akan diformat
2. timeZone : string kode Timezone yang menjadi acuan dalam memformat parameter date. Anda bisa menuliskan langsung dengan "Asia/Jakarta" atau gunakan Session.getScriptTimeZone()
3. format : string untuk format tampilan date dapat anda lihat contohnya di Date and Number Formats

Google Services API

Google Services API memungkinkan anda untuk scripting mengakses aplikasi-aplikasi Google. Salah satunya metode getDisplayValues() yang disediakan Google Sheets API untuk mengambil nilai dari sel atau range sel dengan format sesuai yang ditampilkan di Sheets.

Dengan melakukan setelan format di aplikasi, anda tidak perlu lagi meracik dengan rumit di tatanan script. Cukup dengan memanggil getDisplayValues() untuk mengambil nilai dengan format tampilan tersebut.

data = SpreadsheetApp.getActiveSpreadsheet().getRange(1, 1).getDisplayValues();

Setiap aplikasi punya scripting services API berbeda-beda yang dapat anda telusuri di referensi Apps ScriptSiLiKiDi

Dapatkan skrip semua materi di repository

Dukung donasi agar tutorial ini tetap operasional:
SiLiKiDi